diff --git a/.agents/AGENTS.md b/.agents/AGENTS.md new file mode 100644 index 0000000..b8047fc --- /dev/null +++ b/.agents/AGENTS.md @@ -0,0 +1,21 @@ +# 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):** + - در صورتی که تغییر کد باعث بروز هرگونه خطا، شکست کامپایل یا توقف ران بودن پنل شود، بلافاصله باید منشأ ارور شناسایی و اصلاح گردد تا پنل مدیریت مجدداً در حالت ران، سالم و پایدار قرار گیرد. diff --git a/index.html b/index.html index b98bb0c..956f933 100644 --- a/index.html +++ b/index.html @@ -8,6 +8,10 @@ + + + +