chore: add models

docs/models/description.qmd

@@ -0,0 +1,179 @@
+---
+title: "توضیحات مدل‌ها"
+author: "تیم توسعه"
+date: "2025-08-17"
+format: html
+lang: fa
+---
+
+# مدل‌های داده در سامانه تردد و تدارکات
+
+این بخش شامل معرفی مدل‌های داده‌ای مورد استفاده در سامانه است. هر مدل توضیح کوتاهی از کاربرد و جایگاه خود دارد.
+
+### Action
+
+ذخیره لاگ‌ها در سطح Middleware
+
+در آینده احتمالاً به ElasticSearch منتقل خواهد شد
+
+### Category / EquipmentCategory
+
+اشتباه در طراحی اولیه باعث ایجاد دو مدل مشابه شد (هر دو یکی هستند)
+
+برای دسته‌بندی اقلام تدارکات استفاده می‌شوند
+
+### City
+
+مدیریت لیست شهرها
+
+### Comment
+
+ثبت نظر ادمین پایانه‌ها روی درخواست‌ها
+
+### CompanyType
+
+انواع شرکت‌ها
+
+برای کاربران حقوقی استفاده می‌شود
+
+### Cottage
+
+اظهار کوتاژ گمرکی کاربر
+
+اعتبارسنجی از طریق سرویس گمرک انجام می‌شود
+
+در صورت معتبر بودن در این مدل ذخیره می‌گردد
+
+### Country
+
+لیست کشورها
+
+### DangerType
+
+دسته‌بندی کالاها از نظر میزان حساسیت / خطر
+
+### Destination
+
+مشابه City
+
+احتمالاً استفاده نخواهد شد
+
+### Equipment
+
+لیست اقلام تدارکات و تجهیزات
+
+هر آیتم می‌تواند به یک Plate متصل شود
+
+### Gate
+
+لیست دروازه‌های بندر
+
+### GCOMS
+
+سرویس داخلی اداره بندر
+
+ارائه‌دهنده داده‌های کانتینر
+
+### Incident
+
+لیست رخدادها
+
+### LogisticEvent
+
+مدیریت انواع رخدادها و رویدادهای لجستیکی
+
+### Message
+
+پیام‌های نمایشی به کاربران در کارتابل‌ها
+
+### Permission / PermissionGroup
+
+تعریف مجوزها و گروه‌های مجوزها
+
+### Personal
+
+مجوز برای اشخاص (کارکنان)
+
+### PersonalTraffic
+
+مجوز تردد اشخاص عمومی (ارباب‌رجوع‌ها)
+
+### PersonalVehicle
+
+مجوز خودروهای شخصی
+
+### Phonebook
+
+دفترچه تلفن عمومی داخل سامانه
+
+### Plate
+
+لیست پلاک‌های ثبت‌شده توسط کاربر برای درخواست‌ها
+
+### PlateCamera
+
+لیست دوربین‌های پلاک‌خوان
+
+### PomixCamera
+
+اطلاعات ارسال‌شده از دوربین پلاک‌خوان به سامانه تردد
+
+### Port
+
+مدیریت بنادر
+
+### Process
+
+تعریف و مدیریت فرآیندها
+
+(در حال توسعه)
+
+### Province
+
+لیست استان‌ها
+
+(احتمالاً حذف خواهد شد)
+
+### Request
+
+درخواست‌های کاربران شامل واردات، صادرات و سایر موارد
+
+### StoreRoom
+
+مناطق عملیاتی (انبار، اسکله و ...)
+
+### SupervisionDepartment
+
+دستگاه‌های نظارت بر درخواست‌ها
+
+مثال: اداره فاوا، امور بندری
+
+### Template
+
+قالب‌های پیامک
+
+### TemplateUsage
+
+کاربردهای مختلف پیامک‌ها
+
+### TruckFleet
+
+انواع ناوگان (سبک، سنگین و ...)
+
+### TruckTerminal
+
+پایانه‌های حمل (کامیونی و ...)
+
+### UnauthorizedPlate
+
+ترددهای غیرمجاز ثبت‌شده توسط دوربین
+
+### User
+
+مدیریت کاربران سامانه
+
+### Vessel
+
+اطلاعات شناورها
+
+داده‌ها از سامانه IMAS دریافت می‌شوند