feat: add domain convention, MCP identity and client model to ARCHITECTURE.md [Phase 1]
This commit is contained in:
parent
6ae1a256f2
commit
4a971ddbd1
|
|
@ -1,7 +1,7 @@
|
||||||
# VAUCO OS — ARCHITECTURE.md
|
# VAUCO OS — ARCHITECTURE.md
|
||||||
# Eier: PLAN-Claude-Architect
|
# Eier: PLAN-Claude-Architect
|
||||||
# Sist oppdatert: 2026-05-18 — OPS-Computer-Hub (bootstrap, tom fil)
|
# Sist oppdatert: 2026-05-21 CEST
|
||||||
# Status: STUB — PLAN-Claude-Architect fyller ut ved første boot
|
# Godkjent av: Chris Christiansen
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -33,17 +33,58 @@ Computer 2.5 Pro Sonnet/ (NMT)
|
||||||
project: propane-will-491900-m5
|
project: propane-will-491900-m5
|
||||||
region: us-central1
|
region: us-central1
|
||||||
|
|
|
|
||||||
[Gemini API]
|
[OPAX-MCP — opax.vauco.no]
|
||||||
SDK: from google import genai
|
service: opax-mcp-core
|
||||||
|
protocol: OPAX Protocol
|
||||||
|
|
|
||||||
|
[Klient-OS]
|
||||||
|
<klient>-oss.vauco.no (stage)
|
||||||
|
<klient>-os.vauco.no (prod)
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## MCP Identity
|
||||||
|
|
||||||
|
| Parameter | Verdi |
|
||||||
|
|----------------|------------------------------------|
|
||||||
|
| MCP_NAME | OPAX-MCP |
|
||||||
|
| MCP_PROTOCOL | OPAX Protocol |
|
||||||
|
| MCP_SERVICE | opax-mcp-core |
|
||||||
|
| Cloud Run | us-central1 |
|
||||||
|
| HUB_URL | https://opax.vauco.no (Phase 2) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Domenekonvensjon — LOCKED
|
||||||
|
|
||||||
|
| Subdomain | Type | Formål |
|
||||||
|
|-------------------------|----------|---------------------------------------------------|
|
||||||
|
| `opax.vauco.no` | Hub/MCP | OPAX-MCP operator hub — kun Vauco internt |
|
||||||
|
| `<klient>-os.vauco.no` | Prod OS | Kundens live produksjonssystem |
|
||||||
|
| `<klient>-oss.vauco.no` | Stage OS | Kundens staging/demo-system (pre-go-live) |
|
||||||
|
|
||||||
|
> `-os` = produksjon. `-oss` = staging. Aldri omvendt.
|
||||||
|
|
||||||
|
### Auth-strategi
|
||||||
|
- **Nå:** Google OAuth på alle miljøer
|
||||||
|
- **Senere:** BankID på `-os`-domener for kliniske kunder (Medioteq først)
|
||||||
|
|
||||||
|
### Kjente / planlagte domener
|
||||||
|
|
||||||
|
| Domene | Status | Cloud Run-tjeneste |
|
||||||
|
|-------------------------|---------------|-----------------------|
|
||||||
|
| `opax.vauco.no` | DNS pending | `opax-mcp-core` ✅ |
|
||||||
|
| `medioteq-oss.vauco.no` | Planlagt | `medioteq-oss-core` |
|
||||||
|
| `medioteq-os.vauco.no` | Planlagt | `medioteq-os-core` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Tråd-kontrakter
|
## Tråd-kontrakter
|
||||||
|
|
||||||
| Tråd | Modell | Eid fil | Konnektor |
|
| Tråd | Modell | Eid fil | Konnektor |
|
||||||
|---|---|---|---|
|
|---|---|---|---|
|
||||||
| OPS-Computer-Hub | Perplexity Computer | AGENTRLEBOOK.md, LEARNINGS.md, CHANGELOG.md | GitHub web, search |
|
| OPS-Computer-Hub | Perplexity Computer | AGENT_RULEBOOK.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 |
|
| 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 |
|
| 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 |
|
| AUDIT-NMT-Critic | Nemotron | RISKREGISTER.md, PLANBOARD.md | read-only alle filer |
|
||||||
|
|
@ -66,6 +107,21 @@ Aldri: direkte tråd-til-tråd
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## Klientmodell — Prosjektisolasjon
|
||||||
|
|
||||||
|
**Prinsipp:** Hver klient med sensitiv/medisinsk data får eget GCP-prosjekt.
|
||||||
|
|
||||||
|
| Lag | GCP-prosjekt | Rolle |
|
||||||
|
|-----|-------------|-------|
|
||||||
|
| OPAX/OSVauco | `propane-will-491900-m5` | Management plane — deploy, monitor, orchestrate |
|
||||||
|
| Medioteq klinisk | `<medioteq-project-id>` | Data plane — kliniske data forblir her |
|
||||||
|
|
||||||
|
- OPAX mottar **aldri** rå pasientdata
|
||||||
|
- Data-residency: `europe-north1` for norske helsedata
|
||||||
|
- Alle agentkall logges til BigQuery i klientprosjektet (input/output hash, ikke råinnhold)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Avhengigheter
|
## Avhengigheter
|
||||||
|
|
||||||
- `OSVauco/main` er canonical branch for dette prosjektet
|
- `OSVauco/main` er canonical branch for dette prosjektet
|
||||||
|
|
@ -86,15 +142,10 @@ Aldri: direkte tråd-til-tråd
|
||||||
2. **Cloud Run min-instances=0 eller 1?**
|
2. **Cloud Run min-instances=0 eller 1?**
|
||||||
- A: 0 — kutter idle-kostnad (anbefalt H0)
|
- A: 0 — kutter idle-kostnad (anbefalt H0)
|
||||||
- B: 1 — ingen cold start latency
|
- B: 1 — ingen cold start latency
|
||||||
- C: Autoscaling med schedule
|
|
||||||
|
|
||||||
3. **IAM: vauco-dev service account scope?**
|
3. **IAM: vauco-dev service account scope?**
|
||||||
- A: Minimal — kun Vertex AI + Firestore
|
- A: Minimal — kun Vertex AI + Firestore
|
||||||
- B: Bred — alle GCP tjenester i prosjektet
|
- B: Per-skill separate accounts
|
||||||
- C: Per-skill separate accounts
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
EOF v1.1 — 2026-05-21 — OPS/PLAN (Phase 1: domain convention + MCP identity added)
|
||||||
## 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`.
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue
Block a user