سیستم مستندات یکپارچه

IOT - Modules

کاتالوگ ماژول‌ها

در این صفحه هر ماژول فقط به عنوان مسیر فایل نمایش داده نشده است؛ توضیح بیزینسی، نقش فنی، ورودی/خروجی، endpointها و مدل‌های مرتبط نیز بر اساس نام فایل‌ها، controllerها، routeها و schemaهای موجود استخراج شده‌اند.

ModulePathKindFiles
alertsapps/core-backend/src/modules/alertsAPI / Controller3
analyticsapps/core-backend/src/modules/analyticsAPI / Controller4
app.module.tsapps/core-backend/srcکد کاربردی1
auditapps/core-backend/src/modules/auditAPI / Controller2
authapps/core-backend/src/modules/authAPI / Controller9
buildingsapps/core-backend/src/modules/buildingsAPI / Controller3
catalogsapps/core-backend/src/modules/catalogsAPI / Controller3
commonapps/core-backend/src/commonکد کاربردی16
elevatorsapps/core-backend/src/modules/elevatorsAPI / Controller3
envelope.tspackages/shared-contracts/srcکد کاربردی1
eventsapps/core-backend/src/modules/eventsAPI / Controller3
faultsapps/core-backend/src/modules/faultsAPI / Controller3
healthapps/core-backend/src/modules/healthAPI / Controller2
index.tspackages/shared-contracts/srcکد کاربردی1
ingestapps/core-backend/src/modules/ingestکد کاربردی5
localizationapps/core-backend/src/modules/localizationAPI / Controller2
main.tsapps/core-backend/srcکد کاربردی1
ml-insightsapps/core-backend/src/modules/ml-insightsAPI / Controller4
reportsapps/core-backend/src/modules/reportsAPI / Controller3
scriptsscripts/customerکد کاربردی11
service-visitsapps/core-backend/src/modules/service-visitsAPI / Controller3
settingsapps/core-backend/src/modules/settingsAPI / Controller2
simulation-backendapps/simulation-backend/appکد کاربردی14
simulation-controlapps/core-backend/src/modules/simulation-controlAPI / Controller3
techniciansapps/core-backend/src/modules/techniciansAPI / Controller3
telemetryapps/core-backend/src/modules/telemetryAPI / Controller3
tenantsapps/core-backend/src/modules/tenantsAPI / Controller3
ticketsapps/core-backend/src/modules/ticketsAPI / Controller4
typesapps/core-backend/src/typesکد کاربردی1
usersapps/core-backend/src/modules/usersAPI / Controller2
web-frontendapps/web-frontend/app/[locale]/aiکد کاربردی16
websocket-bridgeapps/core-backend/src/modules/websocket-bridgeکد کاربردی3

alerts

توضیح بیزینسی: جریان داده عملیاتی و رخدادهای سلامت یا خرابی را دریافت، نرمال‌سازی و برای تصمیم‌گیری آماده می‌کند.

توضیح فنی: مرز اصلی ingest است؛ schema، idempotency و backpressure در این قسمت اهمیت بالایی دارند. در اسکن فعلی 4 endpoint، 0 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/alerts
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /alerts - AlertsController.list
  • POST /alerts - AlertsController.create
  • PATCH /alerts/:alertId/ack - AlertsController.acknowledge
  • PATCH /alerts/:alertId/resolve - AlertsController.resolve

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/alerts/alerts.controller.ts
  • apps/core-backend/src/modules/alerts/alerts.module.ts
  • apps/core-backend/src/modules/alerts/alerts.service.ts

analytics

توضیح بیزینسی: داده‌های پراکنده سیستم را به شاخص، گزارش و نمای تصمیم‌گیری تبدیل می‌کند.

