restructure: flatten project, add ARCHITECTURE.md, update DEVY.md

- Moved from session-analytics-web/ subfolder to root
- Renamed to token-analytics
- Added deploy.sh, ARCHITECTURE.md
- Moved export.mjs into jsonl-sync/
This commit is contained in:
Meleki committed 2026-02-21 11:18:53 +01:00
1 parent 1d3070ed4c
commit dbaad6b372
17 files changed
+340 -270

No files matched your search

+51
View File
@@ -0,0 +1,51 @@
# Architecture
## Stack
- **Backend:** ASP.NET (.NET 10), Minimal API
- **Frontend:** Vanilla HTML/CSS/JS (SPA, kein Framework)
- **Datenbank:** SQLite via Dapper (read) + better-sqlite3 (import)
- **Port:** 18684
## Komponenten
### Backend (`Program.cs`)
Minimal API mit Endpunkten für Kosten-Analyse:
- `GET /api/cost-buckets` - Zeitraum in N Buckets aggregiert
- `GET /api/cost-entries` - Einzelne Einträge mit Kosten
- `GET /api/cost-chains` - Konversations-Ketten nach Kosten sortiert
- `GET /api/cost-summary` - Gesamtkosten für Zeitraum
- `GET /api/entry-chain/{id}` - Volle Kette eines Eintrags (parentId vor/zurück)
- `GET /api/entry-chains` - Einträge mit chainId-Zuordnung
- `POST /api/sync` - Triggert JSONL-Import via `export.mjs`
DB-Zugriff über Dapper + `Microsoft.Data.Sqlite`. Connection per Request via Factory.
### JSONL Sync (`jsonl-sync/export.mjs`)
Node.js Script das OpenClaw Session-JSONL-Files in SQLite importiert:
1. Liest alle `.jsonl` aus `/home/node/.openclaw/agents/main/sessions/`
2. Parsed Einträge, speichert in `entries` Tabelle
3. Berechnet `chainId` durch parentId-Walk bis zum nächsten User-Message
4. Inkrementell - merkt sich pro File die letzte verarbeitete Zeile
### Frontend (`wwwroot/`)
SPA mit Zoom-Navigation durch Zeiträume:
- **Bucket-View:** Balkendiagramm mit klickbarem Drill-Down (Monat → Woche → Tag → Stunden)
- **Entry-View:** Einzelne API-Calls als Balken, farblich nach Konversations-Kette
- **Chain-Blocks:** Teuerste Konversationen als klickbare Blöcke
- **Modal:** Konversations-Kontext mit User/Assistant Messages
- State wird im URL-Hash gespeichert
## Datenfluss
```
OpenClaw JSONL Files → export.mjs → SQLite (sessions.db) → .NET API → Frontend
```
## Deployment
```bash
./deploy.sh
```
Baut Release, kopiert nach `publish/`, restartet den `token-analytics` systemd Service auf stein2.