101 lines
2.9 KiB
Markdown
101 lines
2.9 KiB
Markdown
# VAUCO OS — ARCHITECTURE.md
|
|
# Eier: PLAN-Claude-Architect
|
|
# Sist oppdatert: 2026-05-18 — OPS-Computer-Hub (bootstrap, tom fil)
|
|
# Status: STUB — PLAN-Claude-Architect fyller ut ved første boot
|
|
|
|
---
|
|
|
|
## Hensikt
|
|
Single source of truth for systemarkitektur, komponent-diagram og design-kontrakter.
|
|
Ingen andre tråder skriver denne filen. Andre tråder kan foreslå patcher via PR.
|
|
|
|
---
|
|
|
|
## Komponent-diagram (ASCII)
|
|
|
|
```
|
|
[Chris / Operatør]
|
|
|
|
|
-----+------+----------+----------+
|
|
| | | |
|
|
OPS EXEC PLAN AUDIT
|
|
Perplexity Gemini Claude Nemotron
|
|
Computer 2.5 Pro Sonnet/ (NMT)
|
|
Opus
|
|
| | | |
|
|
+-----+-----+----------+----------+
|
|
|
|
|
[GitHub]
|
|
OSVauco (main)
|
|
vauco-bootstrap (main)
|
|
|
|
|
[GCP / Cloud Run]
|
|
project: propane-will-491900-m5
|
|
region: us-central1
|
|
|
|
|
[Gemini API]
|
|
SDK: from google import genai
|
|
```
|
|
|
|
---
|
|
|
|
## Tråd-kontrakter
|
|
|
|
| Tråd | Modell | Eid fil | Konnektor |
|
|
|---|---|---|---|
|
|
| OPS-Computer-Hub | Perplexity Computer | AGENTRLEBOOK.md, LEARNINGS.md, CHANGELOG.md | GitHub web, search |
|
|
| EXEC-Gemini-Workstation | Gemini 2.5 Pro | SYSTEM_STATE_AGENT_BOOT.md, TODO.md | shell, gcloud, git |
|
|
| PLAN-Claude-Architect | Claude Sonnet/Opus | ARCHITECTURE.md (denne), ROADMAP.md | GitHub UI/API |
|
|
| AUDIT-NMT-Critic | Nemotron | RISKREGISTER.md, PLANBOARD.md | read-only alle filer |
|
|
|
|
Regel: En fil — én eier. Andre tråder foreslår via PR, eier merger.
|
|
|
|
---
|
|
|
|
## Dataflyt
|
|
|
|
```
|
|
OPS --[MD-patch PR]--> PLAN merger
|
|
EXEC --[SYSTEM_STATE]--> alle leser
|
|
PLAN --[arch-spec PR]--> EXEC implementerer
|
|
AUDIT--[PLANBOARD]--> Chris prioriterer
|
|
|
|
Filer flyter via: GitHub commits på OSVauco/main
|
|
Aldri: direkte tråd-til-tråd
|
|
```
|
|
|
|
---
|
|
|
|
## Avhengigheter
|
|
|
|
- `OSVauco/main` er canonical branch for dette prosjektet
|
|
- Cloud Run avhenger av `vauco-gemini-tui-bridge` og OPAX-MCP-tjenesten
|
|
- Bridge avhenger av `bridge/`-kode + GCP service account `vauco-dev`
|
|
- Token economy avhenger av `scripts/token_economy.py` (planlagt)
|
|
- Pre-commit hook v2 avhenger av `.githooks/pre-commit` (planlagt)
|
|
|
|
---
|
|
|
|
## Åpne spørsmål (max 3)
|
|
|
|
1. **Langsiktig repo-struktur?**
|
|
- A: Behold OSVauco + tjeneste-repoer (nåværende)
|
|
- B: Slå sammen til monorepo
|
|
- C: Splitt ytterligere per tjeneste
|
|
|
|
2. **Cloud Run min-instances=0 eller 1?**
|
|
- A: 0 — kutter idle-kostnad (anbefalt H0)
|
|
- B: 1 — ingen cold start latency
|
|
- C: Autoscaling med schedule
|
|
|
|
3. **IAM: vauco-dev service account scope?**
|
|
- A: Minimal — kun Vertex AI + Firestore
|
|
- B: Bred — alle GCP tjenester i prosjektet
|
|
- C: Per-skill separate accounts
|
|
|
|
---
|
|
|
|
## STUB-NOTAT
|
|
Denne filen er opprettet av OPS-Computer-Hub 2026-05-18 som oppstart for dette prosjektet.
|
|
PLAN-Claude-Architect skal senere erstatte innholdet med komplett draft når Claude-tråden starter. Se `plan_claude_architect_prompt.md`.
|