Home / journal / 2026-07-01

Daily Journal: 2026-07-01

Summary

Completed Milestone 0 of the Backend Residency and prepared the repository to begin Milestone 1.

BiteTrack

  • Moved health-check endpoints outside the versioned API namespace (/health, /healthz).
  • Added the initial router aggregation structure.
  • Added a placeholder users router under /api/v2/users.
  • Wrote a temporary probe.sh script for quickly verifying HTTP endpoints.
  • Simplified the development flake after discovering that premature LD_LIBRARY_PATH injection introduced runtime issues.
  • Verified:
  • docker compose up
  • FastAPI /docs
  • Ruff
  • Pyright
  • pytest

Backend Residency

  • Marked Milestone 0 as completed.
  • Updated ROADMAP.md.
  • Updated CURRENT.md.
  • Updated todo.md to begin Milestone 1.

Lessons Learned

Keep the devShell minimal

Avoid adding linker configuration until a package actually requires native libraries.

Infrastructure endpoints should not be versioned

Health checks belong outside /api/vX, allowing orchestrators and reverse proxies to probe the application independently from API versions.

Tomorrow

  • Begin Milestone 1.
  • Read FastAPI routing and Pydantic documentation.
  • Design the request/response schema for user registration.