update

doc/core-apps/auth/features.md

@@ -1,4 +1,9 @@
-- auth
+- login user
+- register user 
+- chnage password 
+- 
+- 
+
 	- registration, login, refresh, logout, password change, own profile
 	- routes: POST /register, /login, /refresh, /logout, /change-password; GET/PUT /me
 	- events emit: user.registered, user.logged_in

doc/core-apps/auth/specs.md

@@ -1,3 +1,3 @@
-- __init__.py (router, on_load)
+- __init__.py: 
 - models.py (User, RefreshToken)
 - manifest.yaml

doc/core-apps/features.md

@@ -1,6 +1,4 @@
-- core-apps
+- auth
-	- shipped with the system, required for a functional shop
+	- manage users
-	- same mechanics as any other app (manifest.yaml, router, migrations, events, DI) — no special status in the loader
+	- login user
-	- typically declared `required: true` in manifest so they cannot be switched off
+	- register user  
-	- distinct from custom-apps (optional / third-party, not shipped)
-	- cover: auth, product catalog, cart, checkout, payment, orders, mail, shipment (planned), plus the AI layer (ai_core, ai_shop, ai_admin)

doc/core-apps/specs.md

@@ -1,11 +1,6 @@
 - auth 
-- catalog
+	- hashing: argon2
-- cart
+	- token: JWT (15m/30d)
-- checkout
+	- events
-- payment
+		- user.registered
-- orders
+		- user.logged_id
-- mail
-- ai_core
-- ai_shop
-- ai_admin
-- shipment (planned, not implemented)

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/features.md

@@ -0,0 +1 @@
+- setup für den shop 

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/specs.md

@@ -0,0 +1,7 @@
+- main — anwendung starten 
+- loader — apps laden
+- config — liest zugänge aus env
+- di — direkte apps kommunikation 
+- events — indirekte apps kommunikation
+- db — datenbank kommunikation
+- cache — redis kommunikation  

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/features.md

@@ -0,0 +1,2 @@
+- basis für apps 
+- sammelt logik der apps und führt sie aus  

doc/systems/specs.md

@@ -0,0 +1,11 @@
+- controller - routes und aktionen 
+- model - datenbank tabellen 
+- migration — migrationen
+- event - eigene events 
+- subscriber - listener  
+- setting — shop konfigurationen 
+- authentication — zugriff 
+- authorization — rechte
+- middleware — request und response filter
+- seed — faker daten  
+- i18n — übersetzungen  

doc/systems/subscriber/features.md

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

doc/systems/subscriber/specs.md

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