forge/Architecture_Diagram.md
2026-05-23 09:23:12 -05:00

50 lines
1.1 KiB
Markdown

# Forge Architecture
## Runtime Flow
```mermaid
flowchart TD
Client[Arma Client Addons] --> Server[Arma Server Addons]
Server --> Bridge[Extension Bridge]
Bridge --> Extension[Rust arma-rs Extension]
Extension --> Services[Service Layer]
Services --> Repositories[Repository Traits]
Repositories --> Surreal[(SurrealDB)]
```
## Persistence Startup
```mermaid
sequenceDiagram
participant Arma as Arma Server
participant Ext as Forge Extension
participant Db as SurrealDB
Arma->>Ext: init
Ext->>Db: connect
Ext->>Db: apply schema modules
Db-->>Ext: ready
Arma->>Ext: status
Ext-->>Arma: connected
```
## Data Access
```mermaid
sequenceDiagram
participant SQF as SQF Addon
participant Ext as Extension Command
participant Service as Service
participant Repo as Repository
participant Db as SurrealDB
SQF->>Ext: domain command
Ext->>Service: validate and execute
Service->>Repo: repository call
Repo->>Db: query/upsert/delete
Db-->>Repo: result
Repo-->>Service: domain model
Service-->>Ext: response
Ext-->>SQF: serialized result
```