Laundry Management System — Documentation¶
A comprehensive, bilingual documentation suite for the Laundry Management System.
What Is This?¶
The Laundry Management System is a complete business application for managing laundry operations — clothing, carpets, tailoring, inventory, customers, payments, and financial accounting. It supports online cloud servers, fully offline branch PCs, and hybrid offline branches that periodically sync data.
This documentation covers everything: requirements, architecture, development guides, deployment instructions, security design, testing strategy, and project management.
Quick Navigation¶
| I want to... | Read this |
|---|---|
| Understand what the system does | SRS (English) / SRS (Arabic) |
| See the data model and accounting flows | Data Model (EN) / Data Model (AR) |
| Set up a development environment | Contributing Guide |
| Deploy to a server or branch PC | Infrastructure & Deployment (EN) / Infrastructure & Deployment (AR) |
| Understand the CI/CD pipeline | CI/CD Pipeline (EN) / CI/CD Pipeline (AR) |
| Write backend code | Backend Libraries (EN) / Backend Libraries (AR) |
| Write frontend code | Frontend Libraries (EN) / Frontend Libraries (AR) |
| Understand testing requirements | Testing Strategy (EN) / Testing Strategy (AR) |
| See the sprint plan and timeline | Project Execution Plan (EN) / Project Execution Plan (AR) |
| Know why we made architectural decisions | Architecture Decision Records |
| Understand security protections | Security Overview (EN) / Security Overview (AR) |
| Set up the GitHub Projects board | Project Board Setup |
| Publish this documentation site | Deploy Docs Site |
Tech Stack¶
| Layer | Technology |
|---|---|
| Backend | ASP.NET Core 10 + .NET 10 (C#) |
| Frontend | Angular 19+ + PrimeNG + NgRx |
| Desktop | Tauri 2 (Windows, macOS, Linux) |
| Database | PostgreSQL 16 (central/online), SQLite (offline branches) |
| Reverse Proxy | Traefik v3 |
| Logging | Seq + OpenTelemetry |
| Orchestration | Docker Compose |
| CI/CD | GitHub Actions → ghcr.io → GitHub Releases |
| Documentation | MkDocs + Material for MkDocs → Cloudflare Pages |
Contributing¶
See CONTRIBUTING.md for how to set up your dev environment, commit conventions, and pull request requirements.
The Project Execution Plan shows the 10-phase implementation timeline with dependencies, milestones, and risks.
Languages¶
This documentation is fully bilingual — every major document is available in English and Arabic (العربية). Use the navigation menu to switch between languages.
نظام إدارة المغسلة — التوثيق¶
مجموعة توثيق شاملة وثنائية اللغة لنظام إدارة المغسلة.
ما هذا؟¶
نظام إدارة المغسلة هو تطبيق أعمال متكامل لإدارة جميع عمليات المغسلة — الملابس، السجاد، الخياطة، المخزون، الزبائن، المدفوعات، والمحاسبة المالية. يدعم الخوادم المتصلة بالسحابة، وأجهزة الفروع غير المتصلة تماماً، والفروع الهجينة التي تزامن بياناتها دورياً.
يغطي هذا التوثيق كل شيء: المتطلبات، المعمارية، أدلة التطوير، تعليمات النشر، تصميم الأمان، استراتيجية الاختبار، وإدارة المشروع.
تصفح سريع¶
| أريد أن... | اقرأ هذا |
|---|---|
| أفهم ما يفعله النظام | SRS (English) / SRS (Arabic) |
| أرى نموذج البيانات والتدفقات المحاسبية | Data Model (EN) / Data Model (AR) |
| أجهز بيئة تطوير | Contributing Guide |
| أنشر على خادم أو جهاز فرع | Infrastructure & Deployment (EN) / Infrastructure & Deployment (AR) |
| أفهم خط CI/CD | CI/CD Pipeline (EN) / CI/CD Pipeline (AR) |
| أكتب كود خلفية | Backend Libraries (EN) / Backend Libraries (AR) |
| أكتب كود واجهة | Frontend Libraries (EN) / Frontend Libraries (AR) |
| أفهم متطلبات الاختبار | Testing Strategy (EN) / Testing Strategy (AR) |
| أرى خطة السبرنتات والجدول الزمني | Project Execution Plan (EN) / Project Execution Plan (AR) |
| أعرف لماذا اتخذنا قرارات معمارية | Architecture Decision Records |
| أفهم حماية الأمان | Security Overview (EN) / Security Overview (AR) |
| أعد لوحة GitHub Projects | Project Board Setup |
| أنشر موقع التوثيق هذا | Deploy Docs Site |
مجموعة التقنيات¶
| الطبقة | التقنية |
|---|---|
| الخلفية | ASP.NET Core 10 + .NET 10 (C#) |
| الواجهة | Angular 19+ + PrimeNG + NgRx |
| سطح المكتب | Tauri 2 (Windows, macOS, Linux) |
| قاعدة البيانات | PostgreSQL 16 (مركزي/متصل)، SQLite (فروع غير متصلة) |
| الوكيل العكسي | Traefik v3 |
| التسجيل | Seq + OpenTelemetry |
| التنسيق | Docker Compose |
| CI/CD | GitHub Actions → ghcr.io → GitHub Releases |
| التوثيق | MkDocs + Material for MkDocs → Cloudflare Pages |