توضیح فنی: معمولاً مصرف‌کننده چندین service/model است و باید از queryهای سنگین، cache و صحت aggregation مراقبت شود. در اسکن فعلی 4 endpoint، 0 مدل و 4 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/analytics
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /analytics/fleet-summary - AnalyticsController.fleetSummary
  • GET /analytics/building-risk - AnalyticsController.buildingRisk
  • GET /analytics/elevator/:elevatorId - AnalyticsController.elevatorInsights
  • GET /analytics/health-history - AnalyticsController.healthHistory

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/analytics/analytics.controller.ts
  • apps/core-backend/src/modules/analytics/analytics.load.spec.ts
  • apps/core-backend/src/modules/analytics/analytics.module.ts
  • apps/core-backend/src/modules/analytics/analytics.service.ts

app.module.ts

توضیح بیزینسی: زیرساخت مشترک، تنظیمات، helperها یا قراردادهای عمومی پروژه را فراهم می‌کند.

توضیح فنی: تغییرات این بخش blast radius بالایی دارد و باید با تست‌های regression همراه باشد. در اسکن فعلی 0 endpoint، 0 مدل و 1 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src
نوع غالبکد کاربردی
ورودی‌هاservice call داخلی، import از ماژول‌های دیگر یا داده محلی
خروجی‌هاخروجی helper/component/contract؛ نیازمند بررسی مصرف‌کننده‌ها
نکته نگهداریendpoint یا مدل مستقیمی برای این ماژول پیدا نشد؛ ممکن است نقش آن UI، helper، contract یا orchestration داخلی باشد.

Endpointهای مرتبط

  • Endpoint مستقیمی پیدا نشد.

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/app.module.ts

audit

توضیح بیزینسی: زیرساخت مشترک، تنظیمات، helperها یا قراردادهای عمومی پروژه را فراهم می‌کند.

توضیح فنی: تغییرات این بخش blast radius بالایی دارد و باید با تست‌های regression همراه باشد. در اسکن فعلی 1 endpoint، 3 مدل و 2 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/audit
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریبرای توسعه، ابتدا فایل‌های controller/view، سپس service و در نهایت مدل‌ها یا DTOهای مرتبط بررسی شوند.

Endpointهای مرتبط

  • GET /audit - AuditController.list

مدل‌های مرتبط

  • AuditRecord - Prisma model
  • AuditRecord - Prisma model
  • AuditRecord - DTO / Schema

منابع کد

  • apps/core-backend/src/modules/audit/audit.controller.ts
  • apps/core-backend/src/modules/audit/audit.module.ts

auth

توضیح بیزینسی: مسئول احراز هویت، صدور یا اعتبارسنجی نشست کاربر و آماده‌سازی context امنیتی درخواست‌ها است.

توضیح فنی: مرکز کنترل ورود، token/session، guard یا permission check است و باید با policyهای امنیتی پروژه هماهنگ بماند. در اسکن فعلی 3 endpoint، 1 مدل و 9 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/auth
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریبرای توسعه، ابتدا فایل‌های controller/view، سپس service و در نهایت مدل‌ها یا DTOهای مرتبط بررسی شوند.

Endpointهای مرتبط

  • POST /auth/login - AuthController.login
  • POST /auth/refresh - AuthController.refresh
  • POST /auth/impersonate/elevator/:elevatorId - AuthController.impersonateElevator

مدل‌های مرتبط

  • AuthTokenPayload - DTO / Schema

منابع کد

  • apps/core-backend/src/modules/auth/auth.controller.ts
  • apps/core-backend/src/modules/auth/auth.module.ts
  • apps/core-backend/src/modules/auth/auth.service.ts
  • apps/core-backend/src/modules/auth/auth.types.ts
  • apps/core-backend/src/modules/auth/current-user.decorator.ts
  • apps/core-backend/src/modules/auth/jwt-auth.guard.ts
  • apps/core-backend/src/modules/auth/public.decorator.ts
  • apps/core-backend/src/modules/auth/roles.decorator.ts
  • apps/core-backend/src/modules/auth/roles.guard.ts

buildings

توضیح بیزینسی: فرایند پیگیری عملیات، ارجاع کار و ثبت نتیجه میدانی را پشتیبانی می‌کند.

