Squashed 'pm/' content from commit 91f3271

git-subtree-dir: pm git-subtree-split: 91f3271d866fa8ee471cfb6793e334b83e6d2b6e
2026-10-07 15:14:20 +03:30
commit 934b74ebbd
87 changed files with 23922 additions and 0 deletions
@@ -0,0 +1,91 @@
+# PM — سامانه یکپارچه مدیریت پروژه‌های ساخت و کنترل کیفیت
+
+اپلیکیشن موبایل‌محور و تحت وب برای مدیریت جامع پروژه‌های عمرانی و ساخت: مدیریت سلسله‌مراتب فعالیت‌ها (WBS)، زمان‌بندی و گانت چارت، مسیر بحرانی (CPM)، سیستم پیشرفته کنترل کیفیت (QC)، مدیریت مصالح و انبار (با اتصال به ERP) و داشبورد عملیاتی روزانه.
+
+---
+
+## دسترسی سریع
+
+| سامانه | آدرس شبکه محلی | آدرس محلی سیستم |
+|---|---|---|
+| **PM (وب + نمای موبایل)** | http://192.168.1.103:8083 | http://localhost:8083 |
+| **PM API Health** | http://192.168.1.103:8083/api/v1/health | http://localhost:8083/api/v1/health |
+
+**ورود پیش‌فرض:** `admin` / `pm123456` (قابل تغییر از طریق فایل `.env`)
+
+---
+
+## معماری سامانه
+
+```
+PM Frontend (React 19, Tailwind CSS, تقویم شمسی, نمای موبایل و دسکتاپ)
+        │ /api/v1
+        ▼
+PM Backend (FastAPI, Python 3.12, SQLAlchemy 2.0 Async)
+        │
+        ├── Projects & Tasks Engine (سلسله‌مراتب نامحدود WBS، زمان‌بندی CPM، گانت)
+        ├── QC Module (قالب‌های سراسری، تعریف‌های مستقل تسک، چک‌لیست، ثبت عیوب)
+        ├── Materials & Resources (تخصیص نیروی انسانی، ماشین‌آلات، مصالح و رزرو انبار)
+        ├── ERP Integration (استعلام موجودی کاتالوگ و انبارهای پروژه)
+        └── PM Postgres (ذخیره‌سازی بومی داده‌ها با پشتیبانی از JSONB و UUID)
+```
+
+---
+
+## مالکیت داده
+
+| حوزه داده | متولی و مالک | توضیحات |
+|---|---|---|
+| پروژه‌ها، فعالیت‌ها، وابستگی‌ها، مایلستون‌ها | **PM Platform** | مدیریت کامل در دیتابیس بومی PM |
+| چک‌لیست‌ها و کنترل کیفیت (QC) | **PM Platform** | پیش از اجرا، حین اجرا و پس از اجرا |
+| ثبت عیوب و اقدامات اصلاحی | **PM Platform** | الصاق تصویر، شدت عیب، پیگیری رفع |
+| کاتالوگ مصالح و موجودی واقعی انبار | **ERP** | استعلام برخط موجودی از طریق API |
+| رزرو مصالح و درخواست‌های خرید | **PM Platform** | رزرو نرم بدون دستکاری انبار تا زمان تأیید |
+
+---
+
+## قابلیت‌های کلیدی
+
+### ۱. مدیریت زمان‌بندی و گانت چارت (CPM Engine)
+- ایجاد پروژه‌ها با کدهای اختصاصی و تیم پروژه
+- ساختار شکست کار (WBS) در عمق‌های نامحدود (فاز، بخش، فعالیت، زیرفعالیت)
+- وابستگی‌های چهارگانه بین فعالیت‌ها (`FS`, `SS`, `FF`, `SF`) همراه با روزهای تأخیر (Lag)
+- محاسبه خودکار مسیر بحرانی (Critical Path) و شناوری کل فعالیت‌ها
+- تعریف مایلستون‌ها و نقاط عطف کلیدی پروژه
+
+### ۲. چرخه سه‌مرحله‌ای کنترل کیفیت (QC)
+- **مراحل ارزیابی:** پیش از اجرا (`pre`) · حین اجرا (`during`) · پس از اجرا (`after`)
+- **قوانین دروازه‌ای سرور:**
+  - فعالیت تا زمان تأیید الزامات پیش از اجرا اجازه شروع (پیشرفت > ۰) ندارد.
+  - فعالیت تا زمان پاس شدن همه الزامات الزامی اجازه رسیدن به ۱۰۰٪ ندارد.
+- ثبت عیوب همراه با تصاویر و الزام به بازرسی مجدد پس از اصلاح.
+
+### ۳. مدیریت منابع و ارتباط با ERP
+- تخصیص نفرات، ماشین‌آلات و مصالح به تفکیک فعالیت
+- اتصال پروژه به پروژه متناظر در ERP جهت استعلام موجودی انبارهای کارگاه
+- رزرو نرم مصالح جهت جلوگیری از تداخل مصرف در بخش‌های مختلف پروژه
+
+### ۴. تقویم و تاریخ‌های شمسی
+- تقویم بومی جلالی بدون خطا و با رعایت روزهای کاری
+- ثبت و نمایش روان تاریخ‌ها در رابط کاربری به زبان فارسی
+
+---
+
+## راه‌اندازی و اجرا
+
+اجرای آسان با اسکریپت پاورشل یا داکر کامپوز:
+
+```powershell
+# اجرای خودکار از پوشه PM:
+powershell -ExecutionPolicy Bypass -File .\start.ps1
+```
+
+یا مستقیماً با داکر:
+```powershell
+docker compose up -d --build
+```
+
+---
+
+## قرارداد API
+مستندات کامل اندپوینت‌ها: [`API_CONTRACT.md`](API_CONTRACT.md)