# evansjean345/my_sis_back architecture

> Architecture diagram of the GitHub repository evansjean345/my_sis_back, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/evansjean345/my_sis_back
- Repository: https://github.com/evansjean345/my_sis_back

## Overview

SISBM CORE is a GPS fleet-tracking and supervision platform. Its visible runtime paths include authenticated fleet, identity, and immobilization APIs, plus a separate Flespi MQTT ingestion worker that parses frames and invokes telemetry ingestion. Security commands support request, validation, dispatch, and engine restoration; fleet and identity management and audit are additional product branches. The README describes PostgreSQL/PostGIS and Redis infrastructure. Unsampled modules are represented where the tree establishes their role, but links are omitted unless the excerpts or README support them.

Main entry points: [`start/routes.ts`](https://github.com/evansjean345/my_sis_back/blob/main/start/routes.ts) (HTTP Routes), [`app/presentation/http/controllers/security/immobilization_controller.ts`](https://github.com/evansjean345/my_sis_back/blob/main/app/presentation/http/controllers/security/immobilization_controller.ts) (Immobilization API), [`commands/ingest.ts`](https://github.com/evansjean345/my_sis_back/blob/main/commands/ingest.ts) (Ingest Worker), [`app/infrastructure/persistence`](https://github.com/evansjean345/my_sis_back/tree/main/app/infrastructure/persistence) (Persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_http_routes["HTTP Routes<br/>[routes.ts]"]
  node_fleet_controllers["Fleet Controllers"]
  node_identity_controllers["Identity Controllers"]
  node_security_controller["Immobilization API"]
  node_audit_controller["Audit API"]
end

subgraph group_domain["Application Domains"]
  node_identity_domain["Identity Management"]
  node_fleet_domain["Fleet Management"]
  node_security_request["Command Requests"]
  node_security_validate["Command Validation"]
  node_security_dispatch["Command Dispatch"]
  node_security_restore["Engine Restore"]
  node_command_entity["Device Commands<br/>[device_command.ts]"]
  node_telemetry_domain["Telemetry Domain"]
end

subgraph group_ingestion["Telemetry Ingestion"]
  node_telemetry_ingest["Frame Ingestion"]
  node_frame_parser["Frame Parser"]
  node_mqtt_transport["MQTT Transport<br/>[mqtt_transport.ts]"]
  node_ingest_worker["Ingest Worker<br/>[ingest.ts]"]
end

subgraph group_infrastructure["Infrastructure"]
  node_flespi_gateway["Flespi Gateways"]
  node_persistence["Persistence"]
  node_database_schema["Database Schema<br/>[schema.ts]"]
  node_audit["Audit Logging<br/>[audit_logger.ts]"]
end

node_fleet_user(("Fleet Operator"))
node_postgres[("PostgreSQL + PostGIS")]
node_redis[("Redis")]
node_flespi{{"Flespi"}}

node_fleet_user -->|"sends requests"| node_http_routes
node_http_routes -->|"routes fleet"| node_fleet_controllers
node_http_routes -->|"routes identity"| node_identity_controllers
node_http_routes -.->|"routes security"| node_security_controller
node_http_routes -->|"routes audit"| node_audit_controller
node_security_controller -->|"executes request"| node_security_request
node_security_controller -->|"executes validation"| node_security_validate
node_security_controller -->|"executes dispatch"| node_security_dispatch
node_security_controller -->|"executes restore"| node_security_restore
node_security_request -.->|"creates commands"| node_command_entity
node_security_dispatch -.->|"sends commands"| node_flespi_gateway
node_ingest_worker -->|"subscribes to"| node_mqtt_transport
node_ingest_worker -->|"parses frames"| node_frame_parser
node_ingest_worker -->|"invokes ingestion"| node_telemetry_ingest
node_mqtt_transport -.->|"receives messages"| node_flespi
node_telemetry_ingest -.->|"processes readings"| node_telemetry_domain
node_fleet_controllers -->|"queries devices"| node_flespi_gateway
node_database_schema -.->|"defines schema"| node_postgres
node_persistence -.->|"stores data"| node_postgres
node_persistence -.->|"uses cache"| node_redis
node_audit_controller -.->|"reads audit"| node_audit

click node_http_routes "https://github.com/evansjean345/my_sis_back/blob/main/start/routes.ts"
click node_fleet_controllers "https://github.com/evansjean345/my_sis_back/tree/main/app/presentation/http/controllers/fleet"
click node_identity_controllers "https://github.com/evansjean345/my_sis_back/tree/main/app/presentation/http/controllers/identity"
click node_security_controller "https://github.com/evansjean345/my_sis_back/blob/main/app/presentation/http/controllers/security/immobilization_controller.ts"
click node_audit_controller "https://github.com/evansjean345/my_sis_back/blob/main/app/presentation/http/controllers/audit/audit_log_controller.ts"
click node_identity_domain "https://github.com/evansjean345/my_sis_back/tree/main/app/application/identity"
click node_fleet_domain "https://github.com/evansjean345/my_sis_back/tree/main/app/application/fleet"
click node_security_request "https://github.com/evansjean345/my_sis_back/blob/main/app/application/security/use_cases/request_immobilization.ts"
click node_security_validate "https://github.com/evansjean345/my_sis_back/blob/main/app/application/security/use_cases/validate_immobilization.ts"
click node_security_dispatch "https://github.com/evansjean345/my_sis_back/blob/main/app/application/security/use_cases/dispatch_engine_command.ts"
click node_security_restore "https://github.com/evansjean345/my_sis_back/blob/main/app/application/security/use_cases/request_engine_restore.ts"
click node_command_entity "https://github.com/evansjean345/my_sis_back/blob/main/app/domain/security/entities/device_command.ts"
click node_telemetry_ingest "https://github.com/evansjean345/my_sis_back/blob/main/app/application/telemetry/use_cases/ingest_telemetry_frames.ts"
click node_frame_parser "https://github.com/evansjean345/my_sis_back/blob/main/app/infrastructure/gateways/flespi/flespi_frame_parser.ts"
click node_mqtt_transport "https://github.com/evansjean345/my_sis_back/blob/main/app/infrastructure/gateways/flespi/mqtt_transport.ts"
click node_ingest_worker "https://github.com/evansjean345/my_sis_back/blob/main/commands/ingest.ts"
click node_telemetry_domain "https://github.com/evansjean345/my_sis_back/tree/main/app/domain/telemetry"
click node_flespi_gateway "https://github.com/evansjean345/my_sis_back/tree/main/app/infrastructure/gateways/flespi"
click node_persistence "https://github.com/evansjean345/my_sis_back/tree/main/app/infrastructure/persistence"
click node_database_schema "https://github.com/evansjean345/my_sis_back/blob/main/database/schema.ts"
click node_audit "https://github.com/evansjean345/my_sis_back/blob/main/app/infrastructure/persistence/audit_logger.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_http_routes,node_fleet_controllers,node_identity_controllers,node_security_controller,node_audit_controller toneBlue
class node_identity_domain,node_fleet_domain,node_security_request,node_security_validate,node_security_dispatch,node_security_restore,node_command_entity,node_telemetry_domain,node_postgres,node_redis toneAmber
class node_telemetry_ingest,node_frame_parser,node_mqtt_transport,node_ingest_worker toneMint
class node_flespi_gateway,node_persistence,node_database_schema,node_audit toneRose
class node_fleet_user,node_flespi toneIndigo
```

## Components

### HTTP API

- [HTTP Routes](https://github.com/evansjean345/my_sis_back/blob/main/start/routes.ts): `start/routes.ts`
- [Fleet Controllers](https://github.com/evansjean345/my_sis_back/tree/main/app/presentation/http/controllers/fleet): `app/presentation/http/controllers/fleet`
- [Identity Controllers](https://github.com/evansjean345/my_sis_back/tree/main/app/presentation/http/controllers/identity): `app/presentation/http/controllers/identity`
- [Immobilization API](https://github.com/evansjean345/my_sis_back/blob/main/app/presentation/http/controllers/security/immobilization_controller.ts): `app/presentation/http/controllers/security/immobilization_controller.ts`
- [Audit API](https://github.com/evansjean345/my_sis_back/blob/main/app/presentation/http/controllers/audit/audit_log_controller.ts): `app/presentation/http/controllers/audit/audit_log_controller.ts`

### Application Domains

- [Identity Management](https://github.com/evansjean345/my_sis_back/tree/main/app/application/identity): `app/application/identity`
- [Fleet Management](https://github.com/evansjean345/my_sis_back/tree/main/app/application/fleet): `app/application/fleet`
- [Command Requests](https://github.com/evansjean345/my_sis_back/blob/main/app/application/security/use_cases/request_immobilization.ts): `app/application/security/use_cases/request_immobilization.ts`
- [Command Validation](https://github.com/evansjean345/my_sis_back/blob/main/app/application/security/use_cases/validate_immobilization.ts): `app/application/security/use_cases/validate_immobilization.ts`
- [Command Dispatch](https://github.com/evansjean345/my_sis_back/blob/main/app/application/security/use_cases/dispatch_engine_command.ts): `app/application/security/use_cases/dispatch_engine_command.ts`
- [Engine Restore](https://github.com/evansjean345/my_sis_back/blob/main/app/application/security/use_cases/request_engine_restore.ts): `app/application/security/use_cases/request_engine_restore.ts`
- [Device Commands](https://github.com/evansjean345/my_sis_back/blob/main/app/domain/security/entities/device_command.ts): `app/domain/security/entities/device_command.ts`
- [Telemetry Domain](https://github.com/evansjean345/my_sis_back/tree/main/app/domain/telemetry): `app/domain/telemetry`

### Telemetry Ingestion

- [Frame Ingestion](https://github.com/evansjean345/my_sis_back/blob/main/app/application/telemetry/use_cases/ingest_telemetry_frames.ts): `app/application/telemetry/use_cases/ingest_telemetry_frames.ts`
- [Frame Parser](https://github.com/evansjean345/my_sis_back/blob/main/app/infrastructure/gateways/flespi/flespi_frame_parser.ts): `app/infrastructure/gateways/flespi/flespi_frame_parser.ts`
- [MQTT Transport](https://github.com/evansjean345/my_sis_back/blob/main/app/infrastructure/gateways/flespi/mqtt_transport.ts): `app/infrastructure/gateways/flespi/mqtt_transport.ts`
- [Ingest Worker](https://github.com/evansjean345/my_sis_back/blob/main/commands/ingest.ts): `commands/ingest.ts`

### Infrastructure

- [Flespi Gateways](https://github.com/evansjean345/my_sis_back/tree/main/app/infrastructure/gateways/flespi): `app/infrastructure/gateways/flespi`
- [Persistence](https://github.com/evansjean345/my_sis_back/tree/main/app/infrastructure/persistence): `app/infrastructure/persistence`
- [Database Schema](https://github.com/evansjean345/my_sis_back/blob/main/database/schema.ts): `database/schema.ts`
- [Audit Logging](https://github.com/evansjean345/my_sis_back/blob/main/app/infrastructure/persistence/audit_logger.ts): `app/infrastructure/persistence/audit_logger.ts`

### Other components

- **Fleet Operator**
- **PostgreSQL + PostGIS**
- **Redis**
- **Flespi**

## Connections

- Fleet Operator → HTTP Routes: sends requests (evidence: `start/routes.ts`)
- HTTP Routes → Fleet Controllers: routes fleet (evidence: `start/routes.ts`)
- HTTP Routes → Identity Controllers: routes identity (evidence: `start/routes.ts`)
- HTTP Routes → Immobilization API: routes security
- HTTP Routes → Audit API: routes audit (evidence: `start/routes.ts`)
- Immobilization API → Command Requests: executes request (evidence: `app/presentation/http/controllers/security/immobilization_controller.ts`)
- Immobilization API → Command Validation: executes validation (evidence: `app/presentation/http/controllers/security/immobilization_controller.ts`)
- Immobilization API → Command Dispatch: executes dispatch (evidence: `app/presentation/http/controllers/security/immobilization_controller.ts`)
- Immobilization API → Engine Restore: executes restore (evidence: `app/presentation/http/controllers/security/immobilization_controller.ts`)
- Command Requests → Device Commands: creates commands
- Command Dispatch → Flespi Gateways: sends commands
- Ingest Worker → MQTT Transport: subscribes to (evidence: `commands/ingest.ts`)
- Ingest Worker → Frame Parser: parses frames (evidence: `commands/ingest.ts`)
- Ingest Worker → Frame Ingestion: invokes ingestion (evidence: `commands/ingest.ts`)
- MQTT Transport → Flespi: receives messages
- Frame Ingestion → Telemetry Domain: processes readings
- Fleet Controllers → Flespi Gateways: queries devices (evidence: `app/presentation/http/controllers/fleet/device_controller.ts`)
- Database Schema → PostgreSQL + PostGIS: defines schema
- Persistence → PostgreSQL + PostGIS: stores data
- Persistence → Redis: uses cache
- Audit API → Audit Logging: reads audit