توضیح فنی: این ماژول معمولاً با alert/fault/report ارتباط دارد و وضعیت‌ها باید قابل audit باشند. در اسکن فعلی 4 endpoint، 0 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/buildings
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /buildings - BuildingsController.list
  • GET /buildings/facets - BuildingsController.facets
  • GET /buildings/:buildingId - BuildingsController.getById
  • POST /buildings - BuildingsController.create

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/buildings/buildings.controller.ts
  • apps/core-backend/src/modules/buildings/buildings.module.ts
  • apps/core-backend/src/modules/buildings/buildings.service.ts

catalogs

توضیح بیزینسی: فرایند پیگیری عملیات، ارجاع کار و ثبت نتیجه میدانی را پشتیبانی می‌کند.

توضیح فنی: این ماژول معمولاً با alert/fault/report ارتباط دارد و وضعیت‌ها باید قابل audit باشند. در اسکن فعلی 3 endpoint، 0 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/catalogs
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /catalogs/simulation-profiles - CatalogsController.simulationProfiles
  • GET /catalogs/faults - CatalogsController.faultCatalog
  • GET /catalogs/events - CatalogsController.eventCatalog

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/catalogs/catalogs.controller.ts
  • apps/core-backend/src/modules/catalogs/catalogs.module.ts
  • apps/core-backend/src/modules/catalogs/catalogs.service.ts

common

توضیح بیزینسی: مرز کنترل دسترسی، نقش‌ها، tenant یا قابلیت‌های مجاز محصول را تعریف می‌کند.

توضیح فنی: این ماژول باید با تست‌های authorization و داده seed/metadata همگام باشد. در اسکن فعلی 0 endpoint، 18 مدل و 16 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/common
نوع غالبکد کاربردی
ورودی‌هاservice call داخلی، import از ماژول‌های دیگر یا داده محلی
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریمدل داده مرتبط وجود دارد ولی route مستقیم پیدا نشد؛ احتمالاً مدل توسط ماژول‌های دیگر، jobها یا سرویس داخلی مصرف می‌شود.

Endpointهای مرتبط

  • Endpoint مستقیمی پیدا نشد.

مدل‌های مرتبط

  • TenantRecord - DTO / Schema
  • UserRecord - DTO / Schema
  • BuildingRecord - DTO / Schema
  • ElevatorRecord - DTO / Schema
  • TelemetryRecord - DTO / Schema
  • EventRecord - DTO / Schema
  • FaultRecord - DTO / Schema
  • HealthSnapshotRecord - DTO / Schema

منابع کد

  • apps/core-backend/src/common/access.ts
  • apps/core-backend/src/common/common.module.ts
  • apps/core-backend/src/common/customer-bootstrap.ts
  • apps/core-backend/src/common/data-store.service.spec.ts
  • apps/core-backend/src/common/data-store.service.ts
  • apps/core-backend/src/common/id.ts
  • apps/core-backend/src/common/legacy-sql-store.service.ts
  • apps/core-backend/src/common/list-query.spec.ts
  • apps/core-backend/src/common/list-query.ts
  • apps/core-backend/src/common/password.spec.ts
  • apps/core-backend/src/common/password.ts
  • apps/core-backend/src/common/realtime-bus.service.ts

elevators

توضیح بیزینسی: فرایند پیگیری عملیات، ارجاع کار و ثبت نتیجه میدانی را پشتیبانی می‌کند.

توضیح فنی: این ماژول معمولاً با alert/fault/report ارتباط دارد و وضعیت‌ها باید قابل audit باشند. در اسکن فعلی 4 endpoint، 0 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/elevators
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /elevators - ElevatorsController.list
  • GET /elevators/facets - ElevatorsController.facets
  • GET /elevators/:elevatorId - ElevatorsController.getById
  • POST /elevators - ElevatorsController.create

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/elevators/elevators.controller.ts
  • apps/core-backend/src/modules/elevators/elevators.module.ts
  • apps/core-backend/src/modules/elevators/elevators.service.ts

envelope.ts

توضیح بیزینسی: این ماژول یک بخش کاربردی مستقل در پروژه است و از روی ساختار فایل‌ها به عنوان مرز منطقی برای قابلیت‌های مرتبط شناسایی شده است.

