مِمّ يتكوّن القالب
قالب SaaS أولي لشركات B2B من ثلاثة تطبيقات: موقع عام يبيع تراخيصه، ولوحة تحكم لمساحات عمل متعددة المستأجرين مع إدارة المنصة، وواجهة NestJS API التي تخدم الاثنين.
| التطبيق | المجلد | المنفذ | ما هو |
|---|---|---|---|
| الموقع العام | website/ | 3030 | Next.js 16: الصفحة الرئيسية، والتراخيص في صفحة الأسعار مع دفع خاص بها، والتوثيق، والمدونة، وسجل التغييرات، والتواصل، والصفحات القانونية |
| لوحة تحكم مساحة العمل | dashboard/ | 3031 | Next.js 16: تسجيل الدخول وإنشاء الحساب والإعداد الأولي؛ ومساحة العمل (نظرة عامة، والمشاريع ولوحات مهامها، والفريق والدعوات، والأدوار، والفوترة، والإعدادات ومفاتيح API، والنشاط، والمساعد الذكي)؛ وإدارة المنصة (نظرة عامة، والمؤسسات، والمستخدمون، وفريق المنصة، وأدوار المنصة وإعداداتها) |
| API | back-end/ | 8000 | NestJS 12 وTypeORM، على SQLite محليًا وMySQL بالإعداد، وكل المسارات تحت /api، والمسار العام /api/v1 لمفاتيح API، وتحديث الصلاحيات مباشرة، وخادم MCP |
يحتوي المجلد أيضًا على docker-compose.yml الذي يبني التطبيقات الثلاثة ويشغّلها بأمر واحد، ولكل تطبيق Dockerfile خاص به.
ما تحتويه حزمتك
حزمة موقع SaaS هي الموقع العام وحده.
| التطبيق | المجلد | المنفذ | ما هو |
|---|---|---|---|
| الموقع العام | website/ | 3030 | Next.js 16: الصفحة الرئيسية، والتراخيص في صفحة الأسعار مع دفع خاص بها، والتوثيق، والمدونة، وسجل التغييرات، والتواصل، والصفحات القانونية |
معظم الموقع محتوى خاص به. جزءان يستدعيان واجهة Northstack API: نموذج التواصل ودفع الترخيص. من دون واجهة API يعمل الموقع ببيانات تجريبية مدمجة تجيب عن الاثنين داخل المتصفح، فتشغّله فورًا. واجهة API ولوحة التحكم حزمتان منفصلتان وليستا في هذا التنزيل.
ما تحتويه حزمتك
حزمة لوحة تحكم مساحة العمل هي لوحة التحكم وحدها.
| التطبيق | المجلد | المنفذ | ما هو |
|---|---|---|---|
| لوحة تحكم مساحة العمل | dashboard/ | 3031 | Next.js 16: تسجيل الدخول وإنشاء الحساب والإعداد الأولي؛ ومساحة العمل (نظرة عامة، والمشاريع ولوحات مهامها، والفريق والدعوات، والأدوار، والفوترة، والإعدادات ومفاتيح API، والنشاط، والمساعد الذكي)؛ وإدارة المنصة (نظرة عامة، والمؤسسات، والمستخدمون، وفريق المنصة، وأدوار المنصة وإعداداتها) |
ليس لها بيانات خاصة بها: كل شاشة تقرأ وتكتب عبر واجهة Northstack API. وإلى أن توجّهها إلى واحدة، تعمل ببيانات تجريبية مدمجة داخل متصفحك، فتعمل كل شاشة فورًا. واجهة API والموقع العام حزمتان منفصلتان وليستا في هذا التنزيل.
ما تحتويه حزمتك
حزمة واجهة API الخلفية هي واجهة NestJS API وحدها، مع قاعدة البيانات ومساحات العمل التجريبية وكل مسار تستخدمه الواجهتان الأماميتان.
| التطبيق | المجلد | المنفذ | ما هو |
|---|---|---|---|
| API | back-end/ | 8000 | NestJS 12 وTypeORM، على SQLite محليًا وMySQL بالإعداد، وكل المسارات تحت /api، والمسار العام /api/v1 لمفاتيح API، وتحديث الصلاحيات مباشرة، وخادم MCP |
الموقع العام ولوحة تحكم مساحة العمل حزمتان منفصلتان وليستا في هذا التنزيل. يستطيع أي عميل استخدام واجهة API عبر HTTP.
على Windows، استخدم PowerShell أو Git Bash لتنفيذ الأوامر الواردة في هذه الأدلة.
تعمل الواجهتان الأماميتان بالإنجليزية والعربية، مع واجهة عربية من اليمين إلى اليسار، وبمظهر فاتح ومظهر داكن.