📖 Project Handover & System Status Guide

(For subsequent AI agents and developers)

🚀 ১. বর্তমান অবস্থা ও অর্জিত লক্ষ্যসমূহ (Current Achievements)

লাইভ প্রোজেক্ট লিঙ্ক: https://storealco.pythonanywhere.com/Dashboard/
ব্যাকএন্ড সার্ভিস রানিং: https://storealco.pythonanywhere.com/ (ASGI FastAPI hosted via WSGI a2wsgi adapter)
ডাটাবেজ আর্কিটেকচার: SQLite (sales.db) রুট পাথে হোস্ট করা আছে।
অটো-ডিপ্লয়মেন্ট স্ক্রিপ্ট: deploy.py ফাইলটি ড্যাশবোর্ড স্ট্যাটিক অ্যাসেট (Dashboard/ ফোল্ডার) এবং রিমোট FastAPI কনফিগারেশন প্যাকেজ করে পাইথনএনিহোয়ারে রিলোড সম্পন্ন করে।

Dashboard/ - ফ্রন্টএন্ড কোড (HTML, CSS, JS) এবং চার্ট ড্যাশবোর্ড ইন্টারফেস।
fastapi_gateway/ - FastAPI এপিআই রাউটার যা ডাটা সিঙ্ক ও মেটাডাটা হ্যান্ডেল করে।
googleDrive/ - গুগল শিট মাস্টার সিঙ্ক ও লোকাল ফাইল এনভায়রনমেন্ট ভেরিয়েবলস।
archive/ - পূর্বে ব্যবহৃত সমস্ত এক্সেল ফাইল এবং টেক্সট ফাইল এখানে আর্কাইভ করা হয়েছে পরিবেশ ক্লিন রাখার জন্য।
cloud_diagnostics_guide.md - ক্লাউড ডায়াগনস্টিকস মেথডোলজি গাইড।

যদি কোনো নতুন এআই এসিস্ট্যান্ট বা ডেভেলপার এই প্রোজেক্টে কাজ করতে আসে, তাদের জন্য প্রয়োজনীয় পদক্ষেপসমূহ:

আপনি যদি প্রোজেক্ট কোডে লোকাল কোনো পরিবর্তন করেন, তবে তা সরাসরি পাইথনএনিহোয়ারে ডিপ্লয় করতে লোকাল টার্মিনালে রান করুন:

py -3.12 deploy.py

(এটি প্যাকেজিং, আপলোডিং এবং রিমোট ওয়েবঅ্যাপ রিলোড এক ক্লিকেই করে দেবে)

নতুন ডাটা সিঙ্ক ও টেলিগ্রাম বটের মেটাডাটা রিলোড টেস্ট করতে এই এপিআই-তে রিকোয়েস্ট পাঠান অথবা বট চ্যাটে /reload কমান্ড দিন।

সর্বদা গুগল শিট লাইভ লিংককে মাস্টার ডেটা হিসেবে ব্যবহার করুন।
ডাটাবেজে কোনো লোকাল ফাইল ডিপেনডেন্সি রাখবেন না।
লিডারবোর্ড থেকে খালি বা ভ্যাকেন্ট (VACANT) পদগুলো স্বয়ংক্রিয়ভাবে ফিল্টার আউট করে রাখুন।