توضیح فنی: از نظر فنی شامل 1 فایل کلیدی است و در خروجی اسکن، 0 endpoint و 0 مدل داده مرتبط با آن پیدا شد.

مسیر ماژولpackages/shared-contracts/src
نوع غالبکد کاربردی
ورودی‌هاservice call داخلی، import از ماژول‌های دیگر یا داده محلی
خروجی‌هاخروجی helper/component/contract؛ نیازمند بررسی مصرف‌کننده‌ها
نکته نگهداریendpoint یا مدل مستقیمی برای این ماژول پیدا نشد؛ ممکن است نقش آن UI، helper، contract یا orchestration داخلی باشد.

Endpointهای مرتبط

  • Endpoint مستقیمی پیدا نشد.

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • packages/shared-contracts/src/envelope.ts

events

توضیح بیزینسی: جریان داده عملیاتی و رخدادهای سلامت یا خرابی را دریافت، نرمال‌سازی و برای تصمیم‌گیری آماده می‌کند.

توضیح فنی: مرز اصلی ingest است؛ schema، idempotency و backpressure در این قسمت اهمیت بالایی دارند. در اسکن فعلی 1 endpoint، 0 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/events
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /events - EventsController.list

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/events/events.controller.ts
  • apps/core-backend/src/modules/events/events.module.ts
  • apps/core-backend/src/modules/events/events.service.ts

faults

توضیح بیزینسی: جریان داده عملیاتی و رخدادهای سلامت یا خرابی را دریافت، نرمال‌سازی و برای تصمیم‌گیری آماده می‌کند.

توضیح فنی: مرز اصلی ingest است؛ schema، idempotency و backpressure در این قسمت اهمیت بالایی دارند. در اسکن فعلی 1 endpoint، 0 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/faults
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /faults - FaultsController.list

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/faults/faults.controller.ts
  • apps/core-backend/src/modules/faults/faults.module.ts
  • apps/core-backend/src/modules/faults/faults.service.ts

health

توضیح بیزینسی: زیرساخت مشترک، تنظیمات، helperها یا قراردادهای عمومی پروژه را فراهم می‌کند.

توضیح فنی: تغییرات این بخش blast radius بالایی دارد و باید با تست‌های regression همراه باشد. در اسکن فعلی 1 endpoint، 1 مدل و 2 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/health
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریبرای توسعه، ابتدا فایل‌های controller/view، سپس service و در نهایت مدل‌ها یا DTOهای مرتبط بررسی شوند.

Endpointهای مرتبط

  • GET /health - HealthController.getHealth

مدل‌های مرتبط

  • HealthSnapshotRecord - DTO / Schema

منابع کد

  • apps/core-backend/src/modules/health/health.controller.ts
  • apps/core-backend/src/modules/health/health.module.ts

index.ts

توضیح بیزینسی: این ماژول یک بخش کاربردی مستقل در پروژه است و از روی ساختار فایل‌ها به عنوان مرز منطقی برای قابلیت‌های مرتبط شناسایی شده است.

توضیح فنی: از نظر فنی شامل 1 فایل کلیدی است و در خروجی اسکن، 0 endpoint و 0 مدل داده مرتبط با آن پیدا شد.

مسیر ماژولpackages/shared-contracts/src
نوع غالبکد کاربردی
ورودی‌هاservice call داخلی، import از ماژول‌های دیگر یا داده محلی
خروجی‌هاخروجی helper/component/contract؛ نیازمند بررسی مصرف‌کننده‌ها
نکته نگهداریendpoint یا مدل مستقیمی برای این ماژول پیدا نشد؛ ممکن است نقش آن UI، helper، contract یا orchestration داخلی باشد.

Endpointهای مرتبط

  • Endpoint مستقیمی پیدا نشد.

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • packages/shared-contracts/src/index.ts

ingest

توضیح بیزینسی: جریان داده عملیاتی و رخدادهای سلامت یا خرابی را دریافت، نرمال‌سازی و برای تصمیم‌گیری آماده می‌کند.

