Overview
Engineering documentation for the KwadMarket FPV marketplace
KwadMarket is a specialized C2C marketplace for FPV drone gear: users buy and sell secondhand equipment against a rich product catalog scraped from French retail shops, with spec-based search, real-time chat and an admin moderation pipeline.
This site is the single home for all engineering documentation. It replaces the former fable/, opus/, doc/plan/ and cal.diy/ folders (full history in git).
Where to go
Architecture
Monorepo layout, apps, packages, ports and data flow.
Conventions
The rules every frontend and backend change must follow — read before building anything.
Remediation Plan
The remaining engineering work, ordered in phases 0–9 with acceptance criteria.
Best Practices
Gap analysis against cal.diy, an open-source project on the same stack.
Product Roadmap
Prioritized feature ideas plus detailed specs: payments, verification, delivery, and more.
Reviews
Audit and review history — how the codebase got to its current state.
State of the project (2026-07-02)
One-line summary
Frontend is healthy (maintenance-level work only); the backend carries the risk; main CI has been red since 2026-06-28 — plan phase 0 fixes that first.
| Area | Status |
|---|---|
apps/web frontend | ✅ Healthy — features/ structure, TanStack Query, RHF + zod, HttpOnly-cookie auth |
apps/back API | ⚠️ Functional but carries the technical debt — see the plan |
apps/scraper | ✅ Working — DFR + StudioSport sources, BullMQ jobs |
| CI | 🔴 Red since 2026-06-28 — phase 0 is the fix |
| Production launch | ⏳ Gated on plan phases 0–9 + the launch checklist |
How to use these docs
Building a feature? Read the matching conventions page first, copy an existing feature rather than inventing, and run the verification gates before declaring done.
Executing remediation work? Follow the plan in phase order — one PR per step, each phase links its detailed spec.
Designing a new feature? Check the roadmap for priority and the per-feature spec pages for data models and flows already thought through.