في هذه الصفحة
ابدأ من هنا
اختر طريقة تشغيل VendKit.
للتثبيت الفعلي، استخدم Docker Compose على خادم Linux. وللتطوير، شغّل المستودع محليًا باستخدام Node.js وPostgreSQL.
المتطلبات الأساسية
اعرف ما يحتاجه الخادم قبل أن تبدأ.
VendKit خفيف بما يكفي لخادم VPS متواضع، لكنه يحتاج إلى بيئة تشغيل مدعومة ونطاق وخطة نسخ احتياطي. حدّد هذه الأمور قبل التثبيت.
خادم الإنتاج
نقطة بداية مقترحة لمتجر واحد. لا يعلن VendKit حدًا صارمًا للسعة؛ اختر حجم القرص بحسب الصور والنسخ الاحتياطية، لا قاعدة البيانات وحدها.
- نظام التشغيل
- توزيعة Linux حديثة 64-بت تدعم Docker
- بيئة الحاويات
- Docker Engine مع إضافة Docker Compose
- المعالج
- 2 vCPU كحد أدنى؛ 4 vCPU لمتجر مزدحم
- الذاكرة
- 2 GB كحد أدنى؛ 4 GB موصى بها
- القرص
- 20 GB إضافة إلى مساحة لصور المنتجات وأرشيفات النسخ الاحتياطي
- الشبكة
- عنوان IPv4 أو IPv6 عام، ونطاق، والمنفذان 80 و443
التطوير المحلي
استخدم المستودع الأحادي فقط عند العمل على الشيفرة. مسار Docker لا يحتاج Node.js أو PostgreSQL على الخادم.
- Node.js
- 24 أو أحدث
- pnpm
- 11 أو أحدث
- PostgreSQL
- 16 أو أحدث، يعمل محليًا
- Git
- أي إصدار حديث
المنافذ والتعريض
لا ينشر Compose سوى تطبيق الويب. تبقى واجهة API وقاعدة البيانات على شبكة Docker الداخلية.
- تطبيق الويب
- 3000، منشور؛ غيّره عبر WEB_PORT
- واجهة API
- 4000، داخلي فقط
- PostgreSQL
- 5432، داخلي فقط
- HTTPS
- 443 على الوكيل العكسي
تخطيط القرص
قبل التثبيت
جهّز هذه العناصر حتى لا يتعطل التشغيل الأول.
- خادم Linux تستطيع إدارته، مع مستخدم sudo غير جذري
- Docker Engine وإضافة Compose مثبتان
- اسم نطاق تشير سجلات DNS فيه إلى الخادم
- شهادة TLS، يصدرها الوكيل العكسي عادةً
- خطة للنسخ الاحتياطي خارج الخادم وتحديثات النظام
- اسم المدير وبريده الإلكتروني للحساب الأول
تحقق من الخادم
تأكد من توفر Docker وCompose وGit قبل الاستنساخ. ثبّت أي أمر ناقص أولًا.
للتطوير المحلي، تحقق من أدوات اللغة وقاعدة البيانات:
التثبيت باستخدام Docker
من الاستنساخ إلى أول تسجيل دخول.
اتبع هذه الخطوات على خادم Linux لديه Docker وإضافة Compose. أمر الإعداد ينشئ الأسرار المطلوبة تلقائيًا.
قبل أن تبدأ
- تثبيت Git
- Docker مع إضافة Compose
- تخزين دائم لوحدتَي التخزين vendkit-db وvendkit-data
- وكيل عكسي مع HTTPS للنشر العام
- 01
استنسخ المستودع
نزّل الشيفرة إلى مجلد على خادمك. هذا هو مستودع VendKit العام على GitHub.
- 02
أنشئ ملف البيئة
أنشئ الأسرار الثلاثة المطلوبة واكتبها في ملف .env جديد انطلاقًا من القالب. ويقصر الأمر صلاحية الملف على مستخدمك.
- 03
شغّل الحزمة
تطبّق حاوية الـAPI الترحيلات تلقائيًا. قد يستغرق البناء الأول بضع دقائق.
- 04
أنشئ الحساب الأول
افتح التطبيق وأنشئ حساب المدير. ويُغلق التسجيل العام بعد ذلك.
تحقق من التثبيت
ينبغي أن تظهر الحاويتان بحالة سليمة وأن يعيد فحص السلامة استجابة ناجحة.
إذا فشل فحص السلامة، اقرأ سجل API قبل تغيير الإعدادات.
قائمة فحص التشغيل الأول
بعد إنشاء حساب المدير، أكمل هذه الخطوات ليطابق مساحة العمل طريقة بيعك.
- افتح Settings → Business profile وأضف التفاصيل التي تُطبع على الفواتير.
- راجع Settings → Invoice للترقيم وعرض العملة ومدة الاستحقاق والشروط.
- أضف الفئات والعلامات التجارية والمنتجات قبل إنشاء الطلبات.
- أنشئ عميلًا وطلبًا تجريبيًا ثم نزّل ملف الفاتورة PDF.
- نزّل نسخة احتياطية وتأكد من ظهور الأرشيف في سجل النسخ الاحتياطي.
الترقية لاحقًا
اسحب أحدث شيفرة ثم أعد البناء. تُتجاوز الترحيلات المطبقة مسبقًا، لذا يمكن تكرار الأمر بأمان.
التطوير
شغّل VendKit محليًا.
استخدم هذا المسار عند العمل على الشيفرة. تحتاج إلى Node.js 24+ وpnpm 11+ وPostgreSQL 16+.
قبل أن تبدأ
- Node.js 24 أو أحدث
- pnpm 11 أو أحدث
- PostgreSQL 16 أو أحدث
- Git
- 01
استنسخ المستودع
نزّل الشيفرة وانتقل إلى جذر المشروع.
- 02
ثبّت الاعتماديات
ثبّت حزم مساحة العمل باستخدام pnpm.
- 03
أنشئ قاعدة البيانات
أنشئ قاعدة PostgreSQL محلية باسم vendkit. يمكنك استخدام createdb أو عميل PostgreSQL.
- 04
أنشئ ملفات البيئة
انسخ قوالب بيئة الـAPI وقاعدة البيانات وتطبيق الويب. استخدم DATABASE_URL نفسها في ملفي الـAPI وقاعدة البيانات، وAPI_KEY نفسها في ملفي الـAPI وتطبيق الويب.
- 05
طبّق الترحيلات
شغّل ترحيلات قاعدة البيانات قبل بدء التطبيقات.
- 06
ابدأ خوادم التطوير
شغّل تطبيق الويب والـAPI في وضع المراقبة.
ملفات البيئة
يستخدم الإعداد المحلي ثلاثة ملفات: apps/api/.env وpackages/database/.env وapps/web/.env. حافظ على تطابق DATABASE_URL وAPI_KEY بين الملفات.
لا ترفع أي ملف .env إلى المستودع.
الروابط المحلية
- تطبيق الويب
- http://localhost:3000
- واجهة API
- http://localhost:4000/api
- فحص الصحة
- http://localhost:4000/api/health
أوامر مفيدة
pnpm devخادم تطوير الويب والـAPIpnpm buildبناء الإنتاج لمساحة العملpnpm lintفحص ESLint لمساحة العملpnpm check-typesفحص أنواع TypeScriptpnpm testتشغيل الاختباراتpnpm db:migrateإنشاء ترحيلات التطوير أو تطبيقهاpnpm db:studioفتح Prisma Studio
قبل فتح طلب سحب
شغّل ESLint وفحص الأنواع والاختبارات وبناء الإنتاج:
التهيئة
المتغيرات المهمة
يتحقق الـAPI من متغيرات البيئة المطلوبة عند بدء التشغيل، ويرفض الإقلاع مع عرض قائمة بكل مشكلة. أما بيانات النشاط وإعدادات الفواتير فتُحفظ في قاعدة البيانات.
التطوير المحلي
- DATABASE_URL
- سلسلة اتصال PostgreSQL التي يستخدمها الـAPI وPrisma.
- JWT_SECRET
- سر توقيع رموز الوصول، بطول 32 حرفًا على الأقل.
- API_KEY
- المفتاح المشترك الذي يستخدمه تطبيق الويب لاستدعاء الـAPI. أبقِه خاصًا.
- APP_URL
- الرابط العام لتطبيق الويب. تمرره Compose إلى الـAPI بوصفه أصل CORS مسموحًا به.
- ALLOW_PUBLIC_REGISTRATION
- معطّل افتراضيًا. فعّله فقط إذا أردت السماح بالتسجيل بعد الحساب الأول.
- BACKUP_SAFETY_SNAPSHOT
- ينشئ نسخة أمان قبل الاستعادة. مفعّل افتراضيًا.
مرجع البيئة الكامل
يقرأ Compose ملف .env الجذري. تتلقى خدمتا API والويب قيمهما من Compose في Docker، أو من ملفاتهما الخاصة في التطوير المحلي.
Compose (.env)
يقرأه docker compose
POSTGRES_PASSWORD- مطلوب
- كلمة مرور خدمة PostgreSQL المرفقة. استخدم أحرفًا آمنة في URL فقط؛ لأنها تُدرج في DATABASE_URL.
JWT_SECRET- مطلوب (32+ حرفًا)
- يوقّع رموز الوصول.
API_KEY- مطلوب
- مفتاح مشترك بين تطبيق الويب وAPI.
APP_URL- http://localhost:3000
- عنوان الويب العام. يمرره Compose إلى API كـ CORS_ORIGINS.
ALLOW_PUBLIC_REGISTRATION- false
- يسمح بالتسجيل بعد إنشاء المدير الأول.
WEB_PORT- 3000
- منفذ المضيف المنشور لحاوية الويب.
APP_VERSION- 0.1.0
- الإصدار المسجل في بيانات النسخ الاحتياطي.
API
يُتحقق منه عند البدء
DATABASE_URL- مطلوب
- سلسلة اتصال PostgreSQL التي يستخدمها API وPrisma.
JWT_SECRET- مطلوب (32+ حرفًا)
- يوقّع رموز الوصول.
API_KEY- مطلوب
- مفتاح مشترك بين تطبيق الويب وAPI.
PORT- 4000
- منفذ API داخل الحاوية.
CORS_ORIGINS- من APP_URL
- أصول الويب المسموح بها مفصولة بفواصل. يستنتجها Compose من APP_URL.
ALLOW_PUBLIC_REGISTRATION- false
- يسمح بالتسجيل بعد إنشاء المدير الأول.
IMAGE_STORAGE_DIR- uploads/images
- دليل رفع الصور. يضبط Compose القيمة /data/images.
IMAGE_MAX_FILE_SIZE- 5 MB (بالبايت)
- أكبر صورة مقبولة للرفع.
BACKUP_STORAGE_DIR- uploads/backups
- دليل أرشيفات النسخ الاحتياطي. يجب ألا يكون داخل دليل الصور. يضبط Compose القيمة /data/backups.
BACKUP_MAX_FILE_SIZE- 1 GB
- أكبر ملف نسخ احتياطي مقبول للرفع أو الأرشيف.
BACKUP_MAX_EXTRACTED_SIZE- 2 GB
- أكبر حجم استعادة غير مضغوط مقبول.
BACKUP_RESTORE_TRANSACTION_TIMEOUT_MS- 10 دقائق
- مهلة معاملات اللقطة والاستعادة.
BACKUP_SAFETY_SNAPSHOT- true
- ينشئ نسخة أمان قبل الاستعادة.
APP_VERSION- 0.1.0
- الإصدار المسجل في بيانات النسخ الاحتياطي.
الويب
يجب أن يطابق مفتاح API
NEST_API_URL- مطلوب
- عنوان API الأساسي مع /api. يضبط Compose القيمة http://api:4000/api.
API_KEY- مطلوب
- مفتاح مشترك بين تطبيق الويب وAPI.
البيانات والنسخ الاحتياطي
اعرف أين تعيش بياناتك.
يحفظ VendKit سجلات الأعمال في PostgreSQL والملفات المرفوعة على القرص. كلاهما داخل وحدات Docker مسماة ويجب أن يبقيا بعد استبدال الحاويات.
vendkit-dbدليل بيانات PostgreSQL: المنتجات والعملاء والطلبات والمدفوعات والفواتير والمخزون والإعدادات.
vendkit-dataالصور المرفوعة وأرشيفات النسخ الاحتياطي التي تكتبها حاوية API.
المسارات داخل حاوية API
تُكتب النسخ الاحتياطية على نظام ملفات خادم API، لا في خدمة سحابية. يجب ألا يكون دليل النسخ الاحتياطي داخل دليل الصور.
- /data/images
- رفع الصور، مثبت من وحدة vendkit-data.
- /data/backups
- أرشيفات النسخ الاحتياطي، وهي أيضًا على وحدة vendkit-data.
ماذا تتضمن النسخة الاحتياطية
كل أرشيف ملف tar مضغوط بـ gzip ومُصدّر بإصدار، ويتضمن بيانًا ومجاميع تحقق وبيانات الأعمال.
- الفئات والعلامات التجارية والمنتجات وصور المنتجات
- العملاء والطلبات وبنود الطلب والمدفوعات والمرتجعات
- الفواتير وتسلسلات المستندات
- حركات المخزون وإعدادات الأعمال
- كل صورة مرفوعة تشير إليها قاعدة البيانات
ماذا يستثني
تُستثنى بعض السجلات عمدًا حتى لا تؤدي الاستعادة إلى إغلاق وصولك أو محو تاريخها.
- حسابات المستخدمين وتجزئات كلمات المرور ورموز التحديث
- سجل النسخ الاحتياطي والاستعادة
- متغيرات البيئة وعناوين قاعدة البيانات والأسرار
اعرض النسخ على الخادم
تُنشأ الأرشيفات من Settings → Backup & Restore، ويكتبها API في /data/backups، وهي وحدة vendkit-data.
انسخ الأرشيفات خارج الخادم
نزّل النسخ من التطبيق، أو انسخ دليل الأرشيف إلى جهازك. التخزين على الخادم نفسه لا يكفي.
استعد نسخة احتياطية
استعد من Settings → Backup & Restore. يُتحقق من الأرشيف قبل استبدال أي بيانات حالية.
- 1أنشئ نسخة احتياطية جديدة من البيانات الحالية، رغم إنشاء لقطة أمان افتراضيًا.
- 2ارفع الأرشيف الذي تريد الاستعادة منه من شاشة النسخ الاحتياطي.
- 3أكّد الاستعادة. يجب أن يطابق إصدار البيان إصدار التطبيق العامل.
- 4انتظر انتهاء المهمة وتحقق من النتيجة في سجل النسخ الاحتياطي.
- 5افتح طلبًا وفاتورة وصورة منتج للتأكد من البيانات المستعادة.
لا يوجد مجدول تلقائي
النشر
انشر VendKit في الإنتاج.
شغّل حزمة Compose واحدة خلف HTTPS. أبقِ الـAPI خاصًا واحتفظ بنسخ احتياطية لوحدتَي التخزين.
قبل النشر
- خادم Linux مع Docker وإضافة Compose
- نطاق يشير إلى الخادم
- وكيل عكسي بشهادة TLS صالحة
- تخزين دائم وخطة نسخ احتياطي خارج الخادم
- 01
اضبط الرابط العام
اضبط APP_URL على أصل HTTPS النهائي في .env. يُستخدم لـCORS وللروابط المُنشأة.
- 02
شغّل الحزمة
ابنِ وشغّل تطبيق الويب والـAPI وPostgreSQL. تُطبَّق الترحيلات تلقائيًا عند بدء حاوية الـAPI.
- 03
ضعه خلف HTTPS
أنهِ TLS عند وكيل عكسي مثل Caddy أو nginx أو Traefik، ووجّه الحركة إلى تطبيق الويب فقط.
مثال تهيئة Caddy
وكيل عكسي بسيط لتثبيت واحد. عدّله حسب نطاقك وخادمك. استبدل vendkit.example.com بنطاقك. وإذا غيّرت WEB_PORT فحدّث منفذ الوجهة.
- 04
تحقق من النشر
تأكد من صحة الحاويتين ثم افحص نقطة صحة الـAPI.
- 05
أنشئ الحساب الأول
افتح الرابط العام وأنشئ حساب المدير. يُغلق التسجيل العام بعد ذلك.
شغّله بأمان
- شغّل مثيل API واحدًا. تحديد معدل المصادقة يُحفظ في الذاكرة.
- لا تكشف منفذ الـAPI للعامة.
- احفظ وحدتَي التخزين vendkit-db وvendkit-data.
- انسخ أرشيفات النسخ خارج الخادم ضمن سياسة النسخ لديك.
- استخدم HTTPS. ملفات جلسة الإنتاج مضبوطة على Secure.
ترقية تثبيت إنتاجي
اسحب أحدث شيفرة ثم أعد البناء. تُتجاوز الترحيلات المطبقة مسبقًا، لذا يمكن تكرار الأمر بأمان.
الترقيات
رقّي وتراجع بأمان.
يطبق VendKit ترحيلات قاعدة البيانات عند بدء حاوية API. خطط للتحديث، واحتفظ بنسخة سليمة، وتحقق من الحزمة قبل إغلاق نافذة الصيانة.
قبل الترقية
سجّل ما يعمل واحمِ البيانات الحالية.
- اقرأ ملاحظات الإصدار أو التزامات المستودع التي ستُنشر.
- أنشئ نسخة احتياطية من Settings → Backup & Restore ونزّلها.
- سجّل الالتزام الحالي لتتمكن من العودة إليه.
- اختر وقتًا قليل الحركة؛ إذ تُعاد واجهة API أثناء إعادة البناء.
طبّق التحديث
اسحب أحدث شيفرة وأعد بناء صورتي التطبيق. تبقى حاوية قاعدة البيانات قيد التشغيل.
تُتخطى الترحيلات المطبقة سابقًا، لذا يمكن تكرار الأمر بأمان. قد تستغرق أول عملية بناء بعد تغيير كبير عدة دقائق.
تحقق بعد الترقية
تأكد من سلامة الحاويتين، ثم سجّل الدخول وافتح طلبًا وفاتورة وصورة منتج.
التراجع
إذا فشل الإصدار الجديد، عد إلى الالتزام السابق وأعد البناء. ثم استعد النسخة الاحتياطية التي أخذتها قبل الترقية.
استبدل previous-commit بالالتزام الذي سجلته. أبقِ النسخة الاحتياطية حتى يستقر الإصدار الجديد لبضعة أيام.
العمليات
شغّله بلا مفاجآت
افحص الحزمة واقرأ السجلات وحافظ على وحدات التخزين. معظم الحوادث تظهر في docker compose ps وسجل API.
النسخ الاحتياطي
أنشئ أرشيفًا كاملًا من Settings → Backup & Restore. وانسخ الأرشيفات خارج الخادم ضمن روتين النسخ الاحتياطي لديك.
فحص الصحة
تبلغ GET /api/health عن حالة الـAPI وقاعدة البيانات للحاويات والمراقبة.
النشر
لا تكشف منفذ الـAPI. شغّل مثيل API واحدًا، واحتفظ بوحدتي التخزين، وأنهِ HTTPS عند وكيل عكسي.
الاستعادة
تتحقق الاستعادة من الأرشيف وتستبدل بيانات النشاط داخل معاملة واحدة. وتُنشأ نسخة أمان أولًا افتراضيًا.
أوامر يومية
نفّذها من جذر المستودع على الخادم.
docker compose psحالة الحاويات وسلامتهاdocker compose logs -f --tail=100 apiتابع سجل API؛ استخدم web لتطبيق Next.jsdocker compose restart apiأعد تشغيل خدمة واحدة دون إعادة بناءdocker compose exec api wget -qO- http://localhost:4000/api/healthاسأل API وقاعدة البيانات عن حالتهماdocker system dfاعرف المساحة التي تستهلكها الصور والحاوياتdocker compose downأوقف الحاويات والشبكة وأزلها؛ تبقى وحدات التخزينdocker compose up -dشغّل الحاويات الموجودة مجددًا
لا يوجد مجدول نسخ احتياطي تلقائي أو عامل خلفي في هذا الإصدار. cron على الخادم والنسخ خارج الخادم مسؤوليتك.
الأمان
حصّن تثبيتًا مستضافًا ذاتيًا.
أنت تتحكم في الخادم والأسرار والبيانات. هذه الحد الأدنى للممارسات لمتجر حقيقي.
استخدم HTTPS
تُعلَّم ملفات جلسة الإنتاج بـ Secure. لن يسجّل HTTP العادي دخول المستخدمين. أنهِ TLS على وكيل عكسي وأعد توجيه HTTP إلى HTTPS.
أبقِ API خاصًا
لا يُنشر سوى تطبيق الويب. يستدعي المتصفح Next.js التي تمرر الطلبات إلى API بالمفتاح المشترك. لا تنشر المنفذ 4000.
احمِ الأسرار
استخدم قيمًا عشوائية طويلة لـ POSTGRES_PASSWORD وJWT_SECRET وAPI_KEY. أبقِ .env بصلاحيات 600، ولا ترفعه إلى المستودع، ولا تعِد استخدام قيمة بين تثبيتين.
أبقِ التسجيل مغلقًا
يصبح الحساب الأول مديرًا ثم يُغلق التسجيل العام. لا تفعّل ALLOW_PUBLIC_REGISTRATION إلا إذا أردت عمدًا حسابات ذاتية.
أدر الأشخاص
يمكن للمديرين إنشاء أعضاء وإعادة تعيين كلمات المرور من Team. أزل الوصول غير اللازم وتجنب مشاركة حساب مدير واحد.
احمِ النسخ الاحتياطية
تحتوي الأرشيفات على بيانات اتصال العملاء وسجلات الأعمال. خزّن النسخ على تخزين مشفر ومقيّد الوصول واحذفها عند عدم الحاجة.
حصّن الخادم
حدّث نظام التشغيل وDocker، وقيّد SSH، وافتح فقط المنافذ اللازمة: SSH و80 و443. لا تعرّض PostgreSQL.
تابع التحديثات
راقب المستودع للإصدارات وإصلاحات الأمان. اقرأ دليل الترقية، وخذ نسخة احتياطية أولًا، وتحقق بعد كل تحديث.
إذا تسرّب سر
أبلغ عن ثغرة بشكل خاص
VendKit مرخّص بموجب AGPL-3.0. إذا شغّلت نسخة معدّلة كخدمة شبكية، يلزمك الترخيص بتقديم شيفرتها إلى مستخدميها.
استكشاف الأخطاء وإصلاحها
أصلح الأعطال الشائعة.
ابدأ بحالة الحاويات وسجل API. يتحقق VendKit من بيئته عند البدء ويذكر القيم الناقصة أو غير الصالحة في السجل.
اقرأ سجل API
ترفض API البدء عند غياب متغير مطلوب وتسرد كل مشكلة وجدتها.
تحقق من ملف Compose
تأكد من وجود .env ومن حل ملف Compose قبل إعادة البناء.
يتوقف Compose عند رسالة Set … in .env
ملف .env الجذري مفقود أو قيمة مطلوبة فارغة. انسخ .env.example إلى .env وأنشئ الأسرار مجددًا.
حاوية API تعيد التشغيل مرارًا
اقرأ سجل API. غياب DATABASE_URL أو JWT_SECRET أو API_KEY، أو كون JWT_SECRET أقصر من 32 حرفًا، يمنع بدء API.
تسجيل الدخول يدور أو لا يفعل شيئًا
ملفات تعريف ارتباط الإنتاج Secure. استخدم عنوان HTTPS لا عنوان HTTP عاديًا، وتأكد من مطابقة APP_URL للأصل العام.
تطبيق الويب لا يصل إلى API
تأكد من سلامة API. في Compose يجب أن يكون NEST_API_URL هو http://api:4000/api وأن يتطابق API_KEY في خدمتي الويب وAPI.
المنفذ 3000 مستخدم بالفعل
عيّن WEB_PORT إلى منفذ آخر في .env، وأعد تشغيل الحزمة، وحدّث عنوان الوكيل العكسي. تظل الحاوية تستمع إلى 3000 داخليًا.
اختفت البيانات بعد إعادة التشغيل
ربما أُزيلت الحزمة مع وحدات التخزين. لا تستخدم docker compose down --volumes في تثبيت حقيقي. استعد آخر نسخة واحتفظ بوحدتي التخزين المسماتين.
رفضت الاستعادة
يجب أن يطابق إصدار البيان التطبيق العامل، وأن تنجح كل مجاميع التحقق وأحجام الوسائط. استخدم أرشيفًا يطابق تنسيقه التطبيق العامل وافحص سجل النسخ لمعرفة السبب.
تفشل عمليات البناء أو يتباطأ التطبيق
افحص المساحة الحرة عبر df -h واستهلاك Docker عبر docker system df. نظّف الصور والذاكرة المؤقتة غير المستخدمة فقط عند وجود نسخة احتياطية حديثة.
البنية
تطبيق ويب واحد، واجهة API واحدة، وقاعدة بيانات واحدة
يتواصل المتصفح مع تطبيق Next.js فقط، وهو يمرر الطلبات إلى NestJS من جهة الخادم بمفتاح API مشترك، لذا لا تحتاج واجهة API إلى أن تكون عامة.
المستودع
apps/webواجهة Next.js والوكيل الخادمي لواجهة API.
apps/apiواجهة NestJS ومنطق العمل وفواتير PDF والنسخ الاحتياطي.
packages/databaseمخطط Prisma والترحيلات والعميل المولّد.
packages/uiمكوّنات واجهة مشتركة للتطبيق.
docker-compose.ymlالويب والـAPI وPostgreSQL، مع وحدات تخزين دائمة للبيانات والملفات.
المراجع
المستودع هو المصدر الموثوق
تشير هذه الروابط إلى مستودع VendKit، وهي تُحدَّث مع التطبيق لا مع هذا الموقع.