توضیح فنی: مرز اصلی ingest است؛ schema، idempotency و backpressure در این قسمت اهمیت بالایی دارند. در اسکن فعلی 0 endpoint، 0 مدل و 5 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/ingest
نوع غالبکد کاربردی
ورودی‌هاservice call داخلی، import از ماژول‌های دیگر یا داده محلی
خروجی‌هاخروجی helper/component/contract؛ نیازمند بررسی مصرف‌کننده‌ها
نکته نگهداریendpoint یا مدل مستقیمی برای این ماژول پیدا نشد؛ ممکن است نقش آن UI، helper، contract یا orchestration داخلی باشد.

Endpointهای مرتبط

  • Endpoint مستقیمی پیدا نشد.

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/ingest/ingest.module.ts
  • apps/core-backend/src/modules/ingest/ingest.service.ts
  • apps/core-backend/src/modules/ingest/ingest.source-real.spec.ts
  • apps/core-backend/src/modules/ingest/live-ingest-replay.service.spec.ts
  • apps/core-backend/src/modules/ingest/live-ingest-replay.service.ts

localization

توضیح بیزینسی: زیرساخت مشترک، تنظیمات، helperها یا قراردادهای عمومی پروژه را فراهم می‌کند.

توضیح فنی: تغییرات این بخش blast radius بالایی دارد و باید با تست‌های regression همراه باشد. در اسکن فعلی 2 endpoint، 0 مدل و 2 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/localization
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /localization/preference - LocalizationController.getPreference
  • PATCH /localization/preference - LocalizationController.updatePreference

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/localization/localization.controller.ts
  • apps/core-backend/src/modules/localization/localization.module.ts

main.ts

توضیح بیزینسی: زیرساخت مشترک، تنظیمات، helperها یا قراردادهای عمومی پروژه را فراهم می‌کند.

توضیح فنی: تغییرات این بخش blast radius بالایی دارد و باید با تست‌های regression همراه باشد. در اسکن فعلی 0 endpoint، 0 مدل و 1 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src
نوع غالبکد کاربردی
ورودی‌هاservice call داخلی، import از ماژول‌های دیگر یا داده محلی
خروجی‌هاخروجی helper/component/contract؛ نیازمند بررسی مصرف‌کننده‌ها
نکته نگهداریendpoint یا مدل مستقیمی برای این ماژول پیدا نشد؛ ممکن است نقش آن UI، helper، contract یا orchestration داخلی باشد.

Endpointهای مرتبط

  • Endpoint مستقیمی پیدا نشد.

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/main.ts

ml-insights

توضیح بیزینسی: فرایند پیگیری عملیات، ارجاع کار و ثبت نتیجه میدانی را پشتیبانی می‌کند.

توضیح فنی: این ماژول معمولاً با alert/fault/report ارتباط دارد و وضعیت‌ها باید قابل audit باشند. در اسکن فعلی 11 endpoint، 0 مدل و 4 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/ml-insights
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /ml-insights/model-status - MlInsightsController.modelStatus
  • GET /ml-insights/anomaly/:elevatorId - MlInsightsController.anomalyScore
  • GET /ml-insights/fault-probability/:elevatorId - MlInsightsController.faultProbability
  • GET /ml-insights/rul/:elevatorId - MlInsightsController.rulEstimate
  • GET /ml-insights/root-cause/:elevatorId - MlInsightsController.rootCause
  • GET /ml-insights/maintenance-priority - MlInsightsController.maintenancePriority
  • GET /ml-insights/fleet-kpi - MlInsightsController.fleetKpi
  • GET /ml-insights/scenario-tuning/:elevatorId - MlInsightsController.scenarioTuning

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/ml-insights/ml-insights.controller.ts
  • apps/core-backend/src/modules/ml-insights/ml-insights.module.ts
  • apps/core-backend/src/modules/ml-insights/ml-insights.service.spec.ts
  • apps/core-backend/src/modules/ml-insights/ml-insights.service.ts

