You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.7 KiB
2.7 KiB
Admin Panel Agent Rules & Guidelines - Aqila (پنل مدیریت عقیله)
این سند شامل قوانین، استانداردها و اصول مهندسی الزامی برای توسعه بخش پنل مدیریت ادمین (aqila_panel) است.
۱. استانداردهای توسعه رابط کاربری و معماری
- فناوری و ساختار: پروژه بر پایه Vite + React + TypeScript توسعه یافته است.
- تایپوگرافی و جهت متن (RTL/LTR): رعایت فونت‌های
VazirmatnوPlus Jakarta Sans، استفاده ازrtlUtils.tsجهت تشخیص خودکار جهت متن ورودی کاربران و حفظ ثبات کرسر. - چندزبانه بودن کامل پنل مدیریت (۳ زبان): پنل مدیریت منحصراً از ۳ زبان (
faفارسی،arعربی،enانگلیسی) در مسیرsrc/locales/استفاده می‌کند. تمام متون جدول‌ها، فیلدها، دکمه‌ها و نشان‌ها باید در هر ۳ فایل دیکشنری زبان (fa.json,ar.json,en.json) تعریف و همگام شوند.- قانون هماهنگی ترجمه: هیچ تغییری نباید تک‌زبانه باشد؛ هر کلید جدید یا اصلاح‌شده در یکی از این ۳ زبان باید همزمان در دو زبان دیگر اعمال شود تا تست
locales.test.tsکاملاً پاس شود و هیچ کلید ناقص یا نامتعادلی وجود نداشته باشد.
- قانون هماهنگی ترجمه: هیچ تغییری نباید تک‌زبانه باشد؛ هر کلید جدید یا اصلاح‌شده در یکی از این ۳ زبان باید همزمان در دو زبان دیگر اعمال شود تا تست
۲. بررسی الزامی سلامت و ران بودن پروژه پس از هر تغییر کد (Mandatory Runtime Check)
در انتهای هر پاسخ، تسک یا پیامی که در آن کدی ایجاد یا تغییر داده می‌شود:
- بررسی سریع و بلادرنگ ران بودن پنل مدیریت (Immediate Runtime & Health Check):
- بلافاصله بررسی شود که تغییرات در کامپوننت‌ها، هوک‌ها، تایپ‌ها یا استایل‌ها باعث خطای کامپایل TypeScript، خطای بیلد Vite یا کرش داشبورد نشده باشد.
- سلامت ران بودن با بررسی تایپ‌ها (
npm run typecheck/tsc --noEmit) یا وضعیت سرور Vite تضمین شود.
- رفع فوری مشکل تا بازگشت به وضعیت ران (Self-Healing & Auto-Fix):
- در صورتی که تغییر کد باعث بروز هرگونه خطا، شکست کامپایل یا توقف ران بودن پنل شود، بلافاصله باید منشأ ارور شناسایی و اصلاح گردد تا پنل مدیریت مجدداً در حالت ران، سالم و پایدار قرار گیرد.