update

doc/core/authentication/features.md

@@ -1,6 +0,0 @@
-- authentication
-	- "who are you?"
-	- password hashing with argon2
-	- JWT (15 min access) with refresh (30 days)
-	- identity dependencies (current_user_claims, optional_user, get_current_user_id, oauth2_scheme)
-	- room for growth: OAuth/SSO, API-tokens for third-party apps, 2FA, refresh-token rotation, impersonation

doc/core/authentication/specs.md

@@ -1 +0,0 @@
-- authentication.py

doc/core/authorization/features.md

@@ -1,4 +0,0 @@
-- authorization
-	- "what are you allowed to do?"
-	- role checks (require_admin today)
-	- room for growth: require_role, require_permission, per-resource checks (owner-of), B2B approval workflows, per-app permissions for marketplace apps

doc/core/authorization/specs.md

@@ -1 +0,0 @@
-- authorization.py

doc/core/cache/features.md

@@ -1,5 +1,4 @@
-- cache
+- client für redis 
-	- shared read-store / cache client (Redis today)
+- kopie der datenbank 
-	- backend writes, frontend reads
+- anfragen gehen wenn möglich immer an redis, nie an datenbank 
-	- apps keep the cache in sync via event handlers (projectors), not the core client
+- änderungen in datenbank ändern auch immer redis 
-	- room for growth: CacheProvider abstraction so the read-store becomes swappable

doc/core/cache/specs.md

@@ -1 +1,3 @@
-- cache.py
+- redis_client.py 
+	- verbindung zu redis
+	- CRUD für redis 

doc/core/config/features.md

@@ -1,2 +1 @@
-- config
+- liest die env 
-	- read .env into Settings object

doc/core/config/specs.md

@@ -1 +1 @@
-- config.py
+- config.py - sicherheitskritische daten einlesen 

doc/core/db/features.md

@@ -1,4 +1,3 @@
-- db
+- verbindung zur datenbank herstellen 
-	- base setup for ORM
+- session aufbauen 
-	- use SQLAlchemy
+- Base definieren 
-	- provide get_db() dependency

doc/core/db/specs.md

@@ -1 +1,3 @@
 - db.py
+	- verwendet SQLAlchemy
+	- ORM 

doc/core/di/features.md

@@ -1,3 +1,2 @@
-- di
+- services registrieren 
-	- global register for services
+- services abrufen 
-	- no direct service import between apps

doc/core/events/features.md

@@ -1,5 +0,0 @@
-- events
-	- apps can react on events
-	- apps can emit events
-	- events persist in db (audit/replay)
-	- allow wildcard subscribe (e.g. product.*)

doc/core/events/specs.md

@@ -1 +0,0 @@
-- events.py

doc/core/i18n/features.md

@@ -1,2 +0,0 @@
-- i18n
-	- internationalisation helper for DE/EN text fields

doc/core/i18n/specs.md

@@ -1 +0,0 @@
-- i18n.py

doc/core/loader/features.md

@@ -1,6 +1,3 @@
-- loader
+- apps finden
-	- load apps as python module
+- reihenfolge nach abhängigkeit anpassen 
-	- discover apps/*/manifest.yaml
+- apps laden 
-	- order by app dependency (topological sort), circles not allowed
-	- check for conflicts
-	- mount each app router under /api/<app>

doc/core/main/features.md

@@ -1,5 +1,3 @@
-- main
+- einstiegspunkt
-	- entrypoint for backend
+- fastAPI bauen 
-	- build fastAPI
+- loader aufrufen 
-	- run loader on lifespan startup
-	- expose /health and core settings routes

doc/core/main/specs.md

@@ -1 +1 @@
-- main.py
+- event.py

doc/core/middleware/features.md

@@ -1,4 +0,0 @@
-- middleware
-	- central place to install FastAPI middlewares (install_middlewares(app))
-	- today: CORS (allowed origins from .env)
-	- room for growth: request-id, access logging, rate-limit, security headers (HSTS/CSP), compression

doc/core/middleware/specs.md

@@ -1 +0,0 @@
-- middleware.py

doc/core/migrations/features.md

@@ -1,5 +0,0 @@
-- migrations
-	- orchestrator (migrations.py): discover per-app migration folders (apps/<name>/migrations/), configure alembic version_locations dynamically, coordinate multi-head merging
-	- startup check: fail fast if schema is not up to date
-	- migrations/ directory: alembic version store (today still holds all migrations centrally; per-app folders are the target state)
-	- use alembic

doc/core/migrations/specs.md

@@ -1,2 +0,0 @@
-- migrations.py
-- migrations/ (Alembic version store)

doc/core/seed/features.md

@@ -1,2 +0,0 @@
-- seed
-	- demo data (admin, demo customer, categories, products)

doc/core/seed/specs.md

@@ -1 +0,0 @@
-- seed.py

doc/core/settings/features.md

@@ -1,6 +0,0 @@
-- settings
-	- key-value store for shop settings (runtime-changeable, e.g. shop_name, currency)
-	- postgres is source of truth
-	- mirrored to redis on write
-	- emits core.settings_updated event
-	- distinct from config (which only reads .env infrastructure values)

doc/core/settings/specs.md

@@ -1 +0,0 @@
-- settings.py

doc/systems/event/features.md

@@ -0,0 +1,3 @@
+- custom events aus den apps sammeln 
+- events persistieren 
+- helper methoden für events 

doc/systems/event/specs.md

@@ -0,0 +1 @@
+- event.py

doc/systems/subscriber/features.md

@@ -0,0 +1 @@
+- subscriber registrieren 

doc/systems/subscriber/specs.md

@@ -0,0 +1 @@
+- subscriber.py