# مستندات HT ERP Enterprise Theme

## هدف

این مستندات نحوه استفاده، نگهداری، ارتقا و توسعه Theme را توضیح می‌دهد. اصل اصلی پروژه این است که هیچ فایل متعلق به Bootstrap یا کتابخانه‌های جانبی تغییر نکند.

## ترتیب خواندن

1. `ARCHITECTURE.md`
2. `DESIGN-SYSTEM.md`
3. `VENDOR-MANIFEST.md`
4. `WIDGET-SYSTEM-v1.3.md`
5. `ARCHITECTURE-MAP-v1.3.md`
6. پوشه `libraries/`

## قانون توسعه

- HTML باید از کلاس‌های رسمی کتابخانه‌ها استفاده کند.
- CSS سفارشی باید پس از CSS کتابخانه بارگذاری شود.
- JavaScript سفارشی باید پس از JavaScript کتابخانه بارگذاری شود.
- Overrideها باید در فایل مربوط به خودشان و با کامنت نام کتابخانه ثبت شوند.
- `!important` فقط برای عبور کنترل‌شده از specificity کتابخانه مجاز است.
- هر ارتقای Vendor باید همراه با تست Day/Night، RTL، Responsive و Regression باشد.

## مستندات نسخه ۱.۳

- سیستم ویجت‌های اختصاصی همه ماژول‌ها: `WIDGET-SYSTEM-v1.3.md`
- نقشه ساختار دو مداره و واکنش‌گرا: `ARCHITECTURE-MAP-v1.3.md`
- لایه مقاوم تقویم شمسی: `libraries/persian-datepicker.md`

- ممیزی تجربه کاربری و ظاهر Enterprise: `ENTERPRISE-UX-AUDIT-v1.4.md`