API
Rahdari-Api
سامانه مدیریت پروژه و گردش فرم‌ها
Laravel API • Swagger • Sanctum • RBAC

هسته API پروژه آماده‌ی توسعه، امن و مستندسازی‌شده

این صفحه ورودی اصلی API شماست. از اینجا می‌توانید به مستندات Swagger بروید، ساختار احراز هویت و مدیریت نقش‌ها را ببینید و برای پنل ادمین Nuxt از endpointهای آماده استفاده کنید.

10 نقش سازمانی بر پایه ساختار نقش‌های پروژه و فایل نقش‌های ارسالی شما
46 دسترسی پایه برای مدیریت کاربران، گزارش‌ها، عملیات و کنترل فرایند
Admin User API ساخت کاربر همراه با تعیین نقش‌ها در همان لحظه ایجاد

اندپوینت‌های اصلی

این بخش برای تیم فرانت و ادمین مشخص می‌کند از چه endpointهایی برای ورود، گرفتن کاربر جاری، دریافت کاتالوگ نقش‌ها و ساخت کاربر استفاده شود.

POST
https://www.api.yazdstar.ir/api/v1/auth/login
ورود با شماره موبایل و رمز عبور
GET
https://www.api.yazdstar.ir/api/v1/auth/me
اطلاعات کاربر احراز هویت‌شده همراه با نقش‌ها و دسترسی‌ها
GET
https://www.api.yazdstar.ir/api/v1/admin/roles
دریافت لیست نقش‌ها و دسترسی‌های قابل انتخاب برای فرم ساخت کاربر در پنل ادمین
POST
https://www.api.yazdstar.ir/api/v1/admin/users
ساخت کاربر جدید توسط ادمین همراه با آرایه roles

نقش‌ها و دسترسی‌ها

این بخش برای نمایش رسمی روی سایت طراحی شده تا نقش‌های اصلی پروژه و خلاصه سطح دسترسی هرکدام به‌صورت واضح و قابل استناد دیده شوند.

ادمین سامانه admin
مدیر فنی سامانه برای مدیریت کاربران، نقش‌ها و پیکربندی پایه.
دسترسی کامل به مدیریت کاربران، نقش‌ها، گزارش‌ها و تنظیمات پایه سامانه.
کارشناس دفتر PMO pmo
مالک داشبوردها و ناظر فرایندی با دسترسی جامع عملیاتی و مدیریتی.
مشاهده گردش قراردادها، مدیریت کاربران، گزارش‌گیری؛ بدون ثبت پرداخت مالی.
نظارت عالی high_supervision
ناظر سطح بالا برای ثبت قرارداد، تحویل مسیر و کنترل کلی اجرا.
ایجاد/ویرایش قرارداد، تحویل مسیر، تمدید، فهرست‌بها؛ مشاهده صورت‌وضعیت و موازنه قیر.
ناظر مقیم resident_supervisor
ثبت‌کننده اطلاعات میدانی و عملکرد روزانه پروژه در محل اجرا.
ثبت عملکرد روزانه و دستورکار با ویرایش محدود در بازه مجاز.
سرناظر chief_supervisor
نقش میدانی با کنترل عملکرد و ثبت دستورکار.
ثبت و بررسی عملکرد روزانه، دستورکار، و مشاهده موازنه قیر.
کارشناس پیمان رسیدگی contract_review_team
مرجع بررسی فنی، قراردادی و فرم‌های تکمیلی.
مدیریت صورت‌وضعیت، تاخیرات، تعدیل، تحویل موقت و فرم‌های پیمان.
کارشناس قیر bitumen_expert
مسئول ثبت و کنترل موازنه مصالح قیر.
ثبت موازنه مصالح قیر و تحویل قیر.
کارشناس مالی financial_expert
مسئول ثبت پرداخت‌های صورت‌وضعیت.
ثبت پرداخت‌های مالی و مشاهده صورت‌وضعیت برای تطبیق.
معاونت فنی راه‌ها deputy
بهره‌بردار مدیریتی با دسترسی به داشبوردها و گزارش‌ها.
مشاهده قراردادها، صورت‌وضعیت، پرداخت‌ها و موازنه قیر.
مدیر عامل manager
نقش تصمیم‌گیرنده با دسترسی مدیریتی و گزارش‌های کلان.
مشاهده وضعیت کلی پروژه‌ها و گزارش‌های مدیریتی.
فرم ادمین برای ساخت کاربر در Nuxt کافی است ابتدا GET /api/v1/admin/roles را صدا بزنید و سپس آرایه roles را در درخواست ساخت کاربر ارسال کنید.
مستندسازی Swagger بعد از جایگذاری فایل‌ها، خروجی Swagger را regenerate کنید تا endpointهای جدید نقش‌ها و کاربران در مستندات نمایش داده شوند.
سازگار با توسعه بعدی چینش نقش‌ها و دسترسی‌ها از فایل config خوانده می‌شود تا بعداً افزودن نقش یا تغییر سطح دسترسی ساده و متمرکز بماند.