reports

توضیح بیزینسی: داده‌های پراکنده سیستم را به شاخص، گزارش و نمای تصمیم‌گیری تبدیل می‌کند.

توضیح فنی: معمولاً مصرف‌کننده چندین service/model است و باید از queryهای سنگین، cache و صحت aggregation مراقبت شود. در اسکن فعلی 4 endpoint، 0 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/reports
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /reports/fleet-kpi - ReportsController.fleetKpi
  • GET /reports/exports - ReportsController.listExports
  • POST /reports/exports - ReportsController.createExport
  • GET /reports/exports/:exportId/download - ReportsController.downloadExport

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/reports/reports.controller.ts
  • apps/core-backend/src/modules/reports/reports.module.ts
  • apps/core-backend/src/modules/reports/reports.service.ts

scripts

توضیح بیزینسی: جریان داده عملیاتی و رخدادهای سلامت یا خرابی را دریافت، نرمال‌سازی و برای تصمیم‌گیری آماده می‌کند.

توضیح فنی: مرز اصلی ingest است؛ schema، idempotency و backpressure در این قسمت اهمیت بالایی دارند. در اسکن فعلی 0 endpoint، 0 مدل و 11 فایل مرتبط ثبت شده است.

مسیر ماژولscripts/customer
نوع غالبکد کاربردی
ورودی‌هاservice call داخلی، import از ماژول‌های دیگر یا داده محلی
خروجی‌هاخروجی helper/component/contract؛ نیازمند بررسی مصرف‌کننده‌ها
نکته نگهداریendpoint یا مدل مستقیمی برای این ماژول پیدا نشد؛ ممکن است نقش آن UI، helper، contract یا orchestration داخلی باشد.

Endpointهای مرتبط

  • Endpoint مستقیمی پیدا نشد.

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • scripts/customer/extract-excels.py
  • scripts/customer/import-derived.ts
  • scripts/historical/build_canonical_historical.py
  • scripts/historical/build_mapping_plan.py
  • scripts/historical/build_source_master.py
  • scripts/historical/dry_run_transform.py
  • scripts/historical/export_assets_from_postgres.py
  • scripts/historical/sync_assets_from_source_master.py
  • scripts/historical/train_anomaly_baseline.py
  • scripts/historical/train_fault_baseline.py
  • scripts/seed/seed-demo.ts

service-visits

توضیح بیزینسی: فرایند پیگیری عملیات، ارجاع کار و ثبت نتیجه میدانی را پشتیبانی می‌کند.

توضیح فنی: این ماژول معمولاً با alert/fault/report ارتباط دارد و وضعیت‌ها باید قابل audit باشند. در اسکن فعلی 2 endpoint، 0 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/service-visits
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /service-visits - ServiceVisitsController.list
  • POST /service-visits - ServiceVisitsController.create

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/service-visits/service-visits.controller.ts
  • apps/core-backend/src/modules/service-visits/service-visits.module.ts
  • apps/core-backend/src/modules/service-visits/service-visits.service.ts

settings

توضیح بیزینسی: زیرساخت مشترک، تنظیمات، helperها یا قراردادهای عمومی پروژه را فراهم می‌کند.

توضیح فنی: تغییرات این بخش blast radius بالایی دارد و باید با تست‌های regression همراه باشد. در اسکن فعلی 2 endpoint، 0 مدل و 2 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/settings
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /settings - SettingsController.getSettings
  • PATCH /settings - SettingsController.updateSettings

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/settings/settings.controller.ts
  • apps/core-backend/src/modules/settings/settings.module.ts

simulation-backend

توضیح بیزینسی: مدیریت کاربران، پروفایل، نقش‌ها یا اطلاعات فردی را پوشش می‌دهد.

توضیح فنی: معمولاً به auth، permission و مدل‌های کاربر وابسته است و تغییرات آن روی دسترسی و تجربه کاربر اثر مستقیم دارد. در اسکن فعلی 17 endpoint، 0 مدل و 14 فایل مرتبط ثبت شده است.

