docs(database): record MariaDB qualification and retirement gates
MariaDB persistence qualification / mariadb (push) Failing after 1m7s

This commit is contained in:
cesnimda
2026-10-24 01:52:03 +02:00
parent a2c9bda0d1
commit e75c4a4775
20 changed files with 14568 additions and 12 deletions
+7 -2
View File
@@ -8,7 +8,7 @@ Last verified: 2026-09-11 against the current repository.
flowchart LR
Browser --> Nginx[nginx static frontend]
Nginx --> API[ASP.NET Core API]
API --> DB[(SQLite or MariaDB/MySQL)]
API --> DB[(MariaDB)]
API --> Data[Data root: uploads, CV artifacts, exports, keys]
API --> AI[FastAPI AI service]
AI --> Local[local transformers/Ollama]
@@ -25,13 +25,18 @@ The frontend is a client-rendered React application inside a Next.js static-expo
|---|---|
| UI | Next.js 16, React 19, TypeScript 5.9, MUI 7, React Router 7 |
| API | ASP.NET Core 9, EF Core 9, ASP.NET Identity, JWT bearer, cookie sessions |
| Data | SQLite default; Pomelo MySQL/MariaDB provider for server deployments |
| Data | MariaDB standard for development/integration/CI/production; Pomelo 9.0.0, EF Core 9.0.14; explicit SQLite transition path retained pending safe retirement |
| AI | FastAPI, transformers/distilbart summarizer, OCR and document extractors, Ollama/Gemini/Groq CV routes |
| Runtime | Docker Compose, nginx 1.29-alpine, optional Ollama profile |
| Delivery | Gitea Actions → SSH deployment → Docker Compose |
Further detail: [frontend architecture](frontend.md), [backend architecture](backend.md), [data flow](data-flow.md), [integrations](integrations.md), [database schema](../database/schema.md), and [deployment](../infrastructure/deployment.md).
Database architecture decision updated 23 October 2026: production is owner-verified MariaDB
12.2.2, previously running floating `mariadb:latest`. The development/integration image is pinned
by version and verified registry manifest digest. [Standardisation record](../database/mariadb-standardisation/README.md)
separates actual runtime evidence, exact-image limits, remaining CI qualifications and staged SQLite retirement.
The older [architecture/current.md](current.md) path is retained as a compatibility pointer to this overview.
## Important boundaries