Merge branch 'main' of github.com:chrischristiansen-glitch/OSVauco
This commit is contained in:
Chris Christiansen
commit
d9380d1a6e
51
docs/HANDOFF_20260526.md
Normal file
51
docs/HANDOFF_20260526.md
Normal file
|
|
@ -0,0 +1,51 @@
|
|||
# 🔁 OSVauco · OPAX — Sesjonshandoff 2026-05-26
|
||||
|
||||
## ✅ Hva ble fullført
|
||||
|
||||
### Infrastruktur (Fase B — 100% komplett)
|
||||
- B1 Deploy, B2 GitHub PAT, B3 CI/CD pipeline, B4 Webhook — alt grønt
|
||||
- Google Chat deploy-varsler via `cloudbuild.yaml` — live og bekreftet
|
||||
- B5 Cost guard: budsjett `osvauco-monthly-guard` på 500 NOK/mnd med 50/90/100%-terskler
|
||||
- GCS bucket `osvauco-ml-telemetry` med 90-dagers lifecycle + Cloud Logging sink
|
||||
- `opax.vauco.no` live via CNAME → `ghs.googlehosted.com` (domain mapping OK)
|
||||
|
||||
### Boot-skjerm og TUI-miljø
|
||||
- Kompakt boot-skjerm med sanntidsstatus: Vertex AI, Cloud Run, GitHub, Git Remote
|
||||
- Auto-auth med 8-timers ADC-cache (slipper å re-autentisere)
|
||||
- Hurtigkommandoer live: `ca`, `cl`, `cg`, `hc`, `pf`, `st`, `rl`, `sl`, `ms`, `g`, `sol`
|
||||
- Auto-sync til GitHub: push etter 10 kommandoer eller 1 time
|
||||
- Cron: GDrive mirror-sync hver hele time
|
||||
- `sol`-dobbel fjernet, QUICK COMMANDS kun i tabellen
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Kjente utfordringer / åpne punkter
|
||||
|
||||
| Problem | Status | Notat |
|
||||
|---|---|---|
|
||||
| `opax.vauco.no` gir 403 i nettleser | Arkitekturgrense | Custom domain mapping støtter ikke browser-login uten LB+IAP |
|
||||
| `opax.vauco.no/docs` = 403 | Forventet | Kun `/health` fungerer uten Bearer-token |
|
||||
| Vertex AI helsesjekk viste FAIL | Løst via ADC re-scope | Kan skje igjen etter 8t |
|
||||
| Logo-animasjon forsøkt, reverted | Ferdig | Terminalen håndterer ikke ANSI-animasjon godt nok ved boot |
|
||||
|
||||
---
|
||||
|
||||
## 📋 Neste sesjon — prioritert rekkefølge
|
||||
|
||||
1. **B6 — Dialogflow CX export til Git** *(lav innsats, høy risiko — konfig ikke versjonskontrollert)*
|
||||
2. **LB + IAP for `opax.vauco.no`** *(gjør UI tilgjengelig i nettleser — bake inn i Terraform-modulen for kunder samtidig)*
|
||||
3. **Threadstone Fase A** *(første salg — Medioteq-leveransen):*
|
||||
- Opprett `vauco-saas/threadstone-instructions` repo
|
||||
- Skriv `models/claude.md`, `chatgpt.md`, `gemini.md`
|
||||
- Master Hub v3.2 HTML-template
|
||||
4. **Terraform bootstrap** — konverter `infrastructure/*.sh` → `.tf`-filer *(kritisk vei til Fase C)*
|
||||
5. **BigQuery → Looker Studio** — koble `osvauco-ml-telemetry` for kostnad/kvalitet-dashboard
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ Arkitekturavgjørelser tatt i dag
|
||||
|
||||
- **`opax.vauco.no`** = CNAME (ditt interne verktøy, gratis)
|
||||
- **Kunde-instanser** = LB + IAP via Terraform-modul (Fase C)
|
||||
- **VCO token Fase 1** = "Threadstone Credits" off-chain, 1 credit = 1 kr, Stripe top-up
|
||||
- **Auto-sync** = push ved 10 kommandoer + cron hourly + GDrive mirror
|
||||
108
protocols/reports/2026-05-26_google-dev-tech-review.md
Normal file
108
protocols/reports/2026-05-26_google-dev-tech-review.md
Normal file
|
|
@ -0,0 +1,108 @@
|
|||
# OSVauco — Tech Review rapport
|
||||
**Perspektiv:** Senior Google Cloud Platform engineer
|
||||
**Dato:** 2026-05-26 06:03 CEST
|
||||
**Kilde:** Perplexity OPAX-agent, basert på MASTERPLAN.md + repo-struktur + sesjonsfiler
|
||||
|
||||
---
|
||||
|
||||
## ✅ Det som er solid
|
||||
|
||||
- **CI/CD er riktig bygget.** Cloud Build 2nd gen + GitHub App er den anbefalte veien — unngår OAuth-kompleksiteten i 1st gen.
|
||||
- **Light/heavy LLM-ruting** er en fornuftig kostnadsarkitektur. Flash foran, Pro ved behov — dette skalerer.
|
||||
- **Teardown-disiplin** (daglig `03-teardown.sh`) viser forståelse for at Agent Runtimes og Reasoning Engines koster 24/7 selv uten trafikk.
|
||||
- **MASTERPLAN.md** som single source of truth holder agenter og mennesker synkronisert.
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Kritiske strukturproblemer
|
||||
|
||||
### 1. Repo-identitet er uklar
|
||||
|
||||
| Repo | Hva det sier det er | Hva det faktisk er | Konflikt? |
|
||||
|---|---|---|---|
|
||||
| `OSVauco` | Regler, GCP-scripts, agenter | Alt — inkl. `main.py`, `ml/`, `agents/`, `infrastructure/`, `protocols/` | **Ja — monorepo uten grenser** |
|
||||
| `vauco-gemini-tui-bridge` | TUI-cockpit | Uklart om dette er en separat service eller shell-wrapper | Ukjent |
|
||||
| `vauco-os` | Det kundene bruker | Ukjent om dette er fersk kopi av OSVauco eller eget produkt | **Potensielt duplikat** |
|
||||
| `vauco-bootstrap` | Onboarding | Ingen Terraform ennå — grense mot `OSVauco/infrastructure/` er uklar | Uklar |
|
||||
| `deep-dream` | Strategisk visjon | "Aldri deploy herfra" — er dette et repo eller et dokument? | Unødvendig repo |
|
||||
|
||||
**Problemet:** `OSVauco` er blitt et monorepo som inneholder operasjonslogikk, ML-kode, infrastruktur-scripts, agent-kode, docs og protokoller. For mye i én kasse.
|
||||
|
||||
### 2. `.env.prefilled` i repoet er en sikkerhetsrisiko
|
||||
|
||||
`.env.prefilled` i root kan inneholde faktiske project IDs og account-verdier. For en SaaS-plattform med kunder bør dette enten fjernes eller eksplisitt gitignores.
|
||||
|
||||
**Aksjon:** Verifiser innhold → fjern eller legg til `.gitignore`.
|
||||
|
||||
### 3. `Procfile` i root antyder Heroku-arv
|
||||
|
||||
`Procfile` er et Heroku-konsept. Cloud Run bruker container entrypoint, ikke Procfile. Dette er enten teknisk gjeld eller det skaper forvirring om hva som faktisk starter appen.
|
||||
|
||||
**Aksjon:** Fjern eller dokumenter tydelig at den er ubrukt.
|
||||
|
||||
### 4. `cloudbuild.base.yaml` + `cloudbuild.yaml` — uklar relasjon
|
||||
|
||||
To Cloud Build-filer i root uten åpenbar arv/include-struktur. Forvirrende for agenter og nye devs — hvilken er master?
|
||||
|
||||
**Aksjon:** Slå sammen eller dokumenter arv eksplisitt i begge filer.
|
||||
|
||||
### 5. Infrastructure scripts vs Terraform — ikke-idempotent overgangsperiode
|
||||
|
||||
Terraform-migreringen (Fase C) skaper en farlig periode der begge tilstandene eksisterer. Ingen lock hindrer at noen kjører et shell-script etter at Terraform har overtatt samme ressurs → state-konflikt.
|
||||
|
||||
**Aksjon:** Definer eksplisitt deprecerings-plan for hvert script etter Terraform-migrering.
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ Anbefalt repo-struktur (mål, ikke krav nå)
|
||||
|
||||
```
|
||||
# I dag (problem):
|
||||
OSVauco/ ← monorepo: alt blandet
|
||||
|
||||
# Anbefalt (Fase C-mål):
|
||||
vauco-platform/
|
||||
├── services/osvauco-agent/ ← main.py + agents/ + ml/
|
||||
├── infrastructure/terraform/ ← .tf-filer
|
||||
├── infrastructure/scripts/ ← shell (avvikles gradvis)
|
||||
└── dialogflow/ ← B6 her
|
||||
|
||||
vauco-ops/ ← internt operasjonsverktøy
|
||||
├── protocols/
|
||||
├── docs/
|
||||
└── .gemini/
|
||||
|
||||
vauco-bootstrap/ ← Terraform-modul per kunde
|
||||
```
|
||||
|
||||
**Merk:** Omstrukturering er en Fase C-vurdering — ikke krav nå.
|
||||
|
||||
---
|
||||
|
||||
## 📋 Prioritert aksjonsliste
|
||||
|
||||
| Prioritet | Handling | Innsats | Risiko hvis ignorert |
|
||||
|---|---|---|---|
|
||||
| 🔴 1 | Sjekk `.env.prefilled` — fjern eller gitignore | 5 min | Sensitiv info i Git |
|
||||
| 🔴 2 | Avklar rolle til `vauco-os` vs `OSVauco` — duplikat? | 30 min | Feil repo ved kundelevering |
|
||||
| 🟡 3 | Fjern/rename `Procfile` eller dokumenter at den er ubrukt | 5 min | Forvirrer agenter og nye devs |
|
||||
| 🟡 4 | Slå sammen `cloudbuild.base.yaml` og `cloudbuild.yaml` | 15 min | CI/CD-feil ved endringer |
|
||||
| 🟡 5 | Legg til `infrastructure/terraform/README.md` nå | 10 min | Ingen klar destinasjon for Terraform-bootstrap |
|
||||
| 🟢 6 | Vurder om `deep-dream` trenger eget repo | 10 min | Unødvendig repo-overhead |
|
||||
| 🟢 7 | Plan for deprecering av shell-scripts etter Terraform | Fase C | State-konflikt sh vs tf |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Konklusjon
|
||||
|
||||
Planen er arkitektonisk fornuftig og GCP-nativ. Fase A og B er godt gjennomført. De største risikoene er **ikke tekniske** — de er **organisatoriske**:
|
||||
|
||||
- Repo-grensene er uklare
|
||||
- Monorepo-vekst er i gang uten styring
|
||||
- Overgangen fra shell til Terraform mangler eksplisitt låsestrategi
|
||||
|
||||
Adresser de 🔴 røde punktene **før** B6 og Terraform-bootstrap for å stå stødigere til Fase C.
|
||||
|
||||
---
|
||||
|
||||
*Generert av Perplexity OPAX-agent | propane-will-491900-m5 | 2026-05-26 06:03 CEST*
|
||||
Loading…
Reference in New Issue
Block a user