مسیر ماژولapps/simulation-backend/app
نوع غالبکد کاربردی
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /api/v1/scenarios - list_scenarios
  • GET /api/v1/simulation/state - simulation_state
  • POST /api/v1/simulation/start - simulation_start
  • POST /api/v1/simulation/stop - simulation_stop
  • POST /api/v1/simulation/pause - simulation_pause
  • POST /api/v1/simulation/resume - simulation_resume
  • POST /api/v1/simulation/fleet/reload - simulation_reload_fleet
  • PATCH /api/v1/simulation/rate - simulation_rate

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/simulation-backend/app/__init__.py
  • apps/simulation-backend/app/api/__init__.py
  • apps/simulation-backend/app/api/routes.py
  • apps/simulation-backend/app/core/__init__.py
  • apps/simulation-backend/app/core/settings.py
  • apps/simulation-backend/app/main.py
  • apps/simulation-backend/app/simulation/__init__.py
  • apps/simulation-backend/app/simulation/bridge.py
  • apps/simulation-backend/app/simulation/contracts.py
  • apps/simulation-backend/app/simulation/engine.py
  • apps/simulation-backend/app/simulation/manager.py
  • apps/simulation-backend/app/simulation/metadata.py

simulation-control

توضیح بیزینسی: فرایند پیگیری عملیات، ارجاع کار و ثبت نتیجه میدانی را پشتیبانی می‌کند.

توضیح فنی: این ماژول معمولاً با alert/fault/report ارتباط دارد و وضعیت‌ها باید قابل audit باشند. در اسکن فعلی 16 endpoint، 0 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/simulation-control
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /simulation-control/state - SimulationControlController.state
  • GET /simulation-control/scenarios - SimulationControlController.scenarios
  • GET /simulation-control/overrides - SimulationControlController.overrides
  • GET /simulation-control/logs - SimulationControlController.logs
  • GET /simulation-control/replay - SimulationControlController.replay
  • PATCH /simulation-control/state - SimulationControlController.updateState
  • POST /simulation-control/start - SimulationControlController.start
  • POST /simulation-control/pause - SimulationControlController.pause

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/simulation-control/simulation-control.controller.ts
  • apps/core-backend/src/modules/simulation-control/simulation-control.module.ts
  • apps/core-backend/src/modules/simulation-control/simulation-control.service.ts

technicians

توضیح بیزینسی: فرایند پیگیری عملیات، ارجاع کار و ثبت نتیجه میدانی را پشتیبانی می‌کند.

توضیح فنی: این ماژول معمولاً با alert/fault/report ارتباط دارد و وضعیت‌ها باید قابل audit باشند. در اسکن فعلی 2 endpoint، 0 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/technicians
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /technicians - TechniciansController.list
  • POST /technicians - TechniciansController.create

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/technicians/technicians.controller.ts
  • apps/core-backend/src/modules/technicians/technicians.module.ts
  • apps/core-backend/src/modules/technicians/technicians.service.ts

telemetry

توضیح بیزینسی: جریان داده عملیاتی و رخدادهای سلامت یا خرابی را دریافت، نرمال‌سازی و برای تصمیم‌گیری آماده می‌کند.

توضیح فنی: مرز اصلی ingest است؛ schema، idempotency و backpressure در این قسمت اهمیت بالایی دارند. در اسکن فعلی 2 endpoint، 1 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/telemetry
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریبرای توسعه، ابتدا فایل‌های controller/view، سپس service و در نهایت مدل‌ها یا DTOهای مرتبط بررسی شوند.

Endpointهای مرتبط

  • GET /telemetry - TelemetryController.list
  • GET /telemetry/latest/:elevatorId - TelemetryController.latestByElevator

مدل‌های مرتبط

  • TelemetryRecord - DTO / Schema

منابع کد

  • apps/core-backend/src/modules/telemetry/telemetry.controller.ts
  • apps/core-backend/src/modules/telemetry/telemetry.module.ts
  • apps/core-backend/src/modules/telemetry/telemetry.service.ts

tenants

