docs(all): Use Docker Compose as primary Quick Start, rename docker scripts

Make Docker Compose the default development path in the README with a
note about hot reload support. Remove the separate Local Development
section. Rename docker:up to docker:db:up to clarify they only start
PostgreSQL.

Author: claude

AGENTS.md

@@ -53,8 +53,8 @@ pnpm check                    # Lint + format
 pnpm test                     # Run all tests
 
 # Docker
-pnpm docker:up                # Start database
-pnpm docker:down              # Stop database
+pnpm docker:db:up             # Start PostgreSQL + PostGIS
+pnpm docker:down              # Stop docker stack
 ```
 
 ## Quick Reference

README.md

@@ -13,14 +13,12 @@ A self-hostable web application for relationship management. Think of it as your
 ## Quick Start
 
 ```bash
-# Prerequisites: Node.js 24+, pnpm 8+, PostgreSQL 18+ (or Docker)
-pnpm install
-pnpm docker:up
-pnpm migrate
-pnpm dev
+docker compose up -d
+docker compose exec backend pnpm migrate
+docker compose exec backend pnpm seed    # Optional: populate with sample data
 ```
 
-Frontend runs at `http://localhost:5173`, backend at `http://localhost:3000`.
+The app is available at `http://localhost:8080` (nginx reverse proxy). This setup also works well for development — source code is mounted into the containers with hot reload enabled.
 
 ## Documentation
 

docs/development.md

@@ -37,7 +37,7 @@ pnpm pgtyped:watch          # Watch and regenerate types
 pnpm seed                   # Seed database with test data
 
 # Docker
-pnpm docker:up              # Start Docker services
+pnpm docker:db:up           # Start PostgreSQL + PostGIS
 pnpm docker:down            # Stop Docker services
 ```
 

package.json

@@ -25,8 +25,8 @@
     "pgtyped": "pnpm --filter backend run pgtyped",
     "pgtyped:watch": "pnpm --filter backend run pgtyped:watch",
     "seed": "pnpm --filter backend run seed",
-    "docker:up": "docker-compose up -d",
-    "docker:down": "docker-compose down",
+    "docker:db:up": "docker compose up postgres -d",
+    "docker:down": "docker compose down",
     "prepare": "husky && pnpm --filter frontend run sync",
     "release": "semantic-release",
     "version:sync": "node scripts/sync-versions.mjs",