عن المشروع

هذا المستودع هو منصة عمل تجارة إلكترونية موجهة للتشغيل الفعلي، وليس مجرد لوحة بيانات. يحمل النظام في الوقت نفسه المبيعات المحلية والتجارة الخارجية وسلسلة التوريد والمخزون والخدمات اللوجستية والمالية والتسوية الشهرية، ويربط الوحدات من خلال قاعدة بيانات الأعمال الموحدة وقاعدة الشؤون المالية. تنقسم مداخل العمل الرئيسية إلى ثلاثة أجزاء: منصة عمل المبيعات المحلية (نظرة عامة على التشغيل، مركز المبيعات، السلع الأساسية، مركز المخزون، مركز سلسلة التوريد، الخدمات اللوجستية السريعة، مركز المالية)، ومنصة عمل التجارة الخارجية (نظرة عامة على التجارة الخارجية، طلبات التجارة الخارجية، عملاء B2B والموزعون، إدارة القنوات، تعيين SKU الخارجي، الشحن الدولي، المالية الخارجية، أعمال Alsvid)، ومركز مالي مستقل. يتخذ المركز المالي الكيان الشركتي كبعد أول ونطاق الأعمال كبعد ثانٍ، ويكون الكيان الافتراضي هو شركة تشجيانغ، مع ترك مجال لتوسيع كيانات مثل النمسا وألمانيا وهونغ كونغ، دون الحاجة لإعادة بناء النظام المالي. النموذج الأساسي هو FinanceEntry، ويشمل أبعادًا مثل الكيان الشركتي ونطاق الأعمال ووحدة المصدر ورقم الطلب والفئة المالية والإيرادات والمصروفات والعملة والمبلغ والضريبة والتقدير والفعلي وحالة التسوية وحالة الفاتورة والفترة المحاسبية، وما إذا كان يؤثر على النقد والأرباح. يتم التعامل مع النقد والأرباح بشكل منفصل، على سبيل المثال، تؤثر ضريبة القيمة المضافة القابلة للخصم على النقد ولكنها لا تؤثر مباشرة على الأرباح، وتؤثر تكلفة بضائع الشحن على الأرباح ولكنها لا تكرر حساب النقد من مشتريات الدفع. فيما يتعلق بسلاسل الأعمال، تقوم المبيعات المحلية بدمج أوامر المبيعات واسترداد ما بعد البيع وتكاليف المبيعات وحسابات مشتريات المخزون والفواتير التقديرية والفعلي للخدمات اللوجستية السريعة في FinanceEntry؛ بينما تتبع التجارة الخارجية ترتيب أوامر التجارة الخارجية وشحنات التصدير والتصدير الصيني والنقل الدولي والتخليص الجمركي للاستيراد في الاتحاد الأوروبي والتوزيع النهائي في الخارج والشؤون المالية والتسوية الشهرية. يمكن لـ Shipment تسجيل كيان الشركة المصدرة والمستوردة والجهة المسؤولة عن الاستيراد ورقم الحاوية والتخليص الجمركي للتصدير والاستيراد والرسوم الجمركية العادية ورسوم مكافحة الإغراق ورسوم مكافحة الدعم وضريبة القيمة المضافة للاستيراد ورسوم الميناء والتوزيع النهائي واسترداد ضريبة التصدير والتكاليف التقديرية والفعلي. تدخل الضرائب والرسوم الاستيرادية في مالية الكيان المقابل فقط عندما يتحمل كياننا مسؤولية الاستيراد. يتبدل مركز التسوية الشهرية حسب الكيان الشركتي، ويقرأ مباشرة قاعدة بيانات الأعمال، ويوفر فحص سلامة بيانات الأعمال وفحص مبالغ المبيعات والتكاليف وتفاصيل المعاملات المصرفية والإيصالات والإيرادات غير المفوتة وملخص المالية الخارجية وحزمة 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 بواسطة push، ويكون main هو الخط الرئيسي للإصدار الرسمي. يوفر المستودع أوامر make لعرض الحالة وإعادة التشغيل وإعادة بناء الواجهة الأمامية وترحيل Alembic واختبار الخلفية وفحص نوع الواجهة الأمامية والتحقق المحلي الكامل والنسخ الاحتياطي. تؤكد مبادئ الثبات على فصل الكود وقاعدة البيانات وملفات الأعمال والنسخ الاحتياطي والسجلات، من خلال تكوين PERSIST_ROOT و DATA_DIR و BACKUP_DIR و LOG_DIR، لتجنب استبدال بيانات الأعمال عند تحديث Git أو تبديل الفروع. تشمل مبادئ الأمان عدم تقديم .env إلى Git، وعدم فتح قاعدة البيانات وذاكرة التخزين المؤقت للإنترنت العام، وعدم تعريض المنفذ 8000 للإنترنت العام في مرحلة التطوير، ومزامنة 1688 فقط للمشتريات التي تمت دون طلب تلقائي أو دفع، والاحتفاظ بنسخ من المواد المالية الأصلية، وإجراء تغييرات هيكل قاعدة البيانات عبر Alembic فقط، وعمل نسخ احتياطي قبل التعديلات الهيكلية الكبيرة. يدعم تحديث النظام التعرف على الوضع الأصلي وهوية نشر الحاوية، ويتحقق من فرع Git والبعيد وحالة مساحة العمل وبيئة Python و Node و Alembic وقدرة النسخ الاحتياطي ومنتجات الواجهة الأمامية وفحص الصحة ومساحة القرص.