# stats-gateway

gRPC service collecting and publishing HTTP/TCP/DNS/TLS-handshake timing
metrics for two geo-distributed OpenSpeedTest nodes (FL — Finland, PL1 — Poland).
Powers the dashboard at <https://stats.projectshitpost.fun/>.

## Components

- **`cmd/server`** — gRPC server (TLS terminated by nginx, listens on loopback).
- **`cmd/collector`** — periodic prober (HTTP HEAD with httptrace), runs every 5 min via systemd timer.
- **`cmd/snapshot`** — generates `snapshot.json` for the dashboard, runs every 10 min.
- **`internal/probes`** — timing logic (DNS, TCP, TLS handshake, HTTP).
- **`internal/storage`** — SQLite WAL with embedded migrations.
- **`internal/service`** — gRPC handlers (`RecentResults`, `Aggregate`, `Tunnel`).
- **`proto/`** — protobuf definitions; generated Go in `gen/`.
- **`stats-site/`** — static dashboard (vanilla JS + canvas charts, no framework deps).
- **`psp-stats-cli/`** — Go CLI for querying the API.
- **`systemd/`** — ops units for running the service + timers.
- **`docs/AUTH.md`** — auth doc for the `Tunnel` method (Bearer JWT/HS256, used by internal CI agents).

## Build

    make build           # ./bin/{stats-gateway,stats-collector,stats-snapshot}
    make test
    cd psp-stats-cli && make build

## API

    grpcurl -d '{"node":"fl","limit":5}' \
      stats.projectshitpost.fun:443 stats.v1.SpeedStatus/RecentResults

See `proto/stats.proto`.

## License

MIT — see [LICENSE](./LICENSE).