PM — سامانه یکپارچه مدیریت پروژه‌های ساخت و کنترل کیفیت (Aramesh PM)
پلتفرم تخصصی مدیریت پروژه‌های عمرانی، کنترل کیفیت و زمان‌بندی کارگاهی که به صورت وندور شده و یکپارچه در کنار سامانه ERP قرار دارد.
🏗️ نحوه استقرار و دسترسی در سامانه ERP
پلتفرم PM در استک یکپارچه پروژه از دو سرویس داکر تشکیل شده است:
pm-backend(pm-api): وب‌سرویس پایتون مبتنی بر FastAPI روی شبکه داخلی استک.pm-frontend(pm-frontend): اپلیکیشن کلاینت React با سرور داخلی Nginx که از طریق ریورس‌پروکسی Traefik زیر مسیر/pmقرار گرفته است.
راه‌های دسترسی:
- از داخل رابط کاربری ERP: با ورود به حساب کاربری (نقش‌های مجاز یا پنل PM) و انتخاب منوی «مدیریت پروژه (PM)» در آدرس
/panel/pm(به صورت آی‌فریم روان با سشن یکپارچه). - دسترسی مستقیم مرورگر: در آدرس
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 برای تست‌های ایزوله:
# از درون پوشه pm:
powershell -ExecutionPolicy Bypass -File .\start.ps1
این حالت روی پورت محلی 8083 به صورت ایزوله اجرا خواهد شد.
📑 قرارداد و مستندات API
قرارداد جامع اندپوینت‌ها و نمونه پیام‌ها در فایل API_CONTRACT.md و راهنمای تفصیلی ساختار جداول در DATABASE_GUIDE.md مستند شده است.