documentation updates

This commit is contained in:
2026-07-17 16:27:06 -07:00
parent 465e7cb9fb
commit 19eb0aee07
2 changed files with 27 additions and 15 deletions
+14 -8
View File
@@ -89,12 +89,18 @@ Admin users can create mobile build requests, upload platform signing files, run
- Build artifact generation only (`.aab` and `.ipa`).
- No automatic App Store Connect / Google Play upload.
## Common tasks
## Deployment
- **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 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 (dev container):** Reopen in Container via VS Code.
- **Build:** `ng build``dist/`.
The project uses a single parameterized `docker-compose.yml` driven by customer-specific `.env` files in the `customers/` directory.
**Deploy all customers:**
```bash
./deploy-all.sh
```
**Deploy a specific customer:**
```bash
docker compose --env-file customers/.env.<customer_name> -p <customer_name> up -d --build
```
*Note: Multiple legacy `docker-compose.yml` files have been removed in favor of this template system.*