توضیح بیزینسی: مرز کنترل دسترسی، نقش‌ها، tenant یا قابلیت‌های مجاز محصول را تعریف می‌کند.

توضیح فنی: این ماژول باید با تست‌های authorization و داده seed/metadata همگام باشد. در اسکن فعلی 2 endpoint، 0 مدل و 3 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/tenants
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /tenants - TenantsController.list
  • POST /tenants - TenantsController.create

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/tenants/tenants.controller.ts
  • apps/core-backend/src/modules/tenants/tenants.module.ts
  • apps/core-backend/src/modules/tenants/tenants.service.ts

tickets

توضیح بیزینسی: فرایند پیگیری عملیات، ارجاع کار و ثبت نتیجه میدانی را پشتیبانی می‌کند.

توضیح فنی: این ماژول معمولاً با alert/fault/report ارتباط دارد و وضعیت‌ها باید قابل audit باشند. در اسکن فعلی 4 endpoint، 0 مدل و 4 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/tickets
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /tickets - TicketsController.list
  • POST /tickets - TicketsController.create
  • PATCH /tickets/:ticketId/assign - TicketsController.assign
  • PATCH /tickets/:ticketId/resolve - TicketsController.resolve

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/tickets/tickets.controller.ts
  • apps/core-backend/src/modules/tickets/tickets.module.ts
  • apps/core-backend/src/modules/tickets/tickets.service.spec.ts
  • apps/core-backend/src/modules/tickets/tickets.service.ts

types

توضیح بیزینسی: زیرساخت مشترک، تنظیمات، helperها یا قراردادهای عمومی پروژه را فراهم می‌کند.

توضیح فنی: تغییرات این بخش blast radius بالایی دارد و باید با تست‌های regression همراه باشد. در اسکن فعلی 0 endpoint، 19 مدل و 1 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/types
نوع غالبکد کاربردی
ورودی‌هاservice call داخلی، import از ماژول‌های دیگر یا داده محلی
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریمدل داده مرتبط وجود دارد ولی route مستقیم پیدا نشد؛ احتمالاً مدل توسط ماژول‌های دیگر، jobها یا سرویس داخلی مصرف می‌شود.

Endpointهای مرتبط

  • Endpoint مستقیمی پیدا نشد.

مدل‌های مرتبط

  • TenantRecord - DTO / Schema
  • UserRecord - DTO / Schema
  • BuildingRecord - DTO / Schema
  • ElevatorRecord - DTO / Schema
  • TelemetryRecord - DTO / Schema
  • EventRecord - DTO / Schema
  • FaultRecord - DTO / Schema
  • HealthSnapshotRecord - DTO / Schema

منابع کد

  • apps/core-backend/src/types/pg.d.ts

users

توضیح بیزینسی: مدیریت کاربران، پروفایل، نقش‌ها یا اطلاعات فردی را پوشش می‌دهد.

توضیح فنی: معمولاً به auth، permission و مدل‌های کاربر وابسته است و تغییرات آن روی دسترسی و تجربه کاربر اثر مستقیم دارد. در اسکن فعلی 2 endpoint، 0 مدل و 2 فایل مرتبط ثبت شده است.

مسیر ماژولapps/core-backend/src/modules/users
نوع غالبAPI / Controller
ورودی‌هاHTTP/API، فرم UI، job/scheduler یا service call داخلی بر اساس فایل‌های موجود
خروجی‌هاresponse API، رکورد پایگاه داده، رخداد audit/notification یا state قابل نمایش
نکته نگهداریاین ماژول سطح API فعال دارد، اما مدل داده مستقیم برای آن پیدا نشد؛ DTOها، سرویس‌ها و وابستگی‌های داخلی باید هنگام تغییر بررسی شوند.

Endpointهای مرتبط

  • GET /users - UsersController.list
  • GET /users/me - UsersController.me

مدل‌های مرتبط

  • مدل داده مستقیمی پیدا نشد.

منابع کد

  • apps/core-backend/src/modules/users/users.controller.ts
  • apps/core-backend/src/modules/users/users.module.ts