Title: docs: write docs/infra/docker.md — Docker Compose services, PostGIS requirement, port mapping, and common docker commands
Issue Summary
Documents the Docker Compose configuration in infra/backend/docker-compose.yml: the two services (postgres with PostGIS, Hasura), why PostGIS is required (GEOMETRY columns in apartments and hotels), port mapping (5433→5432, 8080→8080), the Docker network, volume persistence, and a reference of common Docker commands every contributor needs. Without this document contributors don't understand why docker compose down -v destroys all data and why the port is 5433 not 5432.
Type of Issue
Branch strategy
✅ docs/issue-N-docker → consolidation-pattern
Expected Behavior
Contributor must read:
cat infra/backend/docker-compose.yml
cat infra/backend/migrations/safetrust/1732588166945_create_apartments/up.sql | head -10
# observe: GEOMETRY(POLYGON, 4326) — requires PostGIS
docs/infra/docker.md covering:
1. Two services — postgres (postgis image) and graphql-engine, with key config
2. Why PostGIS — apartments GEOMETRY(POLYGON, 4326), hotels GEOGRAPHY(POINT, 4326)
3. Port table — host 5433 → container 5432, host 8080 → container 8080
4. Common commands table — up, down, down -v, logs, exec, ps
5. Internal vs external — localhost:5433 from host, postgres:5432 from inside Docker
6. Admin secret — dev value, change before production
Files to create
| File |
Approx lines |
docs/infra/docker.md |
~100 |
Make sure to follow the Git Guidelines for Atomic Commits and read Contributing Guide
Title:
docs: write docs/infra/docker.md — Docker Compose services, PostGIS requirement, port mapping, and common docker commandsIssue Summary
Documents the Docker Compose configuration in
infra/backend/docker-compose.yml: the two services (postgres with PostGIS, Hasura), why PostGIS is required (GEOMETRY columns in apartments and hotels), port mapping (5433→5432, 8080→8080), the Docker network, volume persistence, and a reference of common Docker commands every contributor needs. Without this document contributors don't understand whydocker compose down -vdestroys all data and why the port is 5433 not 5432.Type of Issue
Branch strategy
Expected Behavior
Contributor must read:
docs/infra/docker.mdcovering:1. Two services — postgres (postgis image) and graphql-engine, with key config
2. Why PostGIS — apartments
GEOMETRY(POLYGON, 4326), hotelsGEOGRAPHY(POINT, 4326)3. Port table — host 5433 → container 5432, host 8080 → container 8080
4. Common commands table — up, down, down -v, logs, exec, ps
5. Internal vs external —
localhost:5433from host,postgres:5432from inside Docker6. Admin secret — dev value, change before production
Files to create
docs/infra/docker.mdMake sure to follow the Git Guidelines for Atomic Commits and read Contributing Guide