# trainsim

Python train **simulation** for ATO integration tests. Circle track, simple physics, map UI.

## Layout

| Path | Role |
|------|------|
| `trainsim/` | API + physics |
| `config/` | Replaceable sim + track JSON |
| `spec/` | Interface contract (shared with `ato`) |
| `static/map.html` | Route map (nodes, edges, train dot) |

## Run locally

```bash
pip install -r requirements.txt
pytest -q
uvicorn trainsim.app:create_app --factory --host 0.0.0.0 --port 8080
```

Detailed simulation notes — *TODO*.