প্রকল্প সম্পর্কে

এই রিপোজিটরিটি একটি বাস্তব ব্যবসা পরিচালনার জন্য ই-কমার্স ওয়ার্ক প্ল্যাটফর্ম, যা কেবল একটি ডেটা ড্যাশবোর্ড নয়। সিস্টেমটি একসাথে অভ্যন্তরীণ বিক্রয়, বৈদেশিক বাণিজ্য, সাপ্লাই চেইন, ইনভেন্টরি, লজিস্টিকস, ফাইন্যান্স এবং মাসিক সেটেলমেন্ট পরিচালনা করে এবং একটি ইউনিফাইড বিজনেস ডেটা ও ফাইন্যান্সিয়াল আইটেম বেসের মাধ্যমে মডিউলগুলোকে সংযুক্ত করে। প্রধান কাজের প্রবেশপথ তিন ভাগে বিভক্ত: অভ্যন্তরীণ বিক্রয় ওয়ার্কবেঞ্চ (ব্যবসার সারসংক্ষেপ, বিক্রয় কেন্দ্র, মৌলিক পণ্য, ইনভেন্টরি কেন্দ্র, সাপ্লাই চেইন কেন্দ্র, কুরিয়ার লজিস্টিকস, ফাইন্যান্সিয়াল সেন্টার), বৈদেশিক বাণিজ্য ওয়ার্কবেঞ্চ (বৈদেশিক বাণিজ্য সারসংক্ষেপ, বৈদেশিক বাণিজ্য অর্ডার, B2B গ্রাহক ও ডিলার, চ্যানেল ম্যানেজমেন্ট, ওভারসিজ SKU ম্যাপিং, আন্তর্জাতিক শিপমেন্ট, বৈদেশিক বাণিজ্য ফাইন্যান্স, Alsvid ব্যবসা), এবং একটি স্বাধীন ফাইন্যান্সিয়াল সেন্টার। ফাইন্যান্সিয়াল সেন্টারে কোম্পানি সত্তা প্রথম মাত্রা এবং ব্যবসার পরিধি দ্বিতীয় মাত্রা। ডিফল্ট সত্তা হল ঝেজিয়াং কোম্পানি, এবং অস্ট্রিয়া, জার্মানি, হংকং ইত্যাদি সত্তা সম্প্রসারণের জন্য সংরক্ষিত, যাতে ফাইন্যান্স সিস্টেম পুনরায় তৈরি করার প্রয়োজন না হয়। মূল মডেল হল FinanceEntry, যা কোম্পানি সত্তা, ব্যবসার পরিধি, উৎস মডিউল ও অর্ডার নম্বর, ফাইন্যান্সিয়াল ক্যাটাগরি, আয়-ব্যয়, মুদ্রা, পরিমাণ ও করের পরিমাণ, পূর্বাভাস ও প্রকৃত, সেটেলমেন্ট স্ট্যাটাস, ইনভয়েস স্ট্যাটাস, অ্যাকাউন্টিং পিরিয়ড এবং নগদ ও মুনাফাকে প্রভাবিত করে কিনা ইত্যাদি মাত্রা কভার করে। নগদ ও মুনাফা আলাদাভাবে পরিচালিত হয়, যেমন ডিডাক্টেবল ইম্পোর্ট VAT নগদকে প্রভাবিত করে কিন্তু সরাসরি মুনাফাকে প্রভাবিত করে না, শিপমেন্ট পণ্যের খরচ মুনাফাকে প্রভাবিত করে কিন্তু ক্রয় পেমেন্টের নগদ পুনরায় গণনা করে না। ব্যবসায়িক লিংকেজের ক্ষেত্রে, অভ্যন্তরীণ বিক্রয় বিক্রয় অর্ডার, বিক্রয়-পরবর্তী রিফান্ড, বিক্রয় খরচ, ক্রয় ইনভেন্টরি প্রদেয়, কুরিয়ার লজিস্টিকসের পূর্বাভাস ও প্রকৃত বিল রিকনসিলিয়েশন সবই FinanceEntry-তে একীভূত করে; বৈদেশিক বাণিজ্য বৈদেশিক বাণিজ্য অর্ডার, শিপমেন্ট ডেলিভারি অর্ডার, চীন থেকে রপ্তানি, আন্তর্জাতিক পরিবহন, EU ইম্পোর্ট ক্লিয়ারেন্স, ওভারসিজ শেষ মাইল ডেলিভারি, ফাইন্যান্সিয়াল আইটেম ও মাসিক সেটেলমেন্টের ক্রম অনুসারে প্রবাহিত হয়। শিপমেন্ট রপ্তানি ও আমদানি কোম্পানি সত্তা, আমদানি দায়িত্বশীল পক্ষ, বিল অফ লেডিং কন্টেইনার নম্বর ট্র্যাকিং, রপ্তানি ও আমদানি কাস্টমস ডিক্লেয়ারেশন, সাধারণ শুল্ক, অ্যান্টি-ডাম্পিং ডিউটি, কাউন্টারভেলিং ডিউটি, ইম্পোর্ট VAT, ক্লিয়ারেন্স পোর্ট চার্জ ও শেষ মাইল ডেলিভারি, রপ্তানি রিবেট এবং পূর্বাভাস ও প্রকৃত খরচ রেকর্ড করতে পারে। আমদানি কর ও ফি শুধুমাত্র তখনই সংশ্লিষ্ট সত্তার ফাইন্যান্সে প্রবেশ করে যখন আমাদের পক্ষ আমদানির দায়িত্ব নেয়। মাসিক সেটেলমেন্ট সেন্টার কোম্পানি সত্তা অনুযায়ী পরিবর্তিত হয়, সরাসরি ব্যবসায়িক ডেটাবেস থেকে পড়ে, এবং ব্যবসায়িক ডেটার সম্পূর্ণতা পরীক্ষা, বিক্রয় পরিমাণ ও খরচ পরীক্ষা, ব্যাংক লেনদেনের বিবরণ ও রসিদ, ইনভয়েসবিহীন আয়, বৈদেশিক বাণিজ্য ফাইন্যান্স সারসংক্ষেপ, মাসিক ZIP প্যাকেজিং, ইমেইলের মাধ্যমে ফাইন্যান্স পাঠানো ও ঐতিহাসিক সংস্করণ আর্কাইভিং প্রদান করে। যদি বিক্রয় SKU-এর ক্রয় ইনভেন্টরি খরচ অনুপস্থিত থাকে, সিস্টেম স্পষ্টভাবে অনুপস্থিত SKU নির্দেশ করবে, এবং কাল্পনিক খরচ ব্যবহার করে ভুল মুনাফা তৈরি করবে না। বাহ্যিক ডেটা উৎস বর্তমানে Jikeyun, 1688, Zhejiang Rural Credit ফাইল ইম্পোর্ট, ট্যাক্স ইনভয়েস তালিকা, SMTP ফাইন্যান্স ইমেইল এবং ভবিষ্যতে বৈদেশিক বাণিজ্য চ্যানেল ও Shopify সংযোগ সমর্থন বা সংরক্ষণ করে; অকনফিগারড বাহ্যিক সিস্টেম সততার সাথে 'অকনফিগারড' দেখাবে এবং বাস্তব সংযোগ ছদ্মবেশে সিমুলেটেড ডেটা ব্যবহার করবে না। প্রযুক্তিগত স্ট্যাকের ব্যাকএন্ড হল Python 3.12, FastAPI, SQLAlchemy 2, Alembic, Pydantic, PostgreSQL, Celery ও Redis; ফ্রন্টএন্ড হল Next.js 16, React 19, Tailwind CSS 4, যা স্ট্যাটিক এক্সপোর্ট ব্যবহার করে এবং FastAPI একই পোর্টে হোস্ট করে, ডিফল্ট সার্ভিস পোর্ট 127.0.0.1:8000, PostgreSQL ও Redis পাবলিক নেটওয়ার্কে উন্মুক্ত নয়। বর্তমানে প্রধান উন্নয়ন ও গ্রহণযোগ্যতা পরিবেশ হল Mac-এ স্থানীয় নেটিভ রান, NAS ও ZSpace ডিপ্লয়মেন্ট স্থগিত, কন্টেইনারাইজেশন ও প্রকাশ কনফিগারেশন সংরক্ষিত। উন্নয়ন প্রক্রিয়া সরাসরি পুশ মোড ব্যবহার করে, দৈনন্দিন পরিবর্তন সরাসরি develop-এ কমিট ও পুশ করা হয়, CI পুশ দ্বারা ট্রিগার হয়, main আনুষ্ঠানিক প্রকাশের প্রধান শাখা। রিপোজিটরি স্ট্যাটাস চেক, রিস্টার্ট, ফ্রন্টএন্ড রিবিল্ড, Alembic মাইগ্রেশন, ব্যাকএন্ড টেস্ট, ফ্রন্টএন্ড টাইপ চেক, স্থানীয় সম্পূর্ণ গ্রহণযোগ্যতা ও ব্যাকআপের জন্য make কমান্ড প্রদান করে। স্থায়ীত্ব নীতি কোড, ডেটাবেস, ব্যবসায়িক ফাইল, ব্যাকআপ ও লগ আলাদা করার উপর জোর দেয়, PERSIST_ROOT, DATA_DIR, BACKUP_DIR, LOG_DIR কনফিগারেশনের মাধ্যমে, যাতে Git আপডেট বা শাখা পরিবর্তন ব্যবসায়িক ডেটা ওভাররাইট না করে। নিরাপত্তা নীতির মধ্যে রয়েছে .env Git-এ না রাখা, ডেটাবেস ও ক্যাশে পাবলিক নেটওয়ার্কে না খোলা, উন্নয়ন পর্যায়ে 8000 পোর্ট পাবলিক নেটওয়ার্কে না খোলা, 1688 শুধুমাত্র ইতিমধ্যে হওয়া ক্রয় সিঙ্ক্রোনাইজ করা এবং স্বয়ংক্রিয়ভাবে অর্ডার ও পেমেন্ট না করা, মূল ফাইন্যান্সিয়াল ডকুমেন্টের সংস্করণ সংরক্ষণ, ডেটাবেস স্ট্রাকচার পরিবর্তনের জন্য Alembic ব্যবহার করা বাধ্যতামূলক, এবং বড় কাঠামোগত সমন্বয়ের আগে ব্যাকআপ নেওয়া। সিস্টেম আপডেট নেটিভ মোড ও কন্টেইনার প্রকাশের পরিচয় সমর্থন করে, এবং Git শাখা ও রিমোট, ওয়ার্কস্পেস স্ট্যাটাস, Python ও Node পরিবেশ, Alembic, ব্যাকআপ ক্ষমতা, ফ্রন্টএন্ড আউটপুট, হেলথ চেক ও ডিস্ক স্পেস পরীক্ষা করে।