MMD
2747f9d4bb
The PM panel (PmPanelPage -> iframe /pm/) needs the project-management platform served at /pm/ on the ERP domain. Source: org repo Aramesh/PM, branch feature/project-management-platform. Update via: git subtree pull --prefix=pm aramesh-pm feature/project-management-platform --squash
92 lines
4.9 KiB
Markdown
92 lines
4.9 KiB
Markdown
# 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)
|