SigHej/prompt.md

SigHej — AI Session Prompt

Paste this file at the start of a new AI coding session to get full project context.

---

Hvad er SigHej?

SigHej er et nudge-værktøj til fysiske samtaler i den virkelige verden.

Idéen er simpel: folk i samme rum kan have interesser til fælles uden at vide det. SigHej bruger BLE (Bluetooth Low Energy) til at opdage nærliggende brugere, tjekker om der er fælles interesser, og sender et diskret nudge til begge parter — "nogen i nærheden deler din interesse for X — sig hej". Det er det. Ingen chat, ingen profiler, ingen social graph. Kun et lille skub til en rigtig samtale.

Kerneprincipper:

• Ingen beskedudveksling — nudget er produktet, ikke en chat-app
• Privacyby design — ingen lokationsdata, ingen bruger-ID'er, ephemerelle tokens
• Simpelt og fokuseret — ét skærmbillede, én knap, ét formål

---

Monorepo-struktur

SigHej/
├── README.md
├── prompt.md               ← dette fil
├── Makefile                ← build workflow
├── docker-compose.yml      ← backend + PostgreSQL + Redis
├── Docs/
│   ├── ARCHITECTURE.md     ← system overview og data flow
│   ├── BACKEND.md          ← FastAPI detaljer
│   ├── APP.md              ← Flutter app detaljer
│   ├── ADMIN.md            ← Next.js admin detaljer
│   ├── TESTING.md          ← test- og kodestandarder
│   ├── DECISIONS.md        ← ADR'er (architecture decision records)
│   └── colors.md           ← "Sunny Beach Day" farvepalet
├── backend/                ← FastAPI Python
├── app/                    ← Flutter Dart (Android + iOS + web)
└── admin/                  ← Next.js TypeScript admin dashboard

---

Teknisk arkitektur

Flutter App (app/)

• Sprog: Dart, Flutter 3.x
• BLE: flutter_blue_plus ^1.36.8 — kun scanning på Android/iOS; web/macOS kører i demo-mode
• State: provider + SessionStore (ChangeNotifier)
• Persistens: shared_preferences — navn, tagline, interesser, bleToken
• Screens:
  • ProfileScreen — første-gangs onboarding + redigering af profil
  • HomeScreen — hoved-skærm med toggle-knap, pulseanimation og nudge-kort
• Theme: app/lib/theme.dart — "Sunny Beach Day" farvepalet, light + dark mode
• Platform-betinget BLE: _bleAvailable guard — alle BLE-kald er beskyttet; web/macOS simulerer match efter 3 sekunder (demo mode)
• Web: kører i Chrome via flutter run -d chrome --web-port 8080

Farvepalet (Sunny Beach Day):

Rolle	Navn	Hex
Primary	Verdigris	#2A9D8F
Secondary	Sandy Brown	#F4A261
Tertiary	Jasmine	#E9C46A
Error/CTA	Burnt Peach	#E76F51
Surface dark	Charcoal Blue	#264653

Backend (backend/)

• Sprog: Python 3.12, FastAPI, async
• Session store: Redis (TTL: 2 timer — auto-sletning, ingen cleanup nødvendig)
• Database: PostgreSQL — kun anonymiserede aggregat-statistikker (ingen PII)
• Kommunikation: REST (POST /session, POST /match) + WebSocket (nudge push)
• Config: pydantic-settings — miljøvariabler, ingen hardcodede secrets
• Tests: pytest, httpx TestClient

Admin Dashboard (admin/)

• Sprog: TypeScript, Next.js 14
• Formål: anonymiserede stats — pings, sessioner, interest counts
• Ingen PII, ingen bruger-niveau data
• Build: multi-stage Docker, output: "standalone", kræver package-lock.json

---

Data flow — happy path

Bruger A åbner app → vælger interesser → aktiverer "Åben for snak"
  └─► App genererer ephemeral BLE token (UUID)
  └─► App advertiser token via BLE (Android/iOS)
  └─► App registrerer token + interesser: POST /session

