rm-hull / next-departures-api / 25045689118

28%

push

github

feat: implement NaPTAN stop search REST API (#1)

Initialize project with a Gin-based web server and a CLI tool for
importing National Public Transport Access Nodes (**NaPTAN**) data into
**SQLite**.

This service allows clients to query public transport access points
within specific geographical bounding boxes.

**Key Features:**
- Geographical search via `bbox` query parameters.
- Automated CSV data ingestion from **GOV.UK** sources.
- Integrated **Prometheus** metrics and **Sentry** error tracking.
- Health checks and `pprof` debugging support.
- **Docker** and **GitHub Actions** CI/CD configuration.

```mermaid
sequenceDiagram
    actor User
    participant API as Gin API Server
    participant Repo as SQLite Repository
    participant DB as SQLite DB

    User->>API: GET /search?bbox=min_lat,min_lng...
    API->>Repo: Search(boundingBox)
    Repo->>DB: SELECT * FROM naptan WHERE latitude/longitude BETWEEN ...
    DB-->>Repo: Row data
    Repo-->>API: []SearchResult
    API-->>User: JSON (results + attribution + last_updated)
```

62 of 808 new or added lines in 12 files covered. (7.67%)

62 of 808 relevant lines covered (7.67%)

0.08 hits per line