---
name: footprint_geo_stack
lang: bash
domain: infra
version: 0.1.0
description: "Stack Docker para footprint geo: PostGIS 16-3.4 + Martin tile server + Valhalla. Datos de tiles montados desde DataProyects."
tags: [docker, service, geo, valhalla, postgis]
uses_functions: []
uses_types: []
entry_point: "docker-compose.yml"
dir_path: "apps/footprint_geo_stack"
service:
  port: 3000
  health_endpoint: /health
  health_timeout_s: 5
  systemd_unit: null
  systemd_scope: null
  restart_policy: always
  runtime: docker-compose
  pc_targets:
    - aurgi-pc
  is_local_only: false
---

# footprint_geo_stack

Stack Docker para servicios geo del proyecto footprint_aurgi:

- **PostGIS 16-3.4** — base de datos espacial en :5432
- **Martin** — tile server MVT en :3000
- **Valhalla** — routing engine en :8002

## Levantar

```bash
cd apps/footprint_geo_stack
docker compose up -d
```

## Parar

```bash
docker compose down
```

## Puertos expuestos

| Servicio | Puerto | Descripcion |
|----------|--------|-------------|
| PostGIS  | 5432   | postgres://geoserver:geoserver@localhost:5432/gis |
| Martin   | 3000   | http://localhost:3000 (webUI habilitado) |
| Valhalla | 8002   | http://localhost:8002 (route, isochrone, matrix) |

## Datos

Los tiles de Valhalla se montan desde:
`/home/lucas/DataProyects/footprint_aurgi/better_maps/data` → `/custom_files`

Contiene `valhalla_tiles.tar`, `admin_data`, `timezone_data` y la PBF de Espana.
NO se rebuilden los tiles (`force_rebuild: False`).

## Health checks

```bash
# PostGIS
docker exec better_maps_postgis pg_isready -U geoserver -d gis

# Martin
curl -sf http://localhost:3000/health

# Valhalla
curl -s -X POST http://localhost:8002/route \
  -H 'Content-Type: application/json' \
  -d '{"locations":[{"lat":40.4168,"lon":-3.7038},{"lat":41.3874,"lon":2.1686}],"costing":"auto"}'
```


## Capability growth log

Una linea por bump SemVer. Bump-type segun `.claude/commands/version.md`:
- `major`: breaking observable (CLI args, schema BBDD propia, formato wire).
- `minor`: feature aditiva (nuevo panel, endpoint, opcion).
- `patch`: bugfix sin cambio observable.

- v0.1.0 (2026-05-18) — baseline.