---

Description

Transparency is a core tenet of VeriWorkly. The Roadmap API exposes our internal development pipeline directly to the public. This allows the community (and our frontend client) to query upcoming features, track active progress, and view historical completion data.

Unlike the GitHub module (whose records originate from an external repository), roadmap entries are authored directly in our PostgreSQL database, and responses are Redis-cached for fast reads.

---

Query Parameters & Pagination

Because the roadmap will grow indefinitely over the lifecycle of the project, the list endpoint is heavily optimized for large datasets.

• Offset Pagination: Lists are paginated with a default page size of 20 and a hard maximum of 50 — a limit above 50 is rejected with 400, not clamped. You can page with either limit/offset or page/pageSize; the response echoes both, plus totalPages, hasMore, and a pagination block.
• Granular Filtering: Filter the pipeline by lifecycle status (todo, in-progress, done), and drop a specific entry with excludeId when building "related features" lists.
• Chronological Sorting: Sort via newest (default), oldest, or recently-completed.

---

Authentication

---

Available Endpoints

• GET /roadmap — List Roadmap Features
• GET /roadmap/stats — Fetch Roadmap Stats
• GET /roadmap/{id} — Get Feature Details