Uno API Backend

uno er backend-applikasjonen i echo-web-mono. Den er skrevet i Go og brukes av web-applikasjonen og andre interne tjenester.

For et mer detaljert arkitekturdypdykk, se Uno Arkitektur.

Teknologi

Hovedteknologier

Go - programmeringsspråk for backend
Chi - HTTP routing
PostgreSQL - database
sqlx - utvidelse av database/sql for enklere databaseinteraksjon
Swag - Swagger/OpenAPI-generering

Arkitektur

Uno følger en DDD/hexagonal struktur:

domain/ - kjernelogikk, modeller og porter
http/ - router, routes, DTO-er og handlers
infrastructure/ - implementasjoner for database, logging og eksterne integrasjoner
bootstrap/ - kobler sammen avhengigheter
cmd/ - entrypoints (web, cron, worker)

Struktur

apps/uno/
├── bootstrap/           # Sette opp applikasjoner
├── cmd/
│   ├── web/             # HTTP API entrypoint
│   ├── cron/            # Cron jobs
│   └── worker/          # Bakgrunnsjobber
├── config/              # Miljø og konfigurasjon
├── domain/              # Domene, porter og services
├── http/                # Router, routes, handlers og DTO-er
├── infrastructure/      # Postgres, logging, telemetry, eksterne systemer
├── docs/                # Swagger/OpenAPI dokumentasjon
├── scripts/             # Nyttige scripts
└── testutil/            # Hjelpefunksjoner for tester

Lokale kommandoer

Kjør fra rotmappen:

# Start uno i dev-modus
pnpm --filter=uno dev

# Kjør tester
pnpm --filter=uno test

# Tester med coverage
pnpm --filter=uno test:coverage

# Installer Go-verktøy (air, swag, mockery)
pnpm --filter=uno tools:install

# Generer swagger og mocks
pnpm --filter=uno swag:init
pnpm --filter=uno mocks:generate

API og miljø

API kjører lokalt på port 8000 (styrt av UNO_API_PORT)
Web bruker typisk NEXT_PUBLIC_API_URL=http://localhost:8000
Uno bruker PostgreSQL lokalt via Docker-oppsettet i monorepoet

Vanlige oppgaver

Legge til en ny route

Legg route i apps/uno/http/routes/...
Implementer handler i apps/uno/http/handler/...
Kall service-lag i apps/uno/domain/service/...
Implementer evt. ny port/adapter i apps/uno/domain/port og apps/uno/infrastructure/...

Oppdatere API-dokumentasjon

pnpm --filter=@echo-webkom/uno swag:init