Skip to content

Commit 3c415ef

Browse files
committed
fix: Update system architecture diagram for clarity and consistency
1 parent b221d6e commit 3c415ef

File tree

1 file changed

+14
-29
lines changed

1 file changed

+14
-29
lines changed

SYSTEM_ARCHITECTURE_DIAGRAM.md

Lines changed: 14 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -6,31 +6,32 @@ This document provides a multi‑view representation of the Project KARL archite
66

77
```mermaid
88
flowchart LR
9+
%% Simplified for GitHub Mermaid compatibility (no \n in labels)
910
subgraph APP[Your Application / Example Desktop]
1011
UI[Compose UI / ViewModel]
1112
DSImpl[DataSource Impl]
1213
end
1314
14-
subgraph CORE[:karl-core]
15+
subgraph CORE[karl-core]
1516
API[KarlAPI]
16-
KC[KarlContainer\n(Orchestrator)]
17+
KC[KarlContainer / Orchestrator]
1718
LEI[[LearningEngine Interface]]
1819
DSI[[DataStorage Interface]]
1920
end
2021
2122
subgraph IMPLS[Pluggable Implementations]
22-
KLDL[:karl-kldl\n(KotlinDL Engine)]
23-
ROOM[:karl-room\n(Room / SQLite)]
24-
UIKIT[:karl-compose-ui\n(UI Components)]
23+
KLDL[karl-kldl / KotlinDL]
24+
ROOM[karl-room / Room DB]
25+
UIKIT[karl-compose-ui / UI Kit]
2526
end
2627
2728
UI -->|User Interaction| DSImpl -->|InteractionData| API --> KC
2829
KC -->|processNewData()| LEI
2930
KC -->|save/load| DSI
30-
LEI -->|predict()| KC -->|Prediction Flow| UI
31+
LEI -->|predict()| KC -->|Prediction| UI
3132
LEI <-->|trainStep()| KC
32-
LEI === KLDL
33-
DSI === ROOM
33+
KLDL --- LEI
34+
ROOM --- DSI
3435
UIKIT -. consumes APIs .- UI
3536
```
3637

@@ -75,27 +76,11 @@ sequenceDiagram
7576

7677
```mermaid
7778
flowchart TD
78-
subgraph EventCapture[Event Capture]
79-
Evt[Raw UI Event]
80-
Filter[Filter / Anonymize]
81-
Data[InteractionData]
82-
end
83-
subgraph Learning[Learning Pipeline]
84-
Queue[(In-Memory Buffer)]
85-
Train[trainStep]
86-
ModelState[(Model State)]
87-
end
88-
subgraph Persistence[Persistence]
89-
Serialize[serializeState]
90-
DB[(Room / SQLite)]
91-
end
92-
subgraph Inference[Inference]
93-
Context[Prediction Context]
94-
Predict[predict()]
95-
Result[(Prediction Result)]
96-
end
97-
Evt --> Filter --> Data --> Queue --> Train --> ModelState --> Serialize --> DB
98-
Context --> Predict --> Result
79+
%% Simplified linear flow & labels for compatibility
80+
Evt[Raw UI Event] --> Filter[Filter / Anonymize] --> Data[InteractionData]
81+
Data --> Queue[(In-Memory Buffer)] --> Train[trainStep] --> ModelState[(Model State)]
82+
ModelState --> Serialize[serializeState] --> DB[(Room / SQLite)]
83+
Context[Prediction Context] --> Predict[predict()] --> Result[(Prediction Result)]
9984
ModelState --> Predict
10085
DB -->|loadState| ModelState
10186
```

0 commit comments

Comments
 (0)