working dev environment

2026-06-18 08:29:03 +00:00
parent 6fc00b8ce9
commit 57b882128d
21 changed files with 200 additions and 210 deletions
@@ -31,6 +31,7 @@ See [README.md](README.md) for a full architecture map. Key files:
 - **Re-skin:** Edit colors in `_variables.scss` only.
 - **Add a page:** Create component folder → add route in `app.routes.ts` → add nav link (if needed).
 - **Update content (dev):** Run the API, then use Swagger UI at [http://localhost:8000/docs](http://localhost:8000/docs) to create/update content.
- **Update content (seed):** Edit [backend/seed.py](backend/seed.py) and run `docker compose exec api python seed.py`.
- **Run the app:** `docker compose up --build` → [localhost:4200](http://localhost:4200).
+- **Update content (seed):** Edit [backend/seed.py](backend/seed.py) and restart the API (autoseed runs on empty DB), or hit `curl -X POST http://localhost:8000/api/admin/reset` to re-seed.
+- **Run the app (dev):** From the `backend/` directory, set `KMTN_DATABASE_URL=sqlite+aiosqlite:///./kmountain.db`, then `uvicorn app.main:app --reload` + `ng serve` in parallel. Autoseed populates data on first run.
+- **Run the app (Docker):** `docker compose up --build` → [localhost:4200](http://localhost:4200).
 - **Build:** `ng build` → `dist/`, then `docker compose up --build -d` for full stack.