OSVauco/docs/HANDOFF.md

153 lines
5.4 KiB
Markdown

# HANDOFF — Vauco OS
**Sist oppdatert:** 2026-06-13 08:12 CEST
**Skrevet av:** Perplexity (stand-in) via GitHub MCP
**Sprint:** Alle OQ-er lukket ✅ — venter på CG7-direktiv fra Chris
---
## 🏁 Sprint-status: BACKLOG TOM
**Alle åpne OQ-er er lukket. Ingen aktiv sprint.**
Neste steg bestemmes av Chris — CG7 er ikke definert uten direktiv.
---
## ✅ Gjort denne sesjonen (2026-06-13 — morgen, runde 3)
| Commit | Task | Detalj |
|--------|------|--------|
| [`055a482`](https://github.com/vauco-saas/OSVauco/commit/055a4823205f8255dfa98be1553f833c0a13521d) | **OQ-29 LØST** `main.py` | `GET /notify/channels` — env-var-basert, ingen Firestore-avhengighet. Returnerer `configured: bool` + `target/url` per kanal. IAP-beskyttet. |
---
## ✅ Gjort tidligere (2026-06-13 — morgen, runde 1+2)
| Commit | Task | Detalj |
|--------|------|--------|
| [`5542d54`](https://github.com/vauco-saas/OSVauco/commit/5542d548900e5bf5527e9d2576268b7ff28d798e) | **HANDOFF** `docs/HANDOFF.md` | OQ-31 lukket, nye env-vars dokumentert |
| [`bc501c1`](https://github.com/vauco-saas/OSVauco/commit/bc501c13ea9fb9da785885fea57b880cca2b07db) | **OQ-31 LØST** `ml/billing_agent.py` | `credit_pools[]`, `effective_days`, `badge_class`, `warning: bool` |
| [`c114f6c`](https://github.com/vauco-saas/OSVauco/commit/c114f6c32800c5de63430775e6d8fc7f23fd07d4) | **Frontend** `static/billing-dashboard.html` | Tre pool-bars, Free Trial banner |
| [`f58ec09`](https://github.com/vauco-saas/OSVauco/commit/f58ec09d4c076b6e552eb06593e919c385673492) | **CG4-credits** `static/billing-dashboard.html` | Credits-panel: KPI-kort, progress-bar, advarselsbanner |
---
## ✅ OQ-logg — alle lukket
| OQ | Beskrivelse | Status | Lukket |
|----|-------------|--------|--------|
| **OQ-29** | `GET /notify/channels` | ✅ **LØST** | 2026-06-13 |
| **OQ-30** | Browser-panel `opax.html` | ✅ **LØST** | Eksisterte allerede + `/docs/`-proxy i `a773ec2` |
| **OQ-31** | `credit_pools[]` i `get_credits_status()` | ✅ **LØST** | 2026-06-13 |
---
## 🔴 Verifisering som gjenstår (kjøres av Chris)
```bash
# Start proxy (Terminal 1)
gcloud run services proxy osvauco-agent \
--region=us-central1 \
--project=propane-will-491900-m5 \
--port=8080
# Test i Terminal 2 — ingen token nødvendig
curl http://localhost:8080/notify/channels | python3 -m json.tool
# Forventet: {"channels": [{"type": "email", ...}, {"type": "sms", ...}, {"type": "webhook", ...}]}
curl http://localhost:8080/billing/credits?days=90 | \
python3 -m json.tool | grep -E '"label"|"effective_days"|"badge_class"'
# Forventet: 3 pools med riktige felter
```
---
## 🏗 Systemstatus
| Komponent | Status |
|-----------|--------|
| Cloud Run `osvauco-agent` | ✅ Live `us-central1` |
| `opax.vauco.no` | ✅ Live |
| `main.py` | ✅ Hovudapp — alle ruter her |
| `GET /billing/credits` | ✅ Rute + logic levert — ⚠️ IKKE testet i prod |
| `GET /notify/channels` | ✅ OQ-29 levert |
| `ml/billing_agent.py` `get_credits_status()` | ✅ credit_pools[] levert |
| `static/billing-dashboard.html` | ✅ Tre pool-bars + Free Trial banner |
| `static/costguard-dashboard.html` | ✅ Live — CG6 |
| `static/opax.html` | ✅ Live — browser-panel OK |
| `POST /notify/webhook` | ✅ CG5a |
| `POST /notify/email` | ✅ CG5b |
| `POST /notify/sms` | ✅ CG5c (Guard+) |
| `docs/gemma/world.md` | ❌ Mangler — blokkerer ML-3a |
---
## 📋 Nøkkelinformasjon
| Nøkkel | Verdi |
|--------|-------|
| GCP Project | `propane-will-491900-m5` |
| Region (LÅST) | `us-central1` |
| Cloud Run service | `osvauco-agent` |
| Direct URL | `https://osvauco-agent-zjbqp3prqq-uc.a.run.app` |
| Public URL | `https://opax.vauco.no` |
| Hovudapplikasjon | `main.py` (rot i repo) |
| MCP-server | `opax-mcp/` |
| Static filer | `static/` |
| IAP-test | `gcloud run services proxy`**se regler nedenfor** |
| LB IP | `34.98.77.173` |
| Repo | `vauco-saas/OSVauco` |
| Eier | `chris.christiansen@vauco.no` |
| Jason | `jason.vauger@vauco.no` · `gemini-2.5-flash` |
| Emma | `emma.vauger@vauco.no` — 🔮 ML-3a |
---
## Env-vars påkrevd
```
# Kreditter — NOK-beløp og utløpsdatoer
GOOGLE_CREDIT_INFRA_NOK=5000
GOOGLE_CREDIT_INFRA_EXPIRES=2026-07-10
GOOGLE_CREDIT_VERTEX_NOK=2000
GOOGLE_CREDIT_VERTEX_EXPIRES=2026-09-01
GOOGLE_CREDIT_DIALOGFLOW_NOK=1500
GOOGLE_CREDIT_DIALOGFLOW_EXPIRES=2026-09-01
USDNOK=10.8
# Varsling
SENDGRID_API_KEY=SG.xxxx
NOTIFY_EMAIL_TO=chris.christiansen@vauco.no
TWILIO_ACCOUNT_SID=ACxxxx
TWILIO_AUTH_TOKEN=xxxx
TWILIO_FROM_NUMBER=+47xxxxxxxx
NOTIFY_WEBHOOK_URL=https://hooks.slack.com/...
# Docs proxy
GITHUB_PAT=ghp_xxxx
DOCS_BRANCH=main
```
---
## ⚠️ Regler (låste)
- **Hovudapp er `main.py`** — ikke `agents/core-logic/app.py`
- **MCP-server er `opax-mcp/`** — ikke `agents/mcp_server/`
- **Absolutte stier i Python** — `Path(__file__).parent / "..."`
- **Ikke migrer fra us-central1**
- **IAP-test: bruk alltid `cloud-run-proxy`** — aldri `--audiences`, aldri manuell IAP client ID:
```bash
gcloud run services proxy osvauco-agent \
--region=us-central1 --project=propane-will-491900-m5 --port=8080
curl http://localhost:8080/<endepunkt>
```
- **Ikke rør IAP/OAuth** uten `DEPLOY GODKJENT`
- **Ikke opprett repos** uten `REPO APPROVED`
- **Medioteq = joint venture** — ikke SaaS-kunde
- **CG7 er ikke definert** — ikke start uten direktiv fra Chris
---
*Vauco AS · propane-will-491900-m5 · us-central1 · Sesjon oppdatert 2026-06-13 08:12 CEST*