اپلیکیشن موبایل‌محور و تحت وب برای مدیریت جامع پروژه‌های عمرانی و ساخت: مدیریت سلسله‌مراتب فعالیت‌ها (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 جهت استعلام موجودی انبارهای کارگاه
رزرو نرم مصالح جهت جلوگیری از تداخل مصرف در بخش‌های مختلف پروژه

۴. تقویم و تاریخ‌های شمسی

تقویم بومی جلالی بدون خطا و با رعایت روزهای کاری
ثبت و نمایش روان تاریخ‌ها در رابط کاربری به زبان فارسی

راه‌اندازی و اجرا

اجرای آسان با اسکریپت پاورشل یا داکر کامپوز:

# اجرای خودکار از پوشه PM:
powershell -ExecutionPolicy Bypass -File .\start.ps1

یا مستقیماً با داکر:

docker compose up -d --build

قرارداد API

مستندات کامل اندپوینت‌ها: API_CONTRACT.md