Architecture Decision Records¶

This section contains the architectural decisions for WikiMind. Each ADR documents a single significant decision, the alternatives considered, and the consequences.

Index¶

ADR	Title	Status
001	FastAPI + async SQLite for local-first daemon	Accepted
002	ARQ + fakeredis for job queue	Accepted
003	Multi-provider LLM router with fallback	Accepted
004	Plain markdown files + SQLite metadata	Accepted
005	Confidence-tagged claims	Accepted
006	Chunked compilation for large documents	Accepted
007	Structured JSON prompt contract	Accepted
008	Pydantic BaseSettings for configuration	Accepted
009	Decoupled ingest and compilation	Accepted
010	Auto-enable LLM providers when API key detected	Accepted
011	Conversational Q&A thread model	Accepted
012	Knowledge graph architecture	Accepted
013	react-force-graph-2d for knowledge graph	Proposed
014	Hybrid search with ChromaDB and sentence-transformers	Accepted
015	CPU-First Docker Packaging	Accepted
016	Article recompilation as first-class action	Accepted
017	Backlink enforcer as lint Phase 3	Accepted
018	Batched Contradiction Detection	Accepted
019	Runtime User Preferences via DB Override Table	Accepted
021	PostgreSQL compatibility for production	Accepted
022	Multi-User Authentication via OAuth2	Accepted
023	Production Container Architecture	Accepted
024	Gunicorn Autoscaling & Horizontal Readiness	Accepted
025	docling-serve Sidecar	Accepted