':?' made docker compose config/up fail whenever .env was absent (fresh
clone, different working dir, Docker Desktop UI). Falls back to a
documented dev password; prod must still set a real one.
- web: nginx:alpine serving the static SPA, listens on WEB_CONTAINER_PORT
rendered from deploy/nginx.conf.template (envsubst), gzip + cache headers,
/healthz, proxies /api/ to the api container
- api: julia:1.13-bookworm, libpq5 + curl, Pkg.instantiate from the committed
Manifest, listens on FARM_API_PORT, healthcheck on /api/v1/health
- db: postgres:17-alpine with 001_init.sql mounted for first-run schema,
pg_isready healthcheck, named volume
- every port comes from .env (container port + host port separated);
.env.example committed, .env ignored
Grounded in the actual repo state (3 overlapping frontend stacks, two
copies of each formula, no API wiring, no schema, no deploy path).
Documents target layout app/ (Vue 3 + Vite) + service/ (HTTP.jl) +
core/ offline fallback, engine-selection rule, API contract, data
contract, PWA strategy, security items and a 6-phase plan.
v0.1 kept in archive/.
- untrack ransomeware note, plaintext-password compose, contracts and farm accounting
- untrack 249 OS/browser artifacts (desktop.ini, *.download, *.url, *.tmp, *.zip)
- untrack unused template copies and saved web pages (---/, start Bootstrap/, freelancer, แรงบันดาลใจ/, home page/)
- .gitignore now documents what must stay tracked (source, data, icons, formula documents)
Files remain in the working tree; only the index changed.
- service/: Julia HTTP API (HTTP.jl + LibPQ), formulas.jl as source of truth
- service/db/001_init.sql: calculation_runs (append-only), provinces, eto_monthly
- tests/golden/vectors.json: single fixture set enforced on both JS and Julia
- .gitignore: keep secrets (DB env, contracts, financial records, ransomware note) out
- AGENTS.md: document service commands and formula-change rule