Motoshub · Technical Documentation

اسناد فنی موتوشاب

گزارش‌های معماری و مهاجرت محصول — تهیه‌شده پس از مطالعه‌ی کامل سورس گیت‌وی PHP/Oxwall و پروتوتایپ.

راهنمای فرانت‌اند (شروع از اینجا)

هرچه تیم فرانت لازم دارد در یک صفحه: احراز هویت، قراردادها، صفحه‌بندی، ساختار خطاها، و هر ۲۸۱ endpoint با پارامترها و فیلدهای اجباری.

باز کردن راهنما

Swagger UI زنده (۲۸۱ endpoint)

کل API v1 (همه‌ی فیچرهای موتوشاب) به‌صورت تعاملی — تست مستقیم با Authorize و Try it out، دانلود openapi.json.

باز کردن Swagger

مرجع کامل API v1 + Postman

تمام endpointهای REST جدید (جایگزین گیت‌وی قدیمی mobile/services) با verb درست، سطح دسترسی، بدنه‌ی نمونه، و فایل Postman Collection قابل‌دانلود برای تست.

مشاهده‌ی مرجع

گزارش ساخت API (Build Review)

روند مهاجرت فیچرها به API v1: موج‌ها، فایل‌ها، وضعیت lint، و نکات نیازمند تصمیم.

مشاهده‌ی گزارش

وضعیت، معماری هدف و نقشه‌راه محصول

تصویر بزرگ: وضعیت فعلی، معماری چندمشتری، دیاگرام‌های سیستم و SSO، تنظیمات/Storage، نقشه‌راه ۵ فازی، نسخه‌گذاری و بکاپ.

مشاهده‌ی سند

API نسل جدید (v1) — وضعیت و نقشه‌ی مهاجرت

چه API داریم/نداریم، تمپلیت Bridge (Controller+Request+Resource+Service+Policy)، و نقشه‌ی مهاجرت کامل امکانات به API.

مشاهده‌ی سند

وضعیت تحویل: درخواست‌های ادغام مستقل، مجوزها و تست‌ها

ساختار ۱۰ درخواست ادغامِ مستقل و موازی، خودکفایی مجوز هر پلاگین، مستندسازی خودکار Swagger، و مجموعه‌ی تست Pest برای همه‌ی کنترلرها.

مشاهده‌ی وضعیت

معماری کامل سیستم (محصول، نرم‌افزار، بک‌اند، فرانت، اسکیما)

معماری محصول (Gateway + api1/api2/front)، معماری نرم‌افزار (Oxwall + Bridge + دو ORM)، بک‌اند PHP/Django، فرانت، و اسکیمای کامل ۴۰۷ جدول — با دیاگرام و توضیحات تمیز.

مشاهده‌ی معماری

راهنمای استقرار و عملیات (Ops)

نیازمندی‌های سرور برای هر مشتری، خط‌لوله‌ی استقرار، پایش زنده‌ی مصرف RAM/CPU، استراتژی احراز هویت PHP↔Django، و وضعیت ORM (Eloquent).

مشاهده‌ی راهنما

تسک‌های تیم Front و Backend (به تفکیک)

نقشه‌راهِ ساختِ محصولِ واقعی مطابقِ پروتوتایپ: تسک‌های ریزِ تیم Front (Next.js) و Backend (Django)، وضعیت هر بخش، اولویت، و نگاشتِ صفحه ↔ endpoint — از دلِ سه ریپوی فعلی.

مشاهده‌ی تسک‌ها