Freegle / Iznik / 21438

71%

push

circleci

docs(spatial): complete spatial-server docs + plain-English volunteer overview

Documentation for the spatial subsystem merged in #459:

- iznik-spatial-go/README.md (NEW): the KNN "finder" service had no README at
  all. Documents all six datasets, every public + admin endpoint, env vars,
  the nightly/15-min sync scheduler, SQLite index persistence, Docker wiring,
  callers, and the /swagger OpenAPI generation.
- iznik-routing-go/README.md: completeness pass — adds the five live endpoints
  that were undocumented (/v1/ripple-schedule, POST /v1/ripple-eval,
  /v1/posts-for-member, /v1/digest-simulator, /swagger), the
  ROUTING_DRIVE_SPEED_FACTOR env var, the JWT-on-external-port note, and a
  cross-link to the spatial service.
- SPATIAL-SERVERS.md (NEW, repo root): a non-technical, plain-English overview
  for volunteers/moderators/staff — what the two services do ("finder" +
  "travel-time mapper"), why they exist, fairness, and the rippling-out idea —
  with no code, linking down to the technical READMEs.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

10952 of 14552 branches covered (75.26%)

Branch coverage included in aggregate %.

118160 of 167938 relevant lines covered (70.36%)

35.47 hits per line