add architecture documentation and testing strategy

Co-authored-by: Copilot <copilot@github.com>
2026-04-27 18:19:40 +02:00
parent 5ea568aaf6
commit 5e24215ffe
14 changed files with 537 additions and 0 deletions
@@ -0,0 +1,12 @@
+# 11. Risks and Technical Debt
+
+A list of identified technical risks or technical debts, ordered by priority.
+
+> "Risk management is project management for grown-ups." — Tim Lister, Atlantic Systems Guild.
+
+| Priority | Risk / Technical Debt                          | Probability | Impact | Suggested Measures                                                       |
+| -------- | ---------------------------------------------- | ----------- | ------ | ------------------------------------------------------------------------ |
+| 1        | Dependency on openrouter.ai availability       | medium      | high   | Add fallback models; implement retry logic with exponential backoff      |
+| 2        | DuckDB schema changes break existing data      | low         | high   | Version migrations; backup strategy before upgrades                      |
+| 3        | Single-process DuckDB limits write concurrency | low         | medium | Monitor load; consider migration to PostgreSQL if needed                 |
+| 4        | JWT secret leak                                | low         | high   | Rotate secrets via environment variables; never commit to source control |