Add Visione backend foundation

2026-06-02 19:22:00 +02:00
commit 580789ac83
52 changed files with 5008 additions and 0 deletions
@@ -0,0 +1,23 @@
+# Visione Backend Architecture
+
+## Layout
+- `controllers/`: Drogon `HttpController` classes.
+- `services/`: application/business logic.
+- `repositories/`: database helpers and migrations.
+- `common/`: reusable HTTP, auth, crypto, email and validation utilities.
+- `migrations/`: versioned SQL files.
+- `docs/`: product, API, schema and milestone documentation.
+
+## Drogon Usage
+Controllers use Drogon route macros and return JSON with
+`HttpResponse::newHttpJsonResponse`. Database access uses Drogon's MySQL client
+with parameterized SQL placeholders.
+
+The codebase starts with raw SQL repositories because the schema is still
+evolving. Drogon ORM/codegen can be introduced later after the database model
+stabilizes.
+
+## Local Email
+OTP emails are sent to MailHog over SMTP. MailHog keeps messages local and
+inspectable through its web UI.
+