60 lines
4.4 KiB
Markdown
60 lines
4.4 KiB
Markdown
# PM — سامانه یکپارچه مدیریت پروژه‌های ساخت و کنترل کیفیت (Aramesh PM)
|
|
|
|
پلتفرم تخصصی مدیریت پروژه‌های عمرانی، کنترل کیفیت و زمان‌بندی کارگاهی که به صورت وندور شده و یکپارچه در کنار سامانه ERP قرار دارد.
|
|
|
|
---
|
|
|
|
## 🏗️ نحوه استقرار و دسترسی در سامانه ERP
|
|
|
|
پلتفرم PM در استک یکپارچه پروژه از دو سرویس داکر تشکیل شده است:
|
|
* **`pm-backend` (`pm-api`):** وب‌سرویس پایتون مبتنی بر FastAPI روی شبکه داخلی استک.
|
|
* **`pm-frontend` (`pm-frontend`):** اپلیکیشن کلاینت React با سرور داخلی Nginx که از طریق ریورس‌پروکسی Traefik زیر مسیر `/pm` قرار گرفته است.
|
|
|
|
### راه‌های دسترسی:
|
|
1. **از داخل رابط کاربری ERP:** با ورود به حساب کاربری (نقش‌های مجاز یا پنل PM) و انتخاب منوی **«مدیریت پروژه (PM)»** در آدرس `/panel/pm` (به صورت آی‌فریم روان با سشن یکپارچه).
|
|
2. **دسترسی مستقیم مرورگر:** در آدرس `http://localhost/pm` (یا دامنه عملیاتی با پسوند `/pm/`).
|
|
|
|
---
|
|
|
|
## 🗄️ پایگاه داده و احراز هویت مشترک
|
|
|
|
* **پایگاه‌داده مشترک:** سرویس PM مستقیماً به همان دیتابیس `procurement` در کانتینر Postgres متصل می‌شود. جداول اختصاصی PM (`pm_projects`, `pm_tasks`, `pm_qc_*`, `pm_defects`, ...) در زمان بوت اولیه به صورت خودکار و بدون تداخل با جداول تدارکات ایجاد می‌شوند (`schema_sync.py`).
|
|
* **احراز هویت یکپارچه (SSO):** ورود با همان حساب کاربری Casdoor انجام شده و سطح دسترسی پنل PM (`user_panels.pm`) کنترل می‌شود.
|
|
|
|
---
|
|
|
|
## ⚙️ قابلیت‌های اصلی پلتفرم PM
|
|
|
|
### ۱. مدیریت زمان‌بندی و شکست کار (WBS & CPM Engine)
|
|
* ساختار شکست کار با عمق نامحدود (فاز، بخش، فعالیت، زیرفعالیت).
|
|
* روابط وابستگی چهارگانه بین فعالیت‌ها (`FS`, `SS`, `FF`, `SF`) به همراه زمان وقفه (Lag).
|
|
* محاسبه خودکار مسیر بحرانی (Critical Path Method) و شناوری کل فعالیت‌ها.
|
|
* گانت چارت شمسی و تعریف مایلستون‌های کلیدی پروژه.
|
|
|
|
### ۲. چرخه سه‌مرحله‌ای کنترل کیفیت (QC Module)
|
|
* **قالب‌های عمومی بازرسی (QC Templates):** تعریف چک‌لیست‌های استاندارد کیفیت برای انواع فعالیت‌های ساختمانی.
|
|
* **مراحل ارزیابی:**
|
|
* **پیش از اجرا (`pre`):** دروازه ورود به تسک؛ تا زمان تایید این مرحله، پیشرفت تسک نمی‌تواند بیشتر از ۰٪ شود.
|
|
* **حین اجرا (`during`):** ثبت بازرسی‌های فنی حین عملیات اجرایی.
|
|
* **پس از اجرا (`after`):** کنترل نهایی؛ تا زمان تایید تمامی سوالات الزامی، پیشرفت تسک اجازه ۱۰۰٪ شدن ندارد.
|
|
* **ثبت و پیگیری عیوب (Defects):** ثبت عیوب همراه با تصاویر، سطح بحرانی بودن و لزوم بازرسی مجدد پس از اقدامات اصلاحی.
|
|
|
|
### ۳. مدیریت منابع و اتصال به انبار کارگاه
|
|
* امکان تخصیص متریال و ثبت رزرو نرم با استعلام موجودی واقعی انبارهای متناظر در ERP.
|
|
|
|
---
|
|
|
|
## 🧪 اجرای آزمایشی مستقل (Standalone Dev)
|
|
|
|
در صورت تمایل به اجرای مستقل پلتفرم PM برای تست‌های ایزوله:
|
|
```powershell
|
|
# از درون پوشه pm:
|
|
powershell -ExecutionPolicy Bypass -File .\start.ps1
|
|
```
|
|
این حالت روی پورت محلی `8083` به صورت ایزوله اجرا خواهد شد.
|
|
|
|
---
|
|
|
|
## 📑 قرارداد و مستندات API
|
|
قرارداد جامع اندپوینت‌ها و نمونه پیام‌ها در فایل [API_CONTRACT.md](API_CONTRACT.md) و راهنمای تفصیلی ساختار جداول در [DATABASE_GUIDE.md](DATABASE_GUIDE.md) مستند شده است.
|