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

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

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

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

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

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

POST
https://www.api.behsaceram.ir/api/v1/auth/login
ورود با شماره موبایل و رمز عبور
GET
https://www.api.behsaceram.ir/api/v1/auth/me
اطلاعات کاربر احراز هویت‌شده همراه با نقش‌ها و دسترسی‌ها
GET
https://www.api.behsaceram.ir/api/v1/admin/roles
دریافت لیست نقش‌ها و دسترسی‌های قابل انتخاب برای فرم ساخت کاربر در پنل ادمین
POST
https://www.api.behsaceram.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 خوانده می‌شود تا بعداً افزودن نقش یا تغییر سطح دسترسی ساده و متمرکز بماند.