# Repo ja töövoog

## Projektid (Git: gogs.odamus.com, kasutaja `ardo`)

### `ardo/liiklusatlas` (aktive, veebirakendus + pipeline)
- `pipeline/` — analüüsiahel (4 skripti + run_municipality.py)
- `preprocess_web.py` — gpkg → GeoJSON kihid + raporti materjalid
- `municipalities.py` — 79 KOV-i register
- `server.py` — FastAPI (`/api/*`)
- `report.py` — PDF-raport (reportlab)
- `web/index.html` — MapLibre GL kaart
- `data/` — genereeritud GeoJSON + raportifailid (commititud)

### `ardo/Obsidian` — doktoritöö märkmed (koopiad)

### `ardo/ohmu-cron` — serverite varundusskriptid

## Lokaalne struktuur

```
Project/
  liiklussagedus/            # analüüsi algandmed + tulemused (ei ole git-is)
    results/                 # {prefix}_*.csv, {prefix}_*.png, {prefix}_qgis.gpkg
    cache/                   # OSMnx vahemälu
    data/                    # WorldPop raster
  liiklusatlas/              # GIT: veebirakendus + pipeline
```

## Analüüsitöövoog (uue valla lisamine)

```bash
# 1. Täisanalüüs (võtab 5–15 min olenevalt vallast)
PYTHONPATH=. .venv/bin/python3 liiklusatlas/pipeline/run_municipality.py <vall_id>

# 2. Veebiandmete genereerimine (GeoJSON + raport)
PYTHONPATH=. .venv/bin/python3 liiklusatlas/preprocess_web.py <vall_id>

# 3. Commit + push
cd liiklusatlas && git add -A && git commit -m "..." && git push

# 4. Redeploy
ssh ohmu     # cd /data/docker/liiklusatlas && git pull && docker-compose up -d --force-recreate
ssh hetzner  # cd ~/swarm/.../liiklusatlas && git pull && docker build -t liiklusatlas:latest . && docker service update --force atlas_liiklusatlas
```

## Valla-id → analüüsiparameetrid

`pipeline/run_municipality.py` KNOWN-tabelis: `vall_id → (place, prefix, area_km2)`.
Teadmata vallad: proovib `teedellm.config.MUNICIPALITIES` registrit.

## Väljundfailide konventsioon

- Analüüs: `liiklussagedus/results/{prefix}_*`
- Veeb: `liiklusatlas/data/web/{vall_id}/`, `liiklusatlas/data/report/{vall_id}/`
- Raporti failid saavad **standardnimed** (valga_pop_*.png jne), sisu on valla-spetsiifiline

## Seos

[[Liiklussageduse kaudne hindamine/04_Tehniline/Veebirakendus]]
[[Liiklussageduse kaudne hindamine/04_Tehniline/Deploy ja infrastruktuur]]