db + docker

.ai/PROJECT_MAP.md

@@ -3,7 +3,7 @@
 > Compressed view for AI Context. Generated automatically.
 
 - 📦 **generate_semantic_map** (`Module`) `[CRITICAL]`
-  - 📝 Scans the codebase to generate a Semantic Map and Compliance Report based on the System Standard.
+  - 📝 Scans the codebase to generate a Semantic Map, Module Map, and Compliance Report based on the System Standard.
   - 🏗️ Layer: DevOps/Tooling
   - 🔒 Invariant: All DEF anchors must have matching closing anchors; TIER determines validation strictness.
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
@@ -71,35 +71,50 @@
       - 📝 Generates the token-optimized project map with enhanced Svelte details.
     - ƒ **_write_entity_md** (`Function`) `[CRITICAL]`
       - 📝 Recursive helper to write entity tree to Markdown with tier badges and enhanced details.
+    - ƒ **_generate_module_map** (`Function`) `[CRITICAL]`
+      - 📝 Generates a module-centric map grouping entities by directory structure.
+      - ƒ **_get_module_path** (`Function`)
+        - 📝 Extracts the module path from a file path.
+      - ƒ **_collect_all_entities** (`Function`)
+        - 📝 Flattens entity tree for easier grouping.
   - ƒ **to_dict** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+- 📦 **TransactionCore** (`Module`) `[CRITICAL]`
+  - 📝 Core banking transaction processor with ACID guarantees.
+  - 🏗️ Layer: Domain (Core)
+  - 🔒 Invariant: Negative transfers are strictly forbidden.
+  - 🔗 DEPENDS_ON -> `[DEF:Infra:PostgresDB]`
+  - 🔗 DEPENDS_ON -> `[DEF:Infra:AuditLog]`
+  - ƒ **execute_transfer** (`Function`)
+    - 📝 Atomically move funds between accounts with audit trails.
+    - 🔗 CALLS -> `atomic_transaction`
 - 📦 **PluginExampleShot** (`Module`)
   - 📝 Reference implementation of a plugin following GRACE standards.
-  - 🔗 IMPLEMENTS -> `[DEF:Std:Plugin]`
+  - 🏗️ Layer: Domain (Business Logic)
+  - 🔒 Invariant: get_schema must return valid JSON Schema.
+  - 🔗 INHERITS -> `PluginBase`
   - ƒ **get_schema** (`Function`)
     - 📝 Defines input validation schema.
   - ƒ **execute** (`Function`)
-    - 📝 Core plugin logic with structured logging and progress reporting.
+    - 📝 Core plugin logic with structured logging and scope isolation.
   - ƒ **id** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
-  - ƒ **name** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **description** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
-  - ƒ **version** (`Function`) `[TRIVIAL]`
-    - 📝 Auto-detected function (orphan)
 - 📦 **BackendRouteShot** (`Module`)
   - 📝 Reference implementation of a task-based route using GRACE-Poly.
+  - 🏗️ Layer: Interface (API)
+  - 🔒 Invariant: TaskManager must be available in dependency graph.
   - 🔗 IMPLEMENTS -> `[DEF:Std:API_FastAPI]`
   - ƒ **create_task** (`Function`)
     - 📝 Create and start a new task using TaskManager. Non-blocking.
     - 🔗 CALLS -> `task_manager.create_task`
-- 🧩 **FrontendComponentShot** (`Component`)
-  - 📝 Reference implementation of a task-spawning component using
-  - 🏗️ Layer: UI
+- 🧩 **FrontendComponentShot** (`Component`) `[CRITICAL]`
+  - 📝 Action button to spawn a new task with full UX feedback cycle.
+  - 🏗️ Layer: UI (Presentation)
+  - 🔒 Invariant: Must prevent double-submission while loading.
   - 📥 Props: plugin_id: any, params: any
   - ⬅️ READS_FROM `lib`
   - ⬅️ READS_FROM `t`
+  - ƒ **spawnTask** (`Function`)
 - 📦 **DashboardTypes** (`Module`) `[TRIVIAL]`
   - 📝 TypeScript interfaces for Dashboard entities
   - 🏗️ Layer: Domain
@@ -746,6 +761,7 @@
   - 🏗️ Layer: UI
   - ⚡ Events: cancel, resume
   - ➡️ WRITES_TO `props`
+  - ➡️ WRITES_TO `state`
   - ⬅️ READS_FROM `effect`
   - ƒ **handleSubmit** (`Function`)
     - 📝 Validates and dispatches the passwords to resume the task.

.ai/ROOT.md

@@ -30,6 +30,7 @@ Use these for code generation (Style Transfer).
     *   Ref: `.ai/shots/critical_module.py` -> `[DEF:Shot:Critical_Module]`
 
 ## 3. DOMAIN MAP (Modules)
+*   **Module Map:** `.ai/MODULE_MAP.md` -> `[DEF:Module_Map]`
 *   **Project Map:** `.ai/PROJECT_MAP.md` -> `[DEF:Project_Map]`
 *   **Backend Core:** `backend/src/core` -> `[DEF:Module:Backend_Core]`
 *   **Backend API:** `backend/src/api` -> `[DEF:Module:Backend_API]`