Bruger B i nærheden scanner BLE → finder A's token
  └─► App sender token: POST /match
  └─► Backend: overlapper B's interesser med A's?
  └─► Ja → WebSocket nudge til begge:
        "Nogen i nærheden deler din interesse for X — sig hej"
  └─► Brugerne lægger telefonen fra sig og siger hej
  └─► Session udløber automatisk (Redis TTL: 2 timer)

---

Makefile workflow

make up          # start backend + PostgreSQL + Redis (Docker)
make down        # stop services
make build       # byg Docker images
make logs        # følg logs

make be-dev      # kør FastAPI i dev mode (hot reload)
make be-test     # kør pytest
make be-lint     # ruff lint
make be-fmt      # ruff format

make adm-dev     # kør Next.js admin i dev mode
make adm-build   # byg admin til produktion

make app-get     # flutter pub get
make app-analyze # flutter analyze (skal være "No issues found!")
make app-test    # flutter test

make check       # fuld CI: lint + test på alle tre komponenter

---

Kodestandarder

Python backend

Analyse kører via DevOpsMCP (https://devops-mcp.i80.dk):

# Upload og analysér
session = DevOpsMCP-start_project_session("sighej-backend", [
    {"file_path": "main.py", "content": "<indhold>"}
])
DevOpsMCP-check_personal_standards(file_path="main.py")   # ingen error-findings
DevOpsMCP-analyze_complexity(file_path="main.py")          # max complexity: 8
DevOpsMCP-add_type_hints(file_path="main.py")              # min 80% coverage
DevOpsMCP-check_pep_compliance(file_path="main.py")        # zero violations

Regler:

• Ingen subprocess med shell=True — brug SDK-klienter
• Ingen bare except: — fang specifikke exceptions
• Kun f-strings — ingen % eller .format()
• Ingen mutable default-argumenter
• Ingen hardcodede secrets — kun env vars via pydantic-settings

Flutter app

• flutter analyze skal altid returnere No issues found!
• Alle BLE-kald skal guards af _bleAvailable
• Ingen direkte import af dart:io på web-paths

Git commits

Brug conventional commits:

feat(app): tilføj pulsanimation til toggle-knap
fix(backend): ret Redis TTL ved session-fornyelse
docs: opdater ARCHITECTURE.md med WebSocket flow

---

Arkitekturbeslutninger (ADR-resumé)

ADR	Beslutning	Begrundelse
ADR-001	Flutter frem for React Native	Native ARM, stabil BLE via direkte platform channels
ADR-002	FastAPI frem for Express/Django	Async-first, Pydantic validation, hurtig at bygge
ADR-003	Redis til sessions, ikke PostgreSQL	Ephemerelle data, auto-TTL, ingen manuel cleanup
ADR-004	Ingen in-app messaging	Nudget ER produktet — chat modarbejder formålet

---

Privacy-design

• Ingen bruger-ID'er — kun ephemerelle BLE tokens (UUID, ny pr. session)
• Ingen lokationsdata — BLE proximity er ikke GPS
• Server-side matching — apps ser aldrig hinandens rå profiler
• Auto-sletning — Redis TTL 2 timer, ingen data efterlades
• Aggregat-stats kun — PostgreSQL indeholder aldrig PII

---

Kendte begrænsninger (MVP)

• BLE advertising kræver fysisk Android/iOS-enhed — ikke tilgængeligt på macOS/web Flutter
• Web/macOS kører i demo mode: simulerer et match efter 3 sekunder
• Admin dashboard har ingen auth i MVP — bør tilføjes før produktion
• Ingen push notifications (FCM/APNs) endnu — nudge vises kun mens app er åben
• Android SDK + Xcode krævet for at bygge til mobile (se flutter doctor)

---

Kom i gang (ny maskine)

# Klon repo
git clone <repo-url> && cd SigHej

# Start backend infrastruktur
make up

# Flutter app i browser
cd app && flutter pub get && flutter run -d chrome --web-port 8080

# Flutter app på Android (kræver USB debugging + Android SDK)
flutter devices
flutter run -d <device-id>

Se Docs/ for detaljeret dokumentation om hvert komponent.