allucanget/ai.allucanget.biz
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: update documentation, adjust numbering of arc42 files

Browse Source
This commit is contained in:
zwitschi
2026-05-30 19:51:30 +02:00
parent 29c13edb4d
commit aa0f79fe75
14 changed files with 135 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/02-constraints.md
+26
View File
@@ -0,0 +1,26 @@
# 2. Architecture Constraints
Any requirement that constrains software architects in their freedom of design and implementation decisions or decision about the development process. These constraints sometimes go beyond individual systems and are valid for whole organizations and companies.
## Technical Constraints
| Constraint | Background / Motivation |
| ----------------------------- | ------------------------------------------- |
| Must run on Windows and Linux | Cross-platform developer environments |
| FastAPI for backend | Async performance, OpenAPI support |
| Flask for frontend | Lightweight UI serving |
| DuckDB as embedded database | Lightweight, no separate DB server required |
| External AI via openrouter.ai | Unified access to multiple AI models |
## Organizational Constraints
| Constraint | Background / Motivation |
| ----------------- | --------------------------------- |
| Open source stack | Cost reduction, community support |
## Conventions
| Convention | Background / Motivation |
| -------------------- | --------------------------------------------------- |
| Python 3.12+ | Modern language features, type hints |
| pytest for all tests | Consistent test tooling across backend and frontend |