From 17d14aae090ff0a367cd98c615b642cb413f2f34 Mon Sep 17 00:00:00 2001
From: Patrick Plate <pplate@fedora.fritz.box>
Date: Thu, 11 Jun 2026 09:02:14 +0200
Subject: [PATCH] docs(cannamanage): update wiki pages and sprint plans + brand
 pipeline doc

---
 docs/wiki/pages/CannaManage-02-UserStories.md |   37 +
 .../wiki/pages/CannaManage-03-Architecture.md |  140 +-
 docs/wiki/pages/CannaManage-04-Flowcharts.md  |    4 +-
 docs/wiki/pages/CannaManage-06-Wireframes.md  |  220 ++-
 docs/wiki/pages/CannaManage-09-Deployment.md  |  105 +-
 plans/cannabis-club-saas/SPRINT-1-PLAN.md     |  547 +++++++
 plans/cannabis-club-saas/docs/CHANGELOG.md    |   27 +-
 plans/cannamanage-brand-pipeline.md           | 1263 +++++++++++++++++
 8 files changed, 2181 insertions(+), 162 deletions(-)
 create mode 100644 plans/cannabis-club-saas/SPRINT-1-PLAN.md
 create mode 100644 plans/cannamanage-brand-pipeline.md

diff --git a/docs/wiki/pages/CannaManage-02-UserStories.md b/docs/wiki/pages/CannaManage-02-UserStories.md
index 103e553..830606a 100644
--- a/docs/wiki/pages/CannaManage-02-UserStories.md
+++ b/docs/wiki/pages/CannaManage-02-UserStories.md
@@ -464,4 +464,41 @@
 
 ---
 
+## Could Have — v2 (Additions)
+
+### US-026: Staff Member Management
+
+**As a** Club Admin, **I want to** create staff accounts with configurable permissions, **so that** my team members can do their work without having access to data they don't need (DSGVO principle of least privilege).
+
+**Priority:** Must Have (upgraded from Could Have — see note)
+**Acceptance Criteria:**
+- [ ] AC1: Admin can create staff accounts with email + temporary password
+- [ ] AC2: Admin assigns permissions per staff account from a defined permission set (`RECORD_DISTRIBUTION`, `VIEW_MEMBER_LIST`, `VIEW_MEMBER_QUOTA`, `ADD_MEMBER`, `VIEW_STOCK`, `RECORD_STOCK_IN`, `VIEW_COMPLIANCE_REPORT`, `MANAGE_GROW_CALENDAR`)
+- [ ] AC3: Pre-created role templates available: **Ausgabe** (distribution desk), **Lager** (stock/cultivation), **Vorstand** (board member)
+- [ ] AC4: Staff accounts cannot access billing, club settings, or staff management
+- [ ] AC5: All distributions recorded by staff include `recorded_by = staffUserId` in audit trail
+- [ ] AC6: Admin can deactivate a staff account; historical data is retained for audit purposes
+- [ ] AC7: Staff member sees only the navigation sections permitted by their granted permissions
+
+> **Note:** Promoted to core / Must Have. Staff management is not a v2 feature — clubs have multiple people involved from day one. DSGVO requires that each person only accesses data relevant to their function. Designing this post-MVP would require schema, API, and permission model rework.
+
+---
+
+### US-027: Grow Calendar
+
+**As a** Club Admin or authorised staff member, **I want to** maintain a cultivation calendar for each grow cycle, **so that** the club has a central record of what was planted, when to expect harvest, and the grow diary with notes and photos.
+
+**Priority:** Could Have (v2)
+**Acceptance Criteria:**
+- [ ] AC1: Admin/staff can create a grow entry with: strain name, planted date, expected harvest date, grow medium, notes
+- [ ] AC2: Grow entries are linked to a batch — when the harvest is registered as a batch, the grow entry is marked as completed
+- [ ] AC3: A grow diary allows adding timestamped notes and optional photos per grow entry
+- [ ] AC4: Grow calendar view shows a visual timeline of active grow cycles (Gantt-style or calendar grid)
+- [ ] AC5: Admin can set who has access to the grow calendar via staff permission `MANAGE_GROW_CALENDAR`
+- [ ] AC6: Photos are stored per-tenant and never exposed to members or other tenants
+
+**Notes:** The grow calendar bridges cultivation management and compliance — it provides provenance traceability from seed/clone to distributed batch. This directly supports §26 CanG batch traceability requirements for the origin of cultivated product. Photo attachments are a nice-to-have within this story; the core diary functionality is the v2 deliverable.
+
+---
+
 *Source: [STRATEGY.md](../STRATEGY.md) | Related: [01-PROJECT-CHARTER.md](./01-PROJECT-CHARTER.md)*
diff --git a/docs/wiki/pages/CannaManage-03-Architecture.md b/docs/wiki/pages/CannaManage-03-Architecture.md
index 2cabfda..9293c04 100644
--- a/docs/wiki/pages/CannaManage-03-Architecture.md
+++ b/docs/wiki/pages/CannaManage-03-Architecture.md
@@ -2,7 +2,7 @@
 
 **Project:** CannaManage — B2B SaaS for German Cannabis Social Clubs (Anbauvereinigungen)  
 **Phase:** 2 of 5 — Architecture & Data Model  
-**Stack:** Spring Boot 3.x (Java 21) · JPA/Hibernate · PostgreSQL · PrimeFaces JSF MVP → Next.js v2  
+**Stack:** Spring Boot 3.x (Java 21) · JPA/Hibernate · PostgreSQL · React/Vite (MVP) → Next.js v2
 **Last updated:** 2026-04-06
 
 ---
@@ -14,12 +14,12 @@ graph TD
     AdminBrowser["🖥️ Browser — Admin Portal"]
     MemberBrowser["🖥️ Browser — Member Portal"]
 
-    JSF["PrimeFaces / JSF Frontend\n(Spring MVC embedded)"]
+    Frontend["React/Vite Frontend\n(SPA — served by Nginx)"]
 
-    AdminBrowser -->|HTTP/S| JSF
-    MemberBrowser -->|HTTP/S| JSF
+    AdminBrowser -->|HTTPS| Frontend
+    MemberBrowser -->|HTTPS| Frontend
 
-    JSF -->|REST calls| Backend
+    Frontend -->|REST/JSON| Backend
 
     subgraph Backend ["☕ Spring Boot 3.x Application (Java 21)"]
         REST["REST API Layer\n/api/v1/"]
@@ -45,7 +45,7 @@ graph TD
         Nginx["🔒 Nginx\n(reverse proxy + TLS)"]
     end
 
-    JSF --> Nginx
+    Frontend --> Nginx
     Nginx --> Backend
 ```
 
@@ -53,8 +53,8 @@ graph TD
 
 | Component | Technology | Role |
 |---|---|---|
-| Admin Portal | PrimeFaces JSF (→ Next.js v2) | Club management UI |
-| Member Portal | PrimeFaces JSF (→ Next.js v2) | Member quota & history UI |
+| Admin Portal | React/Vite SPA (→ Next.js v2) | Club management UI |
+| Member Portal | React/Vite SPA (→ Next.js v2) | Member quota & history UI |
 | REST API | Spring Boot 3.x / Spring MVC | All business logic endpoints |
 | Auth | Spring Security 6 + JJWT | Stateless JWT authentication |
 | ORM | JPA / Hibernate 6 | Entity persistence, tenant filtering |
@@ -69,15 +69,47 @@ graph TD
 
 ## 2. Multi-Tenancy Strategy
 
-### Approach: Shared Schema with Row-Level Filtering
+### Decision: Schema-Per-Tenant
 
-Every JPA entity carries a `tenant_id` column (UUID, `NOT NULL`). A single PostgreSQL database hosts all clubs — row-level filtering enforces data isolation at the application layer.
+Each club gets its own PostgreSQL schema (e.g. `tenant_abc123`). A platform-level `public` schema holds only the `tenants` registry. Flyway runs per-schema migrations on onboarding.
 
-**Why shared schema (not separate schema/DB per tenant)?**
-- Lower operational overhead for an MVP with < 500 clubs
-- Single Flyway migration path across all tenants
-- Simpler connection pooling (one pool, not N)
-- Acceptable security risk when `tenant_id` filter is enforced at the service layer
+**Why schema-per-tenant, not shared schema?**
+
+A shared-schema approach (single table with `tenant_id` on every row) is operationally convenient in the short term but creates serious problems at scale:
+
+| Concern | Shared Schema | Schema-Per-Tenant |
+|---|---|---|
+| Data isolation | Application-layer only — one missing filter = data leak | Enforced at DB level — schemas are hard boundaries |
+| DSGVO compliance | Harder to prove isolation; one backup contains all clubs' data | Per-tenant pg_dump; each club's data is cleanly separable |
+| Deletion / right to erasure | Must `DELETE WHERE tenant_id = ?` across every table | `DROP SCHEMA tenant_abc123 CASCADE` — clean and auditable |
+| Migrations | One migration path for all | Per-schema migration via Flyway `schemas` config; adds ~100ms per onboard |
+| Query performance | Cross-tenant index bloat on large shared tables | Smaller per-tenant tables; no cross-tenant contention |
+| Future per-club DB isolation | Requires full re-architecture | Trivial: move schema to dedicated DB server |
+| Operational overhead | Lower — one connection pool | Slightly higher — one pool per tenant (managed by HikariCP with pool-per-schema) |
+
+**Conclusion:** The shared-schema "MVP convenience" argument only holds for throwaway prototypes. For a compliance SaaS handling personal health-adjacent data (cannabis consumption records), schema-per-tenant is the correct design from Day 1. The migration complexity is manageable; the data isolation benefit is permanent.
+
+### Tenant Provisioning
+
+When a new club onboards:
+
+```
+POST /api/v1/admin/bootstrap
+  → TenantProvisioningService.provisionTenant(tenantId)
+       → CREATE SCHEMA tenant_{tenantId}
+       → Flyway.migrate(schema=tenant_{tenantId})   // applies all V*.sql
+       → INSERT INTO public.tenants (id, schema_name, onboarded_at, status)
+```
+
+### Tenant Resolution
+
+```
+HTTP Request
+    └─ Spring Security Filter: extract JWT → resolve tenant_id
+         └─ TenantContext.setCurrentTenant(tenantId)   // ThreadLocal
+              └─ DataSource routes to schema: SET search_path = tenant_{tenantId}
+                   └─ All queries execute in tenant's private schema
+```
 
 ### Tenant Resolution
 
@@ -88,51 +120,38 @@ HTTP Request
               └─ JPA @Where filter applied on every entity query
 ```
 
-### Code Pattern — Tenant-Aware Base Entity
+### Code Pattern — Schema Routing DataSource
 
 ```java
-// AbstractTenantEntity.java (pseudocode)
-@MappedSuperclass
-@FilterDef(
-    name = "tenantFilter",
-    parameters = @ParamDef(name = "tenantId", type = UUID.class)
-)
-@Filter(name = "tenantFilter", condition = "tenant_id = :tenantId")
-public abstract class AbstractTenantEntity {
+// TenantRoutingDataSource.java (pseudocode)
+public class TenantRoutingDataSource extends AbstractRoutingDataSource {
 
-    @Column(name = "tenant_id", nullable = false, updatable = false)
-    private UUID tenantId;
-
-    @PrePersist
-    void injectTenant() {
-        this.tenantId = TenantContext.getCurrentTenant();
+    @Override
+    protected Object determineCurrentLookupKey() {
+        return TenantContext.getCurrentTenant();  // returns tenant schema name
     }
 }
 ```
 
 ```java
-// TenantFilterInterceptor.java (pseudocode)
+// TenantInterceptor.java (pseudocode)
 @Component
-public class TenantFilterInterceptor implements HandlerInterceptor {
-
-    @Autowired EntityManager em;
+public class TenantInterceptor implements HandlerInterceptor {
 
     @Override
     public boolean preHandle(HttpServletRequest req, ...) {
-        UUID tenantId = TenantContext.getCurrentTenant();
-        Session session = em.unwrap(Session.class);
-        session.enableFilter("tenantFilter")
-               .setParameter("tenantId", tenantId);
+        String tenantId = JwtUtils.extractTenantId(req);
+        TenantContext.setCurrentTenant("tenant_" + tenantId);
         return true;
     }
 }
 ```
 
 **Invariants enforced:**
-- `tenant_id` is set at `@PrePersist` — never accepted from user input
-- `tenant_id` is `updatable = false` — cannot be changed after creation
-- Hibernate filter is enabled on every request thread before any query executes
-- All repository methods inherit the filter; raw JPQL queries must include `AND e.tenantId = :tenantId`
+- Every incoming request resolves its schema before any query runs
+- No entity has a `tenant_id` column — schema isolation replaces row-level filtering
+- Raw JDBC queries must be avoided; all access goes through JPA repositories with schema routing
+- The `public` schema contains only the tenants registry and platform-level config
 
 ---
 
@@ -148,10 +167,36 @@ public class TenantFilterInterceptor implements HandlerInterceptor {
 
 | Role | Description | Access |
 |---|---|---|
-| `ROLE_CLUB_ADMIN` | Club administrator | Full club management, all members, reports, distributions |
-| `ROLE_MEMBER` | Club member | Own quota, own distribution history |
+| `ROLE_CLUB_ADMIN` | Club administrator | Full club management, all members, reports, distributions, staff management |
+| `ROLE_STAFF` | Club staff member | Configurable subset of admin permissions — defined per staff account by the admin |
+| `ROLE_MEMBER` | Club member | Own quota, own distribution history (read-only) |
 | `ROLE_PREVENTION_OFFICER` | Designated prevention officer | Member under-21 reports, prevention data |
 
+> **Staff is a core feature, not an add-on.** Real clubs have multiple staff members (front desk, cultivation responsible, prevention officer designate) with different operational responsibilities. DSGVO requires that each staff member can only access data they need for their specific role. The `ROLE_STAFF` with configurable permission grants from the admin is designed from Phase 0 — retrofitting it later would require schema and API changes.
+
+### Staff Permission Model
+
+Admins configure staff permissions at account creation. Permissions are stored as a `JSONB` column `granted_permissions` on the `staff_accounts` table within the tenant schema.
+
+```java
+// Configurable staff permissions (granted by admin per staff account)
+public enum StaffPermission {
+    RECORD_DISTRIBUTION,      // can record distributions
+    VIEW_MEMBER_LIST,         // can view member roster
+    VIEW_MEMBER_QUOTA,        // can view individual member quota
+    ADD_MEMBER,               // can register new members
+    VIEW_STOCK,               // can view batch/strain inventory
+    RECORD_STOCK_IN,          // can add new batches
+    VIEW_COMPLIANCE_REPORT,   // can generate/download reports
+    MANAGE_GROW_CALENDAR      // can manage cultivation calendar entries
+}
+```
+
+Pre-created role templates (configurable by admin):
+- **Ausgabe** (Distribution desk): `RECORD_DISTRIBUTION`, `VIEW_MEMBER_LIST`, `VIEW_MEMBER_QUOTA`
+- **Lager** (Stock/cultivation): `VIEW_STOCK`, `RECORD_STOCK_IN`, `MANAGE_GROW_CALENDAR`
+- **Vorstand** (Board member): all permissions except staff management
+
 ### Service-Layer Authorization Example
 
 ```java
@@ -494,11 +539,12 @@ Flyway migrations run automatically on application startup (`spring.flyway.enabl
 
 | Decision | Choice | Rationale |
 |---|---|---|
-| Multi-tenancy | Shared schema + `tenant_id` | MVP simplicity; upgrade to schema-per-tenant possible later |
-| Frontend MVP | PrimeFaces JSF | Patrick's existing expertise; fastest path to working UI |
-| Frontend v2 | Next.js / React | Modern UX; deferred to avoid scope creep in MVP |
+| Multi-tenancy | Schema-per-tenant | Hard data isolation, DSGVO-clean deletion, no cross-tenant query risk |
+| Frontend MVP | React/Vite SPA | Modern stack; no JSF/PrimeFaces lock-in; easier to hire for; mobile-friendly from day 1 |
+| Frontend v2 | Next.js | SSR/ISR for SEO on marketing pages; same React codebase |
 | Auth | JWT (stateless) | No sticky sessions needed; horizontal scale ready |
 | PDF generation | iText 7 | Mature Java library; handles complex compliance report layouts |
 | Compliance enforcement | Service layer + DB constraint | Belt-and-suspenders: service validates, DB `UNIQUE` prevents duplicates |
 | Distribution immutability | `immutable = true`, no DELETE API | Audit trail integrity for regulatory compliance |
 | Hosting | Hetzner (Germany) | DSGVO compliance; low cost; German DC |
+| Staff roles | Core feature from Phase 0 | DSGVO requires least-privilege access; retrofitting post-MVP too costly |
diff --git a/docs/wiki/pages/CannaManage-04-Flowcharts.md b/docs/wiki/pages/CannaManage-04-Flowcharts.md
index 1e7dfa8..7dc1161 100644
--- a/docs/wiki/pages/CannaManage-04-Flowcharts.md
+++ b/docs/wiki/pages/CannaManage-04-Flowcharts.md
@@ -143,7 +143,7 @@ flowchart TD
 
     QUERY_DIST --> HAS_DATA{Any distributions\nin this period?}
 
-    HAS_DATA -->|No data| EMPTY_REPORT[Generate empty report\nwith zero totals\n(still valid compliance submission)]
+    HAS_DATA -->|No data| EMPTY_REPORT["Generate empty report\nwith zero totals\n(still valid compliance submission)"]
     HAS_DATA -->|Yes| AGG_MEMBER["Aggregate by member:\n• total_distributed_grams\n• number_of_visits\n• quota_usage_percent\n• is_under_21 flag"]
 
     EMPTY_REPORT --> AGG_STRAIN
@@ -174,7 +174,7 @@ flowchart TD
     SUBMIT --> FIND_USER["🔍 Spring Security:\nSELECT FROM users\nWHERE email = ?\nAND active = true"]
 
     FIND_USER --> USER_FOUND{User found?}
-    USER_FOUND -->|No| ERR_NOTFOUND[❌ Invalid credentials\n(generic — do not reveal\nwhether email exists)]
+    USER_FOUND -->|No| ERR_NOTFOUND["❌ Invalid credentials\n(generic — do not reveal\nwhether email exists)"]
     USER_FOUND -->|Yes| VERIFY_PW{BCrypt.verify\n(password, hash)\nmatches?}
 
     VERIFY_PW -->|No| ERR_PW[❌ Invalid credentials]
diff --git a/docs/wiki/pages/CannaManage-06-Wireframes.md b/docs/wiki/pages/CannaManage-06-Wireframes.md
index 53c804c..f7c6b2b 100644
--- a/docs/wiki/pages/CannaManage-06-Wireframes.md
+++ b/docs/wiki/pages/CannaManage-06-Wireframes.md
@@ -2,7 +2,7 @@
 
 **Phase 4a | Document 6 of 7**  
 **Date:** 2026-04-06  
-**Stack:** Spring Boot 3.x · PrimeFaces JSF · PostgreSQL
+**Stack:** Spring Boot 3.x · React/Vite SPA · PostgreSQL
 
 ---
 
@@ -45,24 +45,26 @@
 
 ### 1.3 Component Library
 
-All UI components come from **PrimeFaces 13.x** (JSF-based). No external React/Angular dependencies in MVP.
+The frontend is a **React/Vite SPA** with no PrimeFaces or JSF dependency. Component primitives come from [shadcn/ui](https://ui.shadcn.com/) (Radix UI + Tailwind CSS). This gives full control over styling, accessibility, and mobile responsiveness without JSF's lifecycle overhead.
 
-| Component | Usage |
-|---|---|
-| `p:panel` | Section containers, card wrappers |
-| `p:dataTable` with `p:column` | Tabular data: distributions, members, batches |
-| `p:paginator` | Pagination on all tables |
-| `p:inputText` | Single-line text fields |
-| `p:inputNumber` | Weight inputs (gram precision) |
-| `p:selectOneMenu` | Dropdown selects (member, strain, batch) |
-| `p:calendar` | Date range pickers for reports |
-| `p:progressBar` | Quota consumption display |
-| `p:commandButton` | Primary and secondary actions |
-| `p:confirmDialog` | Dangerous actions (recall, delete) |
-| `p:messages` / `p:message` | Inline validation errors |
-| `p:badge` | Status indicators (AVAILABLE, LOW, RECALLED) |
-| `p:sidebar` | Mobile nav drawer (member portal) |
-| `p:dialog` | Modal overlays |
+> **Why not PrimeFaces?** JSF/PrimeFaces is a server-side component model ill-suited to the modern REST API backend we're building. It tightly couples UI lifecycle to the backend, makes mobile responsiveness painful, and creates a hiring bottleneck. React is the right tool here. PrimeFaces is a fine choice for internal enterprise apps — not for a commercial SaaS.
+
+| Component | Library | Usage |
+|---|---|---|
+| `Card` / `Panel` | shadcn/ui | Section containers |
+| `DataTable` | TanStack Table v8 | Distributions, members, batches — virtualized |
+| `Pagination` | shadcn/ui Pagination | All tables |
+| `Input` | shadcn/ui Input | Single-line text fields |
+| `NumberInput` | react-number-format | Weight inputs (gram precision, min/max) |
+| `Select` | shadcn/ui Select | Dropdown selects (member, strain, batch) |
+| `DatePicker` | shadcn/ui Calendar | Date range pickers for reports |
+| `Progress` | shadcn/ui Progress | Quota consumption bar |
+| `Button` | shadcn/ui Button | Primary and secondary actions |
+| `AlertDialog` | shadcn/ui AlertDialog | Dangerous actions (recall) |
+| `Toast` | sonner | Success/error notifications |
+| `Badge` | shadcn/ui Badge | Status indicators (AVAILABLE, LOW, RECALLED) |
+| `Sheet` | shadcn/ui Sheet | Mobile nav drawer |
+| `Dialog` | shadcn/ui Dialog | Modal overlays |
 
 ### 1.4 Layout Grid
 
@@ -118,13 +120,13 @@ All UI components come from **PrimeFaces 13.x** (JSF-based). No external React/A
 
 #### Components & Behavior
 
-| Component | PrimeFaces | Behavior |
+| Component | Library | Behavior |
 |---|---|---|
-| KPI Cards | `p:panel` with custom CSS | Auto-refreshed via `@poll` every 60s |
-| Recent Distributions table | `p:dataTable` (5 rows, no paginator) | Row click → navigate to distribution detail |
-| Member column link | `p:commandLink` | Navigate to `/admin/members/{id}` |
-| `+ New Entry` button | `p:commandButton` style="primary" | Navigate to `/admin/distributions/new` |
-| Trend indicators | Custom CSS `<span>` | Green ▲ / Red ▼ with delta value |
+| KPI Cards | shadcn/ui Card | Auto-refreshed via `useQuery` (react-query, 60s stale) |
+| Recent Distributions table | TanStack Table (5 rows) | Row click → navigate to distribution detail |
+| Member column link | React Router `<Link>` | Navigate to `/admin/members/{id}` |
+| `+ New Entry` button | shadcn/ui Button variant="default" | Navigate to `/admin/distributions/new` |
+| Trend indicators | Tailwind `text-green-600` / `text-red-600` | ▲/▼ with delta value |
 
 ---
 
@@ -178,14 +180,14 @@ The quota progress bar updates live as the weight field changes (via `f:ajax eve
 
 #### Components & Behavior
 
-| Component | PrimeFaces | Behavior |
+| Component | Library | Behavior |
 |---|---|---|
-| Member search | `p:selectOneMenu` with `p:ajax` filter | Filters on type, shows name + member no. |
-| Strain/Batch dropdown | `p:selectOneMenu` | Populated after member selection; shows only `AVAILABLE` batches |
-| Weight input | `p:inputNumber` min=`0.1` max=`25.0` step=`0.1` | Triggers quota recalculation on blur |
-| Quota bar | `p:progressBar` with dynamic `value` | Color class applied via `styleClass` computed in backing bean |
-| Submit | `p:commandButton` | Disabled via `disabled="#{bean.quotaExceeded}"` |
-| Cancel | `p:link` | Returns to distribution log without saving |
+| Member search | shadcn/ui Combobox | `useQuery` debounced search; shows name + member no. |
+| Strain/Batch dropdown | shadcn/ui Select | Populated after member selection; filters `AVAILABLE` batches |
+| Weight input | react-number-format | min=0.1 max=25.0 step=0.1; triggers quota recalculation via `onChange` |
+| Quota bar | shadcn/ui Progress | Color class via `cn()` utility computed in component state |
+| Submit | shadcn/ui Button | `disabled={quotaExceeded}` from react state |
+| Cancel | React Router `<Link>` | Returns to distribution log without saving |
 
 ---
 
@@ -229,15 +231,15 @@ The quota progress bar updates live as the weight field changes (via `f:ajax eve
 
 #### Components & Behavior
 
-| Component | PrimeFaces | Behavior |
+| Component | Library | Behavior |
 |---|---|---|
-| Strain filter | `p:inputText` with `filterBy` | Filters table client-side on keyup |
-| Status filter | `p:selectOneMenu` | Filters table rows by status value |
-| Batch table | `p:dataTable` lazy=`true` | Server-side pagination, 10 rows/page |
-| Status badge | Custom CSS `<span class="badge badge-{status}">` | Icon + text label (not color alone) |
-| Recall button | `p:commandButton` styleClass=`p-button-danger` | Opens `p:confirmDialog` before executing |
-| Confirm dialog | `p:confirmDialog` | "Recall batch B-12 (OG Kush, 850g)? This cannot be undone." |
-| Add Batch | `p:commandButton` | Opens `p:dialog` with batch entry form |
+| Strain filter | shadcn/ui Input | Filters TanStack table client-side via `columnFilters` state |
+| Status filter | shadcn/ui Select | Filters table rows by status value |
+| Batch table | TanStack Table | Server-side pagination via `manualPagination`, 10 rows/page |
+| Status badge | shadcn/ui Badge variant mapped | Icon + text label (not color alone) |
+| Recall button | shadcn/ui Button variant="destructive" | Opens shadcn/ui AlertDialog before executing |
+| Confirm dialog | shadcn/ui AlertDialog | "Recall batch B-12 (OG Kush, 850g)? This cannot be undone." |
+| Add Batch | shadcn/ui Button | Opens shadcn/ui Dialog with batch entry form |
 
 ---
 
@@ -287,15 +289,15 @@ The quota progress bar updates live as the weight field changes (via `f:ajax eve
 
 #### Components & Behavior
 
-| Component | PrimeFaces | Behavior |
+| Component | Library | Behavior |
 |---|---|---|
-| Month selector | `p:selectOneMenu` | Months Jan–Dec |
-| Year selector | `p:selectOneMenu` | Current year ± 2 |
-| Generate button | `p:commandButton` | Calls report service; shows spinner; renders PDF thumbnail |
-| PDF preview | `<iframe>` embedding `/report/preview?month=3&year=2026` | Generated by iText 7 in `cannamanage-report` module |
-| Download PDF | `p:commandButton` | Streams PDF response from REST endpoint |
-| Download CSV | `p:commandButton` | Streams CSV response (member-level data) |
-| Summary table | `p:dataTable` | Computed compliance metrics; zero violations = green row |
+| Month selector | shadcn/ui Select | Months Jan–Dec |
+| Year selector | shadcn/ui Select | Current year ± 2 |
+| Generate button | shadcn/ui Button | Calls report API; shows loading spinner; renders PDF thumbnail |
+| PDF preview | `<iframe>` embedding `/api/v1/reports/preview?month=3&year=2026` | Generated by iText 7 backend |
+| Download PDF | shadcn/ui Button | `window.open(reportUrl)` — streams PDF from REST endpoint |
+| Download CSV | shadcn/ui Button | `window.open(csvUrl)` — streams CSV from REST endpoint |
+| Summary table | TanStack Table | Compliance metrics; zero violations row has `text-green-600` |
 
 ---
 
@@ -354,12 +356,12 @@ Quantities, batch codes, and THC/CBD percentages are **not exposed** in the memb
 
 #### Components & Behavior
 
-| Component | PrimeFaces | Behavior |
+| Component | Library | Behavior |
 |---|---|---|
 | Quota circle | Custom CSS radial progress (`conic-gradient`) | Computed from monthly total; color matches threshold rules |
-| Quota bar | `p:progressBar` | Same color logic as admin distribution form |
-| History table | `p:dataTable` | Last 10 distributions; sorted newest first; no pagination in MVP |
-| Strains table | `p:dataTable` | `status` column: text + icon only, no quantities |
+| Quota bar | shadcn/ui Progress | Same color logic as admin distribution form |
+| History table | TanStack Table | Last 10 distributions; sorted newest first; no pagination in MVP |
+| Strains table | TanStack Table | `status` column: text + icon only, no quantities |
 
 ---
 
@@ -367,6 +369,64 @@ Quantities, batch codes, and THC/CBD percentages are **not exposed** in the memb
 
 > *No mockup image — ASCII wireframe only.*
 
+---
+
+### Screen 7 — Staff Management (Admin)
+
+> *Core feature — not deferred to v2.*
+
+#### ASCII Wireframe
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  🌿 CannaManage          Grüne Oase Berlin e.V.   👤 Max M.  [⏻]   │
+├────────────┬────────────────────────────────────────────────────────┤
+│            │  Settings › Staff Members             [+ Add Staff]    │
+│  📊 Dashbrd│                                                         │
+│            │  ┌──────────────────────────────────────────────────┐  │
+│  👥 Members│  │  Name           │ Role Template │ Permissions │ Act│ │
+│            │  ├─────────────────┼───────────────┼─────────────┼────┤ │
+│  📋 Distrib│  │ Lisa Schmidt    │ Ausgabe       │ 3 of 8      │[✎][⛔]│
+│            │  │ Tom Weber       │ Lager         │ 4 of 8      │[✎][⛔]│
+│  📦 Stock  │  │ Sandra Müller   │ Vorstand      │ 7 of 8      │[✎][⛔]│
+│            │  └──────────────────────────────────────────────────┘  │
+│  📄 Reports│                                                         │
+│            │  ┌─── Add / Edit Staff ──────────────────────────────┐ │
+│  ✅ Complian│  │  Name: _______________  Email: _______________    │ │
+│            │  │                                                    │ │
+│  👤 Staff  │  │  Role Template: [ Ausgabe ▼ ]  (pre-fills below)  │ │
+│            │  │                                                    │ │
+│  ⚙ Settings│  │  Permissions:                                      │ │
+│            │  │  ☑ Record Distribution    ☑ View Member List      │ │
+│            │  │  ☑ View Member Quota      ☐ Add Member            │ │
+│            │  │  ☐ View Stock             ☐ Record Stock In       │ │
+│            │  │  ☐ View Compliance Report ☐ Manage Grow Calendar  │ │
+│            │  │                                                    │ │
+│            │  │  [ Save Staff Member ]  [ Cancel ]                │ │
+│            │  └────────────────────────────────────────────────────┘ │
+└────────────┴────────────────────────────────────────────────────────┘
+```
+
+#### Design Decisions
+
+- **Admin sees everything.** The staff management screen is only accessible with `ROLE_CLUB_ADMIN`. Staff accounts cannot modify their own permissions.
+- **DSGVO principle of least privilege.** Each staff member only sees the data their role requires. A distribution desk worker (`Ausgabe`) does not see cultivation calendar or full stock levels — only what they need to hand out product.
+- **Pre-created role templates** reduce admin setup time. Templates are editable — they just pre-fill the permission checkboxes.
+- **Staff ≠ reduced admin.** Staff accounts do not have access to billing, club settings, or staff management. Even a "Vorstand" staff member cannot create other staff accounts.
+- **Audit trail.** All distributions recorded by staff include `recorded_by = staffUserId` so it's clear who did what.
+
+#### Components & Behavior
+
+| Component | Library | Behavior |
+|---|---|---|
+| Staff table | TanStack Table | Shows name, role template, permission count, actions |
+| Role template dropdown | shadcn/ui Select | Pre-populates permission checkboxes on selection |
+| Permission checkboxes | shadcn/ui Checkbox | Individual overrides after template selection |
+| Save | shadcn/ui Button | POST/PUT `/api/v1/staff` with `{ permissions: [...] }` |
+| Deactivate | shadcn/ui Button variant="destructive" | Soft-deletes staff account; data retained for audit |
+
+---
+
 #### ASCII Wireframe
 
 ```
@@ -403,12 +463,12 @@ Quantities, batch codes, and THC/CBD percentages are **not exposed** in the memb
 
 #### Components & Behavior
 
-| Component | PrimeFaces | Behavior |
+| Component | Library | Behavior |
 |---|---|---|
-| Email field | `p:inputText` with `required="true"` | Bean Validation `@Email` |
-| Password field | `p:password` feedback=`false` | No strength meter on login |
-| Login button | `p:commandButton` | Submit form; shows `p:messages` on failure |
-| Error message | `p:messages` | "Invalid email or password." (never specific about which field failed) |
+| Email field | shadcn/ui Input type="email" | HTML5 validation + react-hook-form `@Email` |
+| Password field | shadcn/ui Input type="password" | No strength meter on login |
+| Login button | shadcn/ui Button | Submit via react-hook-form; shows error toast on failure |
+| Error message | sonner toast | "Invalid email or password." (never specific about which field failed) |
 
 ---
 
@@ -419,6 +479,7 @@ graph TD
     Root["CannaManage Root"]
     Root --> AdminPortal["Admin Portal /admin/"]
     Root --> MemberPortal["Member Portal /member/"]
+    Root --> StaffPortal["Staff Portal /staff/"]
 
     AdminPortal --> AdminDash["Dashboard (default)"]
     AdminPortal --> Members["Members"]
@@ -436,9 +497,14 @@ graph TD
     Reports --> RecallReport["Batch Recall Report"]
     AdminPortal --> Compliance["Compliance"]
     Compliance --> PreventionOfficer["Prevention Officer Info"]
+    AdminPortal --> StaffMgmt["Staff Members"]
+    StaffMgmt --> StaffList["Staff List"]
+    StaffMgmt --> StaffNew["Add/Edit Staff"]
     AdminPortal --> Settings["Settings"]
     Settings --> ClubProfile["Club Profile"]
 
+    StaffPortal --> StaffDash["Staff Dashboard\n(permissions-filtered)"]
+
     MemberPortal --> MemberDash["Dashboard / Quota"]
     MemberPortal --> DistHistory["Distribution History"]
     MemberPortal --> StockAvail["Stock Availability"]
@@ -460,7 +526,11 @@ graph TD
 | `/admin/reports/members` | Member data export | `ROLE_ADMIN` |
 | `/admin/reports/recall` | Recall report | `ROLE_ADMIN` |
 | `/admin/compliance` | Prevention officer | `ROLE_ADMIN` |
+| `/admin/staff` | Staff list | `ROLE_ADMIN` |
+| `/admin/staff/new` | Create staff account | `ROLE_ADMIN` |
+| `/admin/staff/{id}` | Edit staff permissions | `ROLE_ADMIN` |
 | `/admin/settings` | Club settings | `ROLE_ADMIN` |
+| `/staff/dashboard` | Staff home (permissions-filtered) | `ROLE_STAFF` |
 | `/member/dashboard` | Member quota view | `ROLE_MEMBER` |
 | `/member/distributions` | Personal history | `ROLE_MEMBER` |
 | `/member/stock` | Strain availability | `ROLE_MEMBER` |
@@ -469,34 +539,34 @@ graph TD
 
 ## 5. Responsive Design Notes
 
-### MVP (v1) — Desktop-First
+### MVP (v1) — Tailwind Breakpoints
 
-Target viewport: **1024px+**. PrimeFaces responsive grid (`p:panelGrid` with responsive columns, `ui-g-12 ui-md-6 ui-lg-4`) handles most layout adaptation down to tablet without custom media queries.
+The React/Vite SPA uses **Tailwind CSS** breakpoints throughout. The switch from PrimeFaces means we no longer depend on JSF's `ui-g-*` responsive grid — Tailwind's `sm:` / `md:` / `lg:` utilities apply cleanly to every component.
 
-| Breakpoint | Behavior |
-|---|---|
-| `≥ 1280px` | Full layout — sidebar + content side-by-side |
-| `1024–1279px` | Sidebar collapses to icon-only (60px); tooltips on hover |
-| `768–1023px` | Sidebar hidden; hamburger menu in top navbar |
-| `< 768px` | Admin portal degraded (tables scroll horizontally) |
+| Breakpoint | Tailwind prefix | Admin Portal | Member Portal |
+|---|---|---|---|
+| `≥ 1280px` | `xl:` | Full layout — sidebar + content | Two-column: quota left, history right |
+| `1024–1279px` | `lg:` | Sidebar collapses to icons (60px) | Two-column (narrower) |
+| `768–1023px` | `md:` | Sidebar hidden; hamburger sheet | Single-column, full-width cards |
+| `< 768px` | `sm:` / base | Admin: horizontal table scroll | Member: compact quota ring, condensed table |
 
 ### Member Portal — Mobile-First from Day One
 
-Members will typically check quota status on their phone. The member portal is designed mobile-first regardless of MVP/v2 timeline.
+Members will typically check quota status on their phone. The member portal uses `flex-col` mobile-first layout with `md:flex-row` for wider viewports — no breakpoint-specific class sprawl.
 
-| Breakpoint | Behavior |
-|---|---|
-| `≥ 1024px` | Two-column layout: quota circle left, history right |
-| `768–1023px` | Single-column, full-width cards |
-| `375–767px` | Single-column, compact quota ring, condensed table |
-| `< 375px` | Minimum supported; no horizontal scroll |
+### Responsive Conventions (React/Tailwind)
+
+- No inline styles — use Tailwind utilities exclusively
+- `cn()` utility (clsx + tailwind-merge) for conditional class composition
+- Tables on mobile: horizontal scroll wrapper `overflow-x-auto` on `<div>` wrapping `<table>`
+- All modals and sheets use `shadcn/ui Dialog` / `Sheet` — these are already mobile-friendly (viewport-aware positioning)
+- Touch targets: all interactive elements `min-h-[44px]` and `min-w-[44px]` per WCAG 2.5.5
 
 ### v2 Roadmap
 
 - PWA manifest + service worker (offline quota display)
-- 768px and 375px explicit breakpoints with design tokens
-- Touch-friendly `p:sidebar` for mobile member nav
 - Push notifications for low quota warnings
+- Per-club subdomain routing (`clubname.cannamanage.de`)
 
 ---
 
@@ -516,11 +586,11 @@ CannaManage targets **WCAG 2.1 AA** compliance across both portals.
 
 ### Screen Reader Support
 
-- All `p:inputText` / `p:inputNumber` fields have `<label>` with `for` attribute
+- All `Input` / `NumberInput` fields have `<label>` with `htmlFor` (React) — Radix UI enforces this automatically for shadcn/ui form fields
 - `aria-label` set on icon-only buttons (e.g., recall action column)
 - `aria-live="polite"` region on quota bar — announces percentage changes
 - `aria-describedby` links compliance warning messages to the weight input
-- PrimeFaces generates `role="grid"` and `aria-rowcount` on all data tables
+- TanStack Table exposes `role="grid"` and `aria-rowcount` via `getTableProps()`
 
 ### Color Independence
 
diff --git a/docs/wiki/pages/CannaManage-09-Deployment.md b/docs/wiki/pages/CannaManage-09-Deployment.md
index 7c81ed1..7d88e0d 100644
--- a/docs/wiki/pages/CannaManage-09-Deployment.md
+++ b/docs/wiki/pages/CannaManage-09-Deployment.md
@@ -3,7 +3,7 @@
 **Project:** CannaManage — B2B SaaS for German Cannabis Social Clubs  
 **Version:** 0.1.0-PLAN  
 **Date:** 2026-04-06  
-**Target environment:** Hetzner VPS — Ubuntu 22.04 LTS — Docker Compose
+**Target environment:** Hetzner VPS — Ubuntu 22.04 LTS — Docker Compose (Release) | TrueNAS.local — Docker (Build/CI)
 
 ---
 
@@ -45,20 +45,42 @@ Wildcard A record enables future per-club subdomains (`clubname.cannamanage.de`)
 
 ```mermaid
 graph TB
-    Internet["🌐 Internet"] -->|"port 80/443"| Nginx["Nginx (reverse proxy)"]
-    Nginx -->|"http://app:8080"| App["cannamanage-app\n(Spring Boot 3.x)"]
-    App -->|"jdbc:postgresql://db:5432"| DB["PostgreSQL 16\n(cannamanage DB)"]
-    LetsEncrypt["Let's Encrypt\n(certbot auto-renew)"] -.->|"TLS cert"| Nginx
-    Gitea["Gitea Actions\n(homelab CI)"] -->|"SSH + docker compose"| VPS["Hetzner VPS\n/opt/cannamanage"]
+    Dev["👨‍💻 Dev Workstation\n(Fedora, 192.168.188.x)"]
+    Gitea["🏠 Gitea\n(truenas.local:30008)"]
+    TrueNAS["🖧 TrueNAS.local Docker\n(192.168.188.119)\nBuild + Staging"]
+    Hetzner["☁️ Hetzner VPS CX21\nProduction Release"]
 
-    subgraph VPS ["Hetzner VPS — Docker network: cannamanage_net"]
-        Nginx
-        App
-        DB
+    Dev -->|"git push"| Gitea
+    Gitea -->|"Gitea Actions runner\n(on TrueNAS.local)"| TrueNAS
+    TrueNAS -->|"mvn package + docker build"| TrueNAS
+    TrueNAS -->|"docker save | scp\n(on merge to main)"| Hetzner
+
+    subgraph TrueNAS ["TrueNAS.local — CI/CD Build Environment"]
+        GiteaRunner["Gitea Actions Runner"]
+        BuildCache["Maven .m2 cache\n(persistent volume)"]
+        StagingDB["PostgreSQL staging\n(ephemeral)"]
     end
+
+    subgraph Hetzner ["Hetzner VPS — Production Release Environment"]
+        Nginx["Nginx (reverse proxy + TLS)"]
+        App["cannamanage-app\n(Spring Boot 3.x)"]
+        DB["PostgreSQL 16\n(persistent pgdata volume)"]
+        Nginx -->|"proxy_pass :8080"| App
+        App -->|"JDBC :5432"| DB
+    end
+
+    Internet["🌍 Internet HTTPS"] -->|"port 443"| Nginx
 ```
 
-All three services run on an internal Docker bridge network (`cannamanage_net`). Only Nginx is exposed to the public internet. PostgreSQL has no external port binding.
+### Environment Roles
+
+| Environment | Host | Purpose |
+|---|---|---|
+| **Development** | Dev workstation (Fedora) | Local feature development, unit tests |
+| **Build / CI** | TrueNAS.local Docker | Gitea Actions runner; Maven build; integration tests (Testcontainers); Docker image build |
+| **Production / Release** | Hetzner VPS CX21 | Live clubs, real data; Hetzner = our release environment |
+
+All three services on Hetzner run on an internal Docker bridge network (`cannamanage_net`). Only Nginx is exposed to the public internet. PostgreSQL has no external port binding.
 
 ---
 
@@ -351,12 +373,14 @@ curl https://app.cannamanage.de/actuator/health
 
 ---
 
-## 6. CI/CD Pipeline (Gitea Actions)
+## 6. CI/CD Pipeline (Gitea Actions on TrueNAS.local)
+
+The Gitea Actions runner runs **on TrueNAS.local** — this is our homelab build machine. It has Docker, a persistent Maven `.m2` cache volume, and direct SSH access to the Hetzner VPS. Builds happen locally; only the final artifact (Docker image tarball) is shipped to Hetzner.
 
 **File:** `.gitea/workflows/deploy.yml`
 
 ```yaml
-name: Deploy to Production
+name: Build and Deploy to Production
 
 on:
   push:
@@ -365,7 +389,7 @@ on:
 
 jobs:
   test:
-    runs-on: ubuntu-latest
+    runs-on: self-hosted   # <-- TrueNAS.local Gitea runner
     steps:
       - uses: actions/checkout@v4
 
@@ -381,25 +405,18 @@ jobs:
 
       - name: Run integration tests
         run: ./mvnw verify -P integration-tests
-        # Testcontainers requires Docker — GitHub/Gitea hosted runners have Docker pre-installed
+        # Testcontainers starts PostgreSQL via Docker on the TrueNAS runner
 
       - name: Coverage gate check
         run: ./mvnw verify -P coverage-check
 
   build-and-deploy:
     needs: test
-    runs-on: ubuntu-latest
+    runs-on: self-hosted   # <-- TrueNAS.local Gitea runner
     steps:
       - uses: actions/checkout@v4
 
-      - name: Set up JDK 21
-        uses: actions/setup-java@v4
-        with:
-          java-version: '21'
-          distribution: 'temurin'
-          cache: maven
-
-      - name: Build JAR
+      - name: Build JAR (production profile)
         run: ./mvnw package -DskipTests -P production
 
       - name: Build Docker image
@@ -412,13 +429,13 @@ jobs:
       - name: Save Docker image
         run: docker save cannamanage:${{ github.sha }} | gzip > /tmp/cannamanage.tar.gz
 
-      - name: Copy image to VPS
+      - name: Copy image to Hetzner VPS
         run: |
           scp -o StrictHostKeyChecking=no \
             /tmp/cannamanage.tar.gz \
             deploy@${{ secrets.HETZNER_IP }}:/tmp/cannamanage.tar.gz
 
-      - name: Deploy via SSH
+      - name: Deploy via SSH to Hetzner (Production Release)
         run: |
           ssh -o StrictHostKeyChecking=no deploy@${{ secrets.HETZNER_IP }} "
             set -e
@@ -435,23 +452,43 @@ jobs:
             sleep 10
             docker compose ps app | grep 'healthy' || (docker compose logs app --tail=50 && exit 1)
 
-            # Prune old images (keep last 3)
+            # Prune old images (keep last 3 SHAs)
             docker image prune -f
           "
+
+      - name: Cleanup local build artifact
+        run: rm -f /tmp/cannamanage.tar.gz
+```
+
+### Gitea Actions Runner on TrueNAS.local
+
+The self-hosted runner is a Docker container on TrueNAS.local:
+
+```bash
+# On TrueNAS.local — install Gitea Actions runner
+docker run -d \
+  --name gitea-runner-cannamanage \
+  --restart unless-stopped \
+  -v /var/run/docker.sock:/var/run/docker.sock \
+  -v /opt/gitea-runner/cannamanage:/data \
+  -v /opt/gitea-runner/.m2:/root/.m2 \    # Maven cache persisted across builds
+  -e GITEA_INSTANCE_URL=http://192.168.188.119:30008 \
+  -e GITEA_RUNNER_REGISTRATION_TOKEN=<token-from-gitea-settings> \
+  gitea/act_runner:latest
 ```
 
 ### Required Gitea Repository Secrets
 
-| Secret | Value |
-|--------|-------|
-| `HETZNER_IP` | VPS IPv4 address |
-| `SSH_PRIVATE_KEY` | Private key for `deploy` user |
+| Secret | Where set | Value |
+|--------|-----------|-------|
+| `HETZNER_IP` | Gitea repo secrets | Hetzner VPS IPv4 address |
+| `SSH_PRIVATE_KEY` | Gitea repo secrets | Private key for `deploy` user on Hetzner |
 
-Add deploy user's public key to VPS authorized_keys:
 ```bash
-# On VPS as deploy user
+# On Hetzner VPS — add TrueNAS runner's public key
+# (generate keypair on TrueNAS.local: ssh-keygen -t ed25519 -f ~/.ssh/gitea_runner_deploy)
 mkdir -p ~/.ssh && chmod 700 ~/.ssh
-echo "<gitea-actions-public-key>" >> ~/.ssh/authorized_keys
+echo "<truenas-runner-public-key>" >> ~/.ssh/authorized_keys
 chmod 600 ~/.ssh/authorized_keys
 ```
 
diff --git a/plans/cannabis-club-saas/SPRINT-1-PLAN.md b/plans/cannabis-club-saas/SPRINT-1-PLAN.md
new file mode 100644
index 0000000..085ffbb
--- /dev/null
+++ b/plans/cannabis-club-saas/SPRINT-1-PLAN.md
@@ -0,0 +1,547 @@
+# CannaManage — Sprint 1 Implementation Plan
+
+**Sprint:** 1 — Foundation  
+**Phase:** Phase 1 (Weeks 1–8 of Phase 0 Foundation)  
+**Author:** Lumen (architect mode), 2026-04-10  
+**Status:** Ready for Patrick's approval  
+
+---
+
+## Sprint Goal
+
+> **"Get the compliance engine running and fully tested — with zero production code and zero API yet."**
+
+Sprint 1 produces a compilable, testable Maven multi-module project with:
+- All core JPA entities modelled
+- Flyway V1 baseline migration SQL
+- `ComplianceService` implemented with 100% unit test coverage (TC-001 → TC-010)
+- A working local dev environment (Docker Compose: PostgreSQL + app)
+
+No UI, no REST API, no Stripe in Sprint 1. The compliance engine is the legal heart of the product — validate it first.
+
+---
+
+## Deliverables
+
+| # | Deliverable | Definition of Done |
+|---|------------|-------------------|
+| D1 | Maven multi-module project scaffold | `./mvnw clean verify` passes with no test failures |
+| D2 | `cannamanage-domain` module | All 8 JPA entities compile; `AbstractTenantEntity` wired |
+| D3 | Flyway `V1__initial_schema.sql` | Migration applies cleanly against PostgreSQL 16 |
+| D4 | `ComplianceService` | All 5 business methods implemented |
+| D5 | Unit test suite TC-001 → TC-010 | JaCoCo reports 100% line + branch coverage on `ComplianceService` |
+| D6 | Local dev `docker-compose.yml` | `docker compose up db` starts PostgreSQL; app connects cleanly |
+
+---
+
+## 1. Maven Multi-Module Structure
+
+```
+cannamanage/                          ← root POM (parent)
+├── pom.xml                           ← parent POM (BOM: Spring Boot 3.x, Java 21)
+│
+├── cannamanage-domain/               ← JPA entities, enums, constants
+│   └── src/main/java/de/cannamanage/domain/
+│       ├── entity/                   ← JPA entity classes
+│       ├── enums/                    ← MemberStatus, BatchStatus, etc.
+│       └── constants/
+│           └── ComplianceConstants.java
+│
+├── cannamanage-service/              ← Business logic, services (TESTED HERE)
+│   └── src/
+│       ├── main/java/de/cannamanage/service/
+│       │   ├── ComplianceService.java
+│       │   ├── dto/                  ← QuotaStatus, ComplianceCheckResult, etc.
+│       │   └── exception/           ← QuotaExceededException, MemberIneligibleException
+│       └── test/java/de/cannamanage/service/
+│           └── ComplianceServiceTest.java    ← TC-001 to TC-010
+│
+├── cannamanage-api/                  ← Spring Boot app entry point (REST controllers — Sprint 2)
+│   └── src/main/java/de/cannamanage/api/
+│       └── CannaManageApplication.java
+│
+└── docker-compose.yml               ← Local dev: PostgreSQL 16
+```
+
+### Parent POM key dependencies (BOM managed)
+
+```xml
+<!-- Spring Boot 3.3.x parent -->
+<parent>
+  <groupId>org.springframework.boot</groupId>
+  <artifactId>spring-boot-starter-parent</artifactId>
+  <version>3.3.4</version>
+</parent>
+
+<!-- Modules -->
+<modules>
+  <module>cannamanage-domain</module>
+  <module>cannamanage-service</module>
+  <module>cannamanage-api</module>
+</modules>
+
+<!-- Key managed versions -->
+<!-- Java 21, Hibernate 6.x (via Spring Boot BOM), Flyway 9.x -->
+<!-- JJWT 0.12.x (Sprint 2), iText 7 (Sprint 3), Stripe 25.x (Sprint 4) -->
+```
+
+---
+
+## 2. `cannamanage-domain` — JPA Entities
+
+### 2.1 `AbstractTenantEntity` (base class for all entities)
+
+```java
+// de.cannamanage.domain.entity.AbstractTenantEntity
+@MappedSuperclass
+@FilterDef(
+    name = "tenantFilter",
+    parameters = @ParamDef(name = "tenantId", type = UUID.class)
+)
+@Filter(name = "tenantFilter", condition = "tenant_id = :tenantId")
+public abstract class AbstractTenantEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.UUID)
+    private UUID id;
+
+    @Column(name = "tenant_id", nullable = false, updatable = false)
+    private UUID tenantId;
+
+    @Column(name = "created_at", nullable = false, updatable = false)
+    private Instant createdAt;
+
+    @PrePersist
+    void onCreate() {
+        this.tenantId = TenantContext.getCurrentTenant();  // ThreadLocal
+        this.createdAt = Instant.now();
+    }
+}
+```
+
+### 2.2 Entities to implement (Sprint 1)
+
+| Entity | Key fields | Notes |
+|--------|-----------|-------|
+| `Club` | id, name, licenseNumber, maxMembers, status | Root tenant aggregate |
+| `Member` | id, clubId, firstName, lastName, email, dob, membershipNumber, status, isUnder21 | `isUnder21` derived from DOB |
+| `Strain` | id, name, thcPercentage, cbdPercentage | Immutable once created |
+| `Batch` | id, strainId, quantityGrams, harvestDate, batchCode, status, contaminationFlag | status: AVAILABLE → EXHAUSTED / RECALLED |
+| `Distribution` | id, memberId, batchId, quantityGrams, distributedAt, recordedBy, notes | `@Column(updatable=false)` on all fields — immutable |
+| `MonthlyQuota` | id, memberId, year, month, totalDistributed, maxAllowed, version | `@Version` for optimistic lock |
+| `StockMovement` | id, batchId, movementType, quantityGrams, reason, createdAt | Audit journal |
+| `User` | id, memberId, email, passwordHash, role, lastLogin, active, refreshTokenHash | Login identity |
+
+### 2.3 `ComplianceConstants.java`
+
+```java
+// de.cannamanage.domain.constants.ComplianceConstants
+public final class ComplianceConstants {
+
+    // CanG §19(2) — adult limits
+    public static final BigDecimal ADULT_DAILY_LIMIT_GRAMS    = new BigDecimal("25.0");
+    public static final BigDecimal ADULT_MONTHLY_LIMIT_GRAMS  = new BigDecimal("50.0");
+
+    // CanG §19(3) — under-21 limits
+    public static final BigDecimal UNDER21_MONTHLY_LIMIT_GRAMS = new BigDecimal("30.0");
+
+    // CanG §19(4) — under-21 THC cap
+    public static final BigDecimal UNDER21_MAX_THC_PERCENTAGE  = new BigDecimal("10.0");
+
+    // Minimum membership age
+    public static final int MINIMUM_MEMBERSHIP_AGE = 18;
+
+    // Under-21 threshold
+    public static final int UNDER21_THRESHOLD_AGE  = 21;
+
+    private ComplianceConstants() {}
+}
+```
+
+---
+
+## 3. Flyway `V1__initial_schema.sql`
+
+Location: `cannamanage-api/src/main/resources/db/migration/V1__initial_schema.sql`
+
+```sql
+-- Clubs (root of tenant hierarchy)
+CREATE TABLE clubs (
+    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id       UUID NOT NULL,
+    name            VARCHAR(255) NOT NULL,
+    address         TEXT,
+    license_number  VARCHAR(100) NOT NULL UNIQUE,
+    max_members     INT NOT NULL DEFAULT 500,
+    status          VARCHAR(50) NOT NULL DEFAULT 'ACTIVE',
+    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Members
+CREATE TABLE members (
+    id                  UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id           UUID NOT NULL,
+    club_id             UUID NOT NULL REFERENCES clubs(id),
+    first_name          VARCHAR(100) NOT NULL,
+    last_name           VARCHAR(100) NOT NULL,
+    email               VARCHAR(255) NOT NULL,
+    date_of_birth       DATE NOT NULL,
+    membership_date     DATE NOT NULL DEFAULT CURRENT_DATE,
+    membership_number   VARCHAR(50) NOT NULL,
+    status              VARCHAR(50) NOT NULL DEFAULT 'ACTIVE',
+    is_under_21         BOOLEAN NOT NULL DEFAULT FALSE,
+    prevention_officer  BOOLEAN NOT NULL DEFAULT FALSE,
+    created_at          TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    UNIQUE(email, tenant_id),
+    UNIQUE(membership_number, tenant_id)
+);
+
+-- Strains
+CREATE TABLE strains (
+    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id       UUID NOT NULL,
+    name            VARCHAR(255) NOT NULL,
+    thc_percentage  NUMERIC(5,2) NOT NULL,
+    cbd_percentage  NUMERIC(5,2) NOT NULL DEFAULT 0.00,
+    description     TEXT,
+    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Batches
+CREATE TABLE batches (
+    id                  UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id           UUID NOT NULL,
+    strain_id           UUID NOT NULL REFERENCES strains(id),
+    quantity_grams      NUMERIC(10,2) NOT NULL,
+    harvest_date        DATE,
+    batch_code          VARCHAR(100) NOT NULL,
+    status              VARCHAR(50) NOT NULL DEFAULT 'AVAILABLE',
+    contamination_flag  BOOLEAN NOT NULL DEFAULT FALSE,
+    created_at          TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    UNIQUE(batch_code, tenant_id)
+);
+
+-- Distributions (immutable — no UPDATE/DELETE via app)
+CREATE TABLE distributions (
+    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id       UUID NOT NULL,
+    member_id       UUID NOT NULL REFERENCES members(id),
+    batch_id        UUID NOT NULL REFERENCES batches(id),
+    quantity_grams  NUMERIC(10,2) NOT NULL,
+    distributed_at  TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    recorded_by     UUID NOT NULL REFERENCES members(id),
+    notes           TEXT,
+    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Monthly quotas (one row per member per calendar month)
+CREATE TABLE monthly_quotas (
+    id                  UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id           UUID NOT NULL,
+    member_id           UUID NOT NULL REFERENCES members(id),
+    year                INT NOT NULL,
+    month               INT NOT NULL CHECK (month >= 1 AND month <= 12),
+    total_distributed   NUMERIC(10,2) NOT NULL DEFAULT 0.00,
+    max_allowed         NUMERIC(10,2) NOT NULL,
+    version             BIGINT NOT NULL DEFAULT 0,
+    created_at          TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    UNIQUE(member_id, year, month)
+);
+
+-- Stock movements (audit journal)
+CREATE TABLE stock_movements (
+    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id       UUID NOT NULL,
+    batch_id        UUID NOT NULL REFERENCES batches(id),
+    movement_type   VARCHAR(50) NOT NULL,  -- IN, OUT, RECALL, ADJUSTMENT
+    quantity_grams  NUMERIC(10,2) NOT NULL,
+    reason          TEXT,
+    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Users (login identities)
+CREATE TABLE users (
+    id                  UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id           UUID NOT NULL,
+    member_id           UUID REFERENCES members(id),
+    email               VARCHAR(255) NOT NULL,
+    password_hash       VARCHAR(255) NOT NULL,
+    role                VARCHAR(50) NOT NULL DEFAULT 'ROLE_MEMBER',
+    last_login          TIMESTAMPTZ,
+    active              BOOLEAN NOT NULL DEFAULT TRUE,
+    refresh_token_hash  VARCHAR(255),
+    created_at          TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    UNIQUE(email, tenant_id)
+);
+
+-- Indexes for common query patterns
+CREATE INDEX idx_members_club_id ON members(club_id);
+CREATE INDEX idx_members_tenant_id ON members(tenant_id);
+CREATE INDEX idx_distributions_member_id ON distributions(member_id);
+CREATE INDEX idx_distributions_tenant_id ON distributions(tenant_id);
+CREATE INDEX idx_distributions_distributed_at ON distributions(distributed_at);
+CREATE INDEX idx_monthly_quotas_member_month ON monthly_quotas(member_id, year, month);
+CREATE INDEX idx_batches_tenant_status ON batches(tenant_id, status);
+```
+
+---
+
+## 4. `ComplianceService` — Implementation Spec
+
+Package: `de.cannamanage.service`
+
+### 4.1 Dependencies (injected via constructor)
+
+```java
+@Service
+@Transactional
+public class ComplianceService {
+
+    private final MemberRepository memberRepository;
+    private final DistributionRepository distributionRepository;
+    private final BatchRepository batchRepository;
+    private final MonthlyQuotaRepository monthlyQuotaRepository;
+    private final StrainRepository strainRepository;
+
+    // constructor injection...
+}
+```
+
+### 4.2 Method: `checkDistributionAllowed(UUID memberId, UUID batchId, BigDecimal quantityGrams)`
+
+**Algorithm (sequential checks, fail-fast):**
+
+```
+1. Load Member — throw MemberNotFoundException if not found
+2. CHECK: member.status == ACTIVE → else throw QuotaExceededException(MEMBER_INACTIVE)
+3. Load Batch → CHECK: batch.status == AVAILABLE → else throw BatchUnavailableException
+4. Load Strain via batch.strainId
+5. IF member.isUnder21 AND strain.thcPercentage > UNDER21_MAX_THC_PERCENTAGE
+      → throw QuotaExceededException(HIGH_THC_RESTRICTED_UNDER_21)
+6. Calculate todayDistributed = SUM(distributions.quantityGrams WHERE memberId AND date=TODAY)
+   CHECK: todayDistributed + quantityGrams > ADULT_DAILY_LIMIT_GRAMS
+      → throw QuotaExceededException(QUOTA_EXCEEDED_DAILY)
+7. Get or create MonthlyQuota for (memberId, currentYear, currentMonth)
+   SET maxAllowed = isUnder21 ? UNDER21_MONTHLY_LIMIT_GRAMS : ADULT_MONTHLY_LIMIT_GRAMS
+   CHECK: quota.totalDistributed + quantityGrams > quota.maxAllowed
+      → throw QuotaExceededException(QUOTA_EXCEEDED_MONTHLY)
+8. Return ComplianceCheckResult(allowed=true, remainingDaily, remainingMonthly)
+```
+
+### 4.3 `QuotaExceededException` — error codes
+
+```java
+public enum QuotaViolationCode {
+    MEMBER_INACTIVE,
+    QUOTA_EXCEEDED_DAILY,
+    QUOTA_EXCEEDED_MONTHLY,
+    HIGH_THC_RESTRICTED_UNDER_21,
+    BATCH_UNAVAILABLE
+}
+```
+
+### 4.4 DTOs
+
+```java
+// ComplianceCheckResult
+record ComplianceCheckResult(
+    boolean allowed,
+    BigDecimal remainingDaily,
+    BigDecimal remainingMonthly,
+    boolean isUnder21
+) {}
+
+// QuotaStatus
+record QuotaStatus(
+    BigDecimal totalAllowed,
+    BigDecimal totalUsed,
+    BigDecimal remaining,
+    boolean isUnder21,
+    int year,
+    int month
+) {}
+```
+
+---
+
+## 5. Unit Test Suite (TC-001 → TC-010)
+
+**Class:** `ComplianceServiceTest` in `cannamanage-service`  
+**Coverage requirement:** 100% line + branch on `ComplianceService`  
+**Tools:** JUnit 5, Mockito 5, AssertJ
+
+### Test structure
+
+```java
+@ExtendWith(MockitoExtension.class)
+class ComplianceServiceTest {
+
+    @Mock MemberRepository memberRepository;
+    @Mock DistributionRepository distributionRepository;
+    @Mock BatchRepository batchRepository;
+    @Mock MonthlyQuotaRepository monthlyQuotaRepository;
+    @Mock StrainRepository strainRepository;
+
+    @InjectMocks ComplianceService complianceService;
+
+    // Test fixtures
+    private static final UUID ADULT_MEMBER_ID = UUID.randomUUID();
+    private static final UUID UNDER21_MEMBER_ID = UUID.randomUUID();
+    private static final UUID BATCH_ID = UUID.randomUUID();
+    private static final UUID HIGH_THC_STRAIN_ID = UUID.randomUUID();
+
+    // TC-001: adult at monthly limit → throws QUOTA_EXCEEDED_MONTHLY
+    // TC-002: under-21 at monthly limit → throws QUOTA_EXCEEDED_MONTHLY
+    // TC-003: adult at daily limit → throws QUOTA_EXCEEDED_DAILY
+    // TC-004: under-21 + high THC strain → throws HIGH_THC_RESTRICTED_UNDER_21
+    // TC-005: adult at 49g requesting 2g → throws QUOTA_EXCEEDED_MONTHLY
+    // TC-006: adult at 0g requesting 25g → allowed, remaining=0
+    // TC-007: adult at 24.9g requesting 0.1g → allowed, remainingDaily=0
+    // TC-008: adult at 24.9g requesting 0.2g → throws QUOTA_EXCEEDED_DAILY
+    // TC-009: SUSPENDED member → throws MEMBER_INACTIVE
+    // TC-010: EXPELLED member → throws MEMBER_INACTIVE
+}
+```
+
+### Key mock patterns
+
+```java
+// TC-001 example mock setup
+Member adultMember = new Member();
+adultMember.setId(ADULT_MEMBER_ID);
+adultMember.setUnder21(false);
+adultMember.setStatus(MemberStatus.ACTIVE);
+
+when(memberRepository.findById(ADULT_MEMBER_ID)).thenReturn(Optional.of(adultMember));
+
+MonthlyQuota quota = new MonthlyQuota();
+quota.setTotalDistributed(new BigDecimal("50.0"));
+quota.setMaxAllowed(ComplianceConstants.ADULT_MONTHLY_LIMIT_GRAMS);
+when(monthlyQuotaRepository.findByMemberIdAndYearAndMonth(any(), anyInt(), anyInt()))
+    .thenReturn(Optional.of(quota));
+
+// Assert
+assertThatThrownBy(() -> complianceService.checkDistributionAllowed(ADULT_MEMBER_ID, BATCH_ID, new BigDecimal("1.0")))
+    .isInstanceOf(QuotaExceededException.class)
+    .extracting("code")
+    .isEqualTo(QuotaViolationCode.QUOTA_EXCEEDED_MONTHLY);
+```
+
+---
+
+## 6. Local Dev Docker Compose
+
+```yaml
+# docker-compose.yml (root of cannamanage project)
+version: '3.9'
+
+services:
+  db:
+    image: postgres:16-alpine
+    container_name: cannamanage-db-local
+    environment:
+      POSTGRES_DB: cannamanage
+      POSTGRES_USER: cannamanage
+      POSTGRES_PASSWORD: dev_password_change_in_prod
+    ports:
+      - "5432:5432"
+    volumes:
+      - pgdata_local:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U cannamanage"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+
+volumes:
+  pgdata_local:
+```
+
+```properties
+# cannamanage-api/src/main/resources/application-local.properties
+spring.datasource.url=jdbc:postgresql://localhost:5432/cannamanage
+spring.datasource.username=cannamanage
+spring.datasource.password=dev_password_change_in_prod
+spring.jpa.hibernate.ddl-auto=validate   # Flyway owns schema
+spring.flyway.enabled=true
+spring.flyway.locations=classpath:db/migration
+logging.level.de.cannamanage=DEBUG
+```
+
+**Run locally:**
+```bash
+git clone http://192.168.188.119:30008/pplate/cannamanage.git
+cd cannamanage
+docker compose up db -d
+./mvnw spring-boot:run -pl cannamanage-api -Dspring.profiles.active=local
+```
+
+---
+
+## 7. Sprint 1 Gitea Issues (already created: #1–#10)
+
+Based on the Sprint 1 board at `http://truenas.local:30008/pplate/cannamanage/wiki/Sprint-1-Board`, these map to:
+
+| Gitea Issue | Sprint 1 Deliverable |
+|-------------|---------------------|
+| #1 | Maven multi-module project scaffold |
+| #2 | `AbstractTenantEntity` + `TenantContext` ThreadLocal |
+| #3 | All 8 JPA entities in `cannamanage-domain` |
+| #4 | `ComplianceConstants.java` |
+| #5 | Flyway `V1__initial_schema.sql` |
+| #6 | `ComplianceService` implementation |
+| #7 | Unit tests TC-001 → TC-010 (100% coverage) |
+| #8 | `docker-compose.yml` local dev |
+| #9 | `application-local.properties` |
+| #10 | JaCoCo coverage gate in parent POM |
+
+---
+
+## 8. Out of Scope — Sprint 1
+
+These are **explicitly deferred** to Sprint 2+:
+
+- REST API controllers (`AuthController`, `MemberController`, `DistributionController`)
+- Spring Security + JWT filter chain
+- PrimeFaces JSF frontend
+- Stripe billing integration
+- iText 7 PDF reports
+- Email notifications
+- Testcontainers integration tests (TC-018 → TC-022)
+- Hetzner deployment / CI pipeline
+- `MemberService` (TC-011 → TC-015)
+
+---
+
+## 9. Definition of Done — Sprint 1
+
+- [ ] `./mvnw clean verify` exits 0 on clean checkout
+- [ ] `./mvnw test -pl cannamanage-service` reports 10/10 tests passing
+- [ ] JaCoCo report shows `ComplianceService` at 100% line + branch coverage
+- [ ] `docker compose up db -d` starts PostgreSQL; Flyway V1 migration applies cleanly
+- [ ] No `TODO` comments in production code paths
+- [ ] All 8 JPA entities have `@Column(nullable = false)` on required fields
+- [ ] `ComplianceConstants.java` contains all CanG limits as `public static final BigDecimal`
+- [ ] `AbstractTenantEntity.tenantId` is `@Column(updatable = false)`
+- [ ] Code pushed to `http://192.168.188.119:30008/pplate/cannamanage` main branch
+
+---
+
+## 10. Recommended Implementation Order
+
+```
+Day 1:  Root pom.xml + module scaffolds → ./mvnw compile passes
+Day 2:  AbstractTenantEntity + TenantContext + ComplianceConstants
+Day 3:  All 8 JPA entities (compile-time only, no DB yet)
+Day 4:  Flyway V1 SQL + docker-compose.yml → migration applies
+Day 5:  ComplianceService skeleton (method signatures + DTOs)
+Day 6:  TC-001 → TC-005 (the exception/blocking cases)
+Day 7:  TC-006 → TC-010 (boundary + happy path cases)
+Day 8:  JaCoCo gate; clean up; push to Gitea
+```
+
+*Assuming ~2–3 hours of evening/weekend coding per day as side project.*
+
+---
+
+*Plan created: 2026-04-10 | Sprint start: when Patrick approves | Estimated coding sessions: 8 × 2-3h*
diff --git a/plans/cannabis-club-saas/docs/CHANGELOG.md b/plans/cannabis-club-saas/docs/CHANGELOG.md
index 8653baf..4baec1b 100644
--- a/plans/cannabis-club-saas/docs/CHANGELOG.md
+++ b/plans/cannabis-club-saas/docs/CHANGELOG.md
@@ -12,17 +12,35 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 ### Added
 
 - Complete project documentation suite (10 documents, ~25,000 words)
-- System architecture design: 8 JPA entities, Maven multi-module structure, multi-tenancy via shared schema + Hibernate filter
+- System architecture design: 8 JPA entities, Maven multi-module structure
 - REST API specification: 7 controllers, 30+ endpoints, full request/response schemas with error codes
 - Compliance engine design: `ComplianceService` enforcing CanG §§19–22 limits (25g/day, 50g/month adults; 30g/month under-21; ≤10% THC under-21)
 - `ComplianceConstants.java` design: all legal thresholds as named constants to prevent magic numbers in compliance logic
 - UI wireframes for 6 screens: Admin Dashboard, Distribution Recording Form, Member List, Member Quota View, Stock Management, Compliance Report
 - 5 AI-generated UI mockup images (FLUX.1-schnell via ComfyUI, 1024×512)
 - Test plan with 26 test cases covering ComplianceService (TC-001–010), MemberService (TC-011–015), tenant isolation (TC-016–017), and integration tests (TC-018–026)
-- Deployment guide for Hetzner VPS: Docker Compose setup, Nginx reverse proxy, SSL with Let's Encrypt, CI/CD via Gitea Actions, database backup strategy
 - Coding standards: Java 21 conventions, JPA patterns, multi-tenancy rules, immutable distribution records
 - Flowcharts: distribution flow (5-step), member lifecycle (state machine), billing provisioning flow (Mermaid diagrams)
 - README with full documentation index, tech stack table, pricing tiers, legal notice
+- **[2026-04-06]** Staff member management: `ROLE_STAFF` with configurable per-account permission grants (US-026); admin controls which data staff can access (DSGVO least-privilege). 8 defined permissions, 3 pre-created role templates (Ausgabe, Lager, Vorstand). Core feature from Phase 0.
+- **[2026-04-06]** Grow Calendar: US-027 added as Could Have (v2) — cultivation diary per grow cycle, linked to batch harvest, optional photo attachments, admin-controlled access via `MANAGE_GROW_CALENDAR` permission
+- **[2026-04-06]** Staff wireframe (Screen 7) added to `06-Wireframes.md` with full ASCII wireframe, component table (TanStack Table, shadcn/ui Checkbox, Select), and DSGVO design rationale
+- **[2026-04-06]** Staff routes added to Navigation IA: `/admin/staff`, `/admin/staff/new`, `/admin/staff/{id}`, `/staff/dashboard`
+- **[2026-04-06]** TrueNAS.local Gitea Actions self-hosted runner documented in `09-Deployment.md` as the CI/CD build environment; Hetzner = production release target
+
+### Changed
+
+- **[2026-04-06]** `03-Architecture.md` — **Multi-tenancy model changed from shared-schema to schema-per-tenant.** Decision rationale: hard DB-level isolation (not application-layer), clean DSGVO deletion (`DROP SCHEMA`), no cross-tenant index bloat, easier future isolation. `tenant_id` columns on every entity removed; schema routing via `TenantRoutingDataSource` replaces Hibernate `@Filter`.
+- **[2026-04-06]** `03-Architecture.md` — **Frontend changed from PrimeFaces/JSF to React/Vite SPA.** Rationale: JSF server-side lifecycle is a poor fit for a REST API backend; PrimeFaces creates a hiring bottleneck; React is mobile-friendly from day 1. Component library: shadcn/ui (Radix UI + Tailwind CSS) + TanStack Table v8.
+- **[2026-04-06]** `03-Architecture.md` — `ROLE_STAFF` added with configurable `StaffPermission` enum; pre-created templates documented. Staff noted as core feature, not add-on.
+- **[2026-04-06]** `06-Wireframes.md` — All component tables updated from PrimeFaces (`p:dataTable`, `p:commandButton`) to React/Tailwind equivalents (TanStack Table, shadcn/ui). Responsive Design section rewritten for Tailwind breakpoints.
+- **[2026-04-06]** `09-Deployment.md` — CI/CD section rewritten: `runs-on: ubuntu-latest` → `runs-on: self-hosted` (TrueNAS.local). Gitea Actions runner setup instructions added. Infrastructure diagram updated to show Dev → Gitea → TrueNAS build → Hetzner release flow.
+- **[2026-04-06]** `0.1.0` CHANGELOG entry corrected: removed "shared schema" as final architecture decision (superseded by schema-per-tenant); removed PrimeFaces as frontend (superseded by React/Vite)
+
+### Fixed
+
+- **[2026-04-06]** `04-Flowcharts.md` — Mermaid parse error in Flow 4 (line 146): `[Generate empty report\nwith zero totals\n(still valid compliance submission)]` — parenthesis after newline was parsed as stadium-shape node start. Fixed by wrapping node text in double quotes.
+- **[2026-04-06]** `04-Flowcharts.md` — Mermaid parse error in Flow 5 (line 177): `[❌ Invalid credentials\n(generic — do not reveal\nwhether email exists)]` — same root cause, same fix.
 
 ---
 
@@ -33,9 +51,10 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - `STRATEGY.md` — initial project vision and feasibility assessment
 - Legal analysis confirming CanG compliance viability for B2B SaaS model (no public advertising, no club discovery, B2B-only)
 - Market analysis: ~3,000 registered clubs in Germany, TAM estimated at €2.85M ARR
-- Tech stack selection rationale: Spring Boot 3.x + PrimeFaces JSF (MVP) → Next.js v2; PostgreSQL + Flyway; iText 7 PDF; Stripe billing
-- Multi-tenancy architectural decision: shared schema with `tenant_id` column (chosen over schema-per-tenant for lower operational overhead at MVP scale)
+- Tech stack selection rationale: Spring Boot 3.x + React/Vite SPA (MVP) → Next.js v2; PostgreSQL + Flyway; iText 7 PDF; Stripe billing
+- Multi-tenancy architectural decision: schema-per-tenant (each club gets isolated PostgreSQL schema; platform registry in `public` schema)
 - Pricing model: 4 tiers (Starter €29, Growth €59, Professional €99, Enterprise €199/month)
+- Deployment guide for Hetzner VPS (production release): Docker Compose, Nginx + Let's Encrypt, Gitea Actions CI/CD via TrueNAS.local self-hosted runner, daily PostgreSQL backup strategy
 
 ---
 
diff --git a/plans/cannamanage-brand-pipeline.md b/plans/cannamanage-brand-pipeline.md
new file mode 100644
index 0000000..aafe45e
--- /dev/null
+++ b/plans/cannamanage-brand-pipeline.md
@@ -0,0 +1,1263 @@
+# CannaManage Brand Asset Generation Pipeline
+
+**Status:** Ready for Code mode implementation  
+**Target script:** `mcp/mcp-image-gen/cannamanage_gen.py`  
+**Output root:** `~/Pictures/cannamanage_brand/`  
+**Total assets:** 220+ images across 6 phases  
+**Est. runtime:** ~40–70 min (flux1-schnell) or ~3–4h (flux2-klein-heretic)
+
+---
+
+## Why a Script, Not a Chat Session
+
+LLM conversation sessions cannot run 220+ synchronous generations (37–180+ min). Every previous
+attempt ended `partial` because context/timeout limits hit mid-batch. This script calls the
+ComfyUI HTTP API directly — no LLM involvement at runtime. Patrick launches it, goes to sleep,
+wakes up to a full organized asset library.
+
+---
+
+## Architecture
+
+```
+cannamanage_gen.py
+├── Reads ASSET_MANIFEST (list of dicts defined inline)
+├── Loads state from ~/Pictures/cannamanage_brand/.progress.json (resume-safe)
+├── For each asset NOT yet in state:
+│   ├── Patches flux_schnell.json workflow (prompt, size, seed, filename prefix)
+│   ├── POSTs to ComfyUI /prompt
+│   ├── Polls /history/{prompt_id} until done (poll 2s, timeout 300s)
+│   ├── Downloads PNG from /view endpoint
+│   ├── Saves to ~/Pictures/cannamanage_brand/{phase}/{subfolder}/{name}.png
+│   └── Marks as complete in .progress.json (flush after every image)
+└── Prints final summary: X/Y completed, failed list
+```
+
+### Key Design Decisions
+- **Resume-safe:** `.progress.json` tracks completed asset IDs. Re-running skips done images.
+- **No dependencies beyond stdlib:** Uses `urllib.request` only (same as gen.py). No pip install needed.
+- **Workflow base:** `flux_schnell.json` (4 steps, ~10s/image for overnight batch speed).
+- **Failure tolerance:** Catches exceptions per-image, logs failure, continues batch.
+- **Progress display:** Shows `[phase] [N/total] name — done (Xkb)` per image.
+- **Default model:** `flux1-schnell.safetensors` for speed. Pass `--model flux2` to use heretic.
+
+### Workflow patch points (from gen.py analysis)
+```python
+workflow["2"]["inputs"]["text"]  = prompt          # positive prompt
+workflow["3"]["inputs"]["text"]  = ""               # negative (keep empty)
+workflow["10"]["inputs"]["noise_seed"] = seed       # randomness
+workflow["6"]["inputs"]["width"]  = width
+workflow["6"]["inputs"]["height"] = height
+workflow["7"]["inputs"]["steps"]  = steps           # 4 for schnell
+workflow["13"]["inputs"]["filename_prefix"] = name  # output filename
+```
+
+---
+
+## Brand DNA (applied to ALL prompts)
+
+**Color palette:**
+- Primary: deep emerald green `#0D4F3C`, bright emerald `#10B981`  
+- Accent: warm gold/amber `#F59E0B`, pale gold `#FCD34D`  
+- Neutral: dark charcoal `#1F2937`, warm white `#F9FAFB`, medium gray `#6B7280`
+- Secondary: sage green `#6EE7B7`, forest green `#065F46`
+
+**Tone:** Professional B2B SaaS, clean, modern, trustworthy, tech-forward, premium  
+**Cannabis references:** Subtle — geometric leaf shapes, hex-grid patterns, circuit-leaf hybrids.  
+**Avoid:** Stoner aesthetics, smoke, pipes, fire, psychedelic imagery, cartoon cannabis leaves  
+
+**Prompt prefix to prepend on all generations:**
+```
+professional B2B SaaS brand design, CannaManage cannabis business management platform,
+modern tech aesthetic, clean minimalist style, premium quality,
+```
+
+---
+
+## Folder Structure
+
+```
+~/Pictures/cannamanage_brand/
+├── .progress.json                    ← resume state file
+├── phase1_logos/
+│   ├── wordmark/
+│   ├── icon_only/
+│   ├── lockup_horizontal/
+│   ├── lockup_stacked/
+│   └── favicon/
+├── phase2_banners/
+│   ├── hero_website/
+│   ├── linkedin/
+│   ├── twitter_x/
+│   ├── facebook_cover/
+│   ├── google_display/
+│   ├── app_store/
+│   └── email_header/
+├── phase3_social/
+│   ├── instagram_square/
+│   ├── instagram_story/
+│   ├── linkedin_post/
+│   ├── feature_cards/
+│   ├── testimonial_cards/
+│   └── stat_cards/
+├── phase4_ui/
+│   ├── app_icons/
+│   ├── device_mockups/
+│   ├── onboarding_illustrations/
+│   ├── empty_states/
+│   └── splash_screens/
+├── phase5_collateral/
+│   ├── business_cards/
+│   ├── pitch_deck/
+│   ├── one_pager/
+│   ├── trade_show/
+│   └── stickers/
+└── phase6_bonus/
+    ├── animated_stills/
+    ├── dark_light_pairs/
+    ├── integration_badges/
+    └── trust_badges/
+```
+
+---
+
+## Complete Asset Manifest
+
+Each entry: `{"id": str, "phase": str, "subfolder": str, "name": str, "prompt": str, "width": int, "height": int, "steps": int}`
+
+### PHASE 1 — Logo Suite (42 assets)
+
+#### Wordmark — 5 font style directions (1024×512 each)
+
+```python
+{"id":"p1_wm_01","phase":"phase1_logos","subfolder":"wordmark","name":"wordmark_modern_sans",
+ "prompt":"CannaManage wordmark logo, modern geometric sans-serif typography, deep emerald green color #0D4F3C, clean white background, professional SaaS brand, minimal cannabis leaf accent integrated into letterform, high-end tech company wordmark style, vector clean, flat design",
+ "width":1024,"height":512,"steps":4},
+
+{"id":"p1_wm_02","phase":"phase1_logos","subfolder":"wordmark","name":"wordmark_geometric",
+ "prompt":"CannaManage wordmark logo, geometric typeface with sharp angles, two-tone emerald and gold color scheme, hexagonal grid subtle background element, cannabis molecule silhouette integrated into C letter, precision tech brand identity, clean white background, premium SaaS wordmark",
+ "width":1024,"height":512,"steps":4},
+
+{"id":"p1_wm_03","phase":"phase1_logos","subfolder":"wordmark","name":"wordmark_humanist",
+ "prompt":"CannaManage wordmark logo, humanist sans-serif typeface, warm approachable professional style, forest green with amber gold accent, subtle leaf vein pattern in letterforms, cannabis compliance software brand, trustworthy and modern, white background",
+ "width":1024,"height":512,"steps":4},
+
+{"id":"p1_wm_04","phase":"phase1_logos","subfolder":"wordmark","name":"wordmark_slab_serif",
+ "prompt":"CannaManage wordmark logo, premium slab serif typography, dark charcoal and deep green color palette, gold accent stripe element, authoritative compliance management brand, pharmaceutical-grade trustworthiness aesthetic, white background, clean professional",
+ "width":1024,"height":512,"steps":4},
+
+{"id":"p1_wm_05","phase":"phase1_logos","subfolder":"wordmark","name":"wordmark_minimal",
+ "prompt":"CannaManage wordmark logo, ultra-minimal thin weight typography, single-color deep emerald, negative space leaf shape formed by letter spacing, Apple-inspired premium minimalism, cannabis SaaS platform, pure white background, zen simplicity",
+ "width":1024,"height":512,"steps":4},
+```
+
+#### Icon/Symbol Only — 10 variations (512×512 each)
+
+```python
+{"id":"p1_ic_01","phase":"phase1_logos","subfolder":"icon_only","name":"icon_leaf_tech",
+ "prompt":"CannaManage app icon, abstract cannabis leaf shape formed from circuit board traces and data nodes, emerald green on dark charcoal background, tech-meets-nature concept, geometric precision, premium SaaS brand mark, square icon format",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ic_02","phase":"phase1_logos","subfolder":"icon_only","name":"icon_c_mark_abstract",
+ "prompt":"CannaManage brand icon, abstract letter C formed from cannabis plant stems and leaves, geometric minimalist style, deep green gradient, white background, negative space cannabis leaf inside C curve, modern tech company logo mark",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ic_03","phase":"phase1_logos","subfolder":"icon_only","name":"icon_molecule_stylized",
+ "prompt":"CannaManage icon, stylized cannabis molecule diagram as brand mark, hexagonal ring structure with emerald green nodes and gold connecting lines, scientific precision meets modern design, dark background, pharmaceutical-tech aesthetic",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ic_04","phase":"phase1_logos","subfolder":"icon_only","name":"icon_dashboard_grid",
+ "prompt":"CannaManage icon, abstract dashboard grid symbol, 3x3 grid of squares with data bar and cannabis leaf overlaid, emerald green and gold, SaaS platform brand mark, clean geometric, white background, analytics software icon",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ic_05","phase":"phase1_logos","subfolder":"icon_only","name":"icon_plant_circuit",
+ "prompt":"CannaManage icon, cannabis plant silhouette where stems are circuit board traces, leaves are data nodes, emerald green on white, half-organic half-digital visual metaphor, modern biotech aesthetic, clean vector-style brand mark",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ic_06","phase":"phase1_logos","subfolder":"icon_only","name":"icon_shield_leaf",
+ "prompt":"CannaManage compliance icon, shield shape with cannabis leaf geometric pattern inside, emerald green shield, gold leaf outline, trust and compliance brand mark, legal cannabis management software, premium badge style",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ic_07","phase":"phase1_logos","subfolder":"icon_only","name":"icon_cm_monogram",
+ "prompt":"CannaManage monogram mark, interlocked letters C and M with cannabis leaf negative space between them, geometric precision, deep emerald green, gold accent, premium brand monogram, white background, luxury SaaS identity",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ic_08","phase":"phase1_logos","subfolder":"icon_only","name":"icon_hexagon_leaf",
+ "prompt":"CannaManage icon, hexagon shape containing stylized cannabis leaf formed from clean lines, emerald green hexagon with dark outline, gold accent dot nodes at leaf tips, geometric cannabis brand mark, tech-forward minimal style",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ic_09","phase":"phase1_logos","subfolder":"icon_only","name":"icon_growth_chart",
+ "prompt":"CannaManage icon, upward growing cannabis plant silhouette that transforms into an ascending bar chart at top, emerald to gold gradient, business growth metaphor for cannabis industry management, modern flat icon design",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ic_10","phase":"phase1_logos","subfolder":"icon_only","name":"icon_infinity_leaf",
+ "prompt":"CannaManage brand mark, infinity loop symbol where the loops form two cannabis leaf shapes, emerald green line on white, continuous management and compliance cycle concept, clean modern geometric, premium SaaS logo mark",
+ "width":512,"height":512,"steps":4},
+```
+
+#### Horizontal Lockups — light and dark (1024×256 each)
+
+```python
+{"id":"p1_lh_01","phase":"phase1_logos","subfolder":"lockup_horizontal","name":"lockup_horiz_light",
+ "prompt":"CannaManage horizontal logo lockup, icon mark on left with wordmark text on right, light background version, deep emerald green colors, professional cannabis management SaaS, clean horizontal brand layout, premium company logo",
+ "width":1024,"height":256,"steps":4},
+
+{"id":"p1_lh_02","phase":"phase1_logos","subfolder":"lockup_horizontal","name":"lockup_horiz_dark",
+ "prompt":"CannaManage horizontal logo lockup, icon mark on left with wordmark text on right, dark charcoal background version, white and emerald green logo, reversed color scheme, premium cannabis SaaS brand, horizontal layout",
+ "width":1024,"height":256,"steps":4},
+
+{"id":"p1_lh_03","phase":"phase1_logos","subfolder":"lockup_horizontal","name":"lockup_horiz_emerald_bg",
+ "prompt":"CannaManage horizontal logo lockup, white logo on deep emerald green background, horizontal icon plus wordmark layout, brand banner version, premium cannabis management platform, professional SaaS brand",
+ "width":1024,"height":256,"steps":4},
+
+{"id":"p1_lh_04","phase":"phase1_logos","subfolder":"lockup_horizontal","name":"lockup_horiz_mono",
+ "prompt":"CannaManage horizontal logo lockup, monochrome single-color version, all black on white, horizontal icon plus wordmark, professional print-ready version, cannabis SaaS brand",
+ "width":1024,"height":256,"steps":4},
+```
+
+#### Stacked Lockups — 4 variations (512×512 each)
+
+```python
+{"id":"p1_ls_01","phase":"phase1_logos","subfolder":"lockup_stacked","name":"lockup_stacked_light",
+ "prompt":"CannaManage stacked logo lockup, icon centered above wordmark text, light white background, emerald green brand colors, square format, professional cannabis management SaaS centered layout",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ls_02","phase":"phase1_logos","subfolder":"lockup_stacked","name":"lockup_stacked_dark",
+ "prompt":"CannaManage stacked logo lockup, icon centered above wordmark text, dark charcoal background, white and green logo, square format reversed, cannabis SaaS brand dark version",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ls_03","phase":"phase1_logos","subfolder":"lockup_stacked","name":"lockup_stacked_emerald",
+ "prompt":"CannaManage stacked logo lockup, white icon and wordmark on emerald green background, centered square format, brand full-color version, cannabis management platform",
+ "width":512,"height":512,"steps":4},
+
+{"id":"p1_ls_04","phase":"phase1_logos","subfolder":"lockup_stacked","name":"lockup_stacked_mono",
+ "prompt":"CannaManage stacked logo lockup, monochrome all-black version on white, icon above wordmark, square format, print-ready logo, cannabis SaaS brand",
+ "width":512,"height":512,"steps":4},
+```
+
+#### Favicon crops — 8 variations (256×256 each)
+
+```python
+{"id":"p1_fv_01","phase":"phase1_logos","subfolder":"favicon","name":"favicon_emerald_leaf",
+ "prompt":"CannaManage favicon, 256x256 square app icon, emerald green background, white geometric cannabis leaf icon, rounded square format, mobile app icon style, clean minimal",
+ "width":256,"height":256,"steps":4},
+
+{"id":"p1_fv_02","phase":"phase1_logos","subfolder":"favicon","name":"favicon_dark_circuit",
+ "prompt":"CannaManage favicon, dark charcoal square background, emerald circuit-leaf icon, 256x256 app icon, sharp corners, professional SaaS favicon",
+ "width":256,"height":256,"steps":4},
+
+{"id":"p1_fv_03","phase":"phase1_logos","subfolder":"favicon","name":"favicon_white_green",
+ "prompt":"CannaManage favicon, white background, deep green CM monogram or leaf icon, 256x256 square, minimal browser favicon style",
+ "width":256,"height":256,"steps":4},
+
+{"id":"p1_fv_04","phase":"phase1_logos","subfolder":"favicon","name":"favicon_gold_dark",
+ "prompt":"CannaManage favicon, dark background, gold amber cannabis management icon mark, 256x256 premium app icon, warm gold on charcoal, luxury SaaS brand",
+ "width":256,"height":256,"steps":4},
+
+{"id":"p1_fv_05","phase":"phase1_logos","subfolder":"favicon","name":"favicon_gradient_green",
+ "prompt":"CannaManage favicon, forest to emerald green gradient background, white geometric icon, 256x256 square, modern SaaS app icon with subtle gradient",
+ "width":256,"height":256,"steps":4},
+
+{"id":"p1_fv_06","phase":"phase1_logos","subfolder":"favicon","name":"favicon_outline_style",
+ "prompt":"CannaManage favicon, white background, outline-only emerald green cannabis leaf circuit icon, thin line illustration style, 256x256, minimalist favicon",
+ "width":256,"height":256,"steps":4},
+
+{"id":"p1_fv_07","phase":"phase1_logos","subfolder":"favicon","name":"favicon_rounded_modern",
+ "prompt":"CannaManage favicon, iOS-style rounded square app icon, emerald green gradient background, white leaf-tech brand mark, 256x256, premium mobile app icon design",
+ "width":256,"height":256,"steps":4},
+
+{"id":"p1_fv_08","phase":"phase1_logos","subfolder":"favicon","name":"favicon_badge_style",
+ "prompt":"CannaManage favicon, badge-style icon with thin border ring, emerald center with white CM letters, 256x256 square, compliance software brand favicon",
+ "width":256,"height":256,"steps":4},
+```
+
+---
+
+### PHASE 2 — Banner Suite (50 assets)
+
+#### Hero Website Banners — 5 concepts (1920×1080)
+
+```python
+{"id":"p2_hw_01","phase":"phase2_banners","subfolder":"hero_website","name":"hero_dashboard_showcase",
+ "prompt":"CannaManage website hero banner 1920x1080, professional cannabis business management SaaS platform, dark charcoal background, emerald green UI dashboard mockup floating on right, bold headline area left, gold accent lines, clean tech aesthetic, enterprise software marketing banner",
+ "width":1920,"height":1080,"steps":4},
+
+{"id":"p2_hw_02","phase":"phase2_banners","subfolder":"hero_website","name":"hero_compliance_trust",
+ "prompt":"CannaManage website hero banner, compliance and trust theme, deep green gradient background, shield and checkmark iconography, professional typography area, cannabis regulatory compliance management, clean white text area, subtle cannabis leaf geometric pattern overlay, 1920x1080",
+ "width":1920,"height":1080,"steps":4},
+
+{"id":"p2_hw_03","phase":"phase2_banners","subfolder":"hero_website","name":"hero_analytics_data",
+ "prompt":"CannaManage website hero banner, analytics and business intelligence theme, dark background with glowing data visualization charts in emerald and gold, cannabis industry business metrics, modern tech company marketing image, abstract data flowing design, 1920x1080",
+ "width":1920,"height":1080,"steps":4},
+
+{"id":"p2_hw_04","phase":"phase2_banners","subfolder":"hero_website","name":"hero_team_enterprise",
+ "prompt":"CannaManage website hero banner, enterprise team productivity theme, split design with emerald left panel and clean white right panel, professional cannabis business management platform messaging area, modern split-screen SaaS marketing banner, geometric accents, 1920x1080",
+ "width":1920,"height":1080,"steps":4},
+
+{"id":"p2_hw_05","phase":"phase2_banners","subfolder":"hero_website","name":"hero_nature_tech",
+ "prompt":"CannaManage website hero banner, nature meets technology theme, abstract cannabis plant growing from circuit board visualization, emerald green organic forms with gold tech circuit lines, premium brand storytelling banner, dark sophisticated background, 1920x1080",
+ "width":1920,"height":1080,"steps":4},
+```
+
+#### LinkedIn Banners — 6 variations (1584×396)
+
+```python
+{"id":"p2_li_01","phase":"phase2_banners","subfolder":"linkedin","name":"linkedin_corporate_green",
+ "prompt":"CannaManage LinkedIn company banner, deep emerald green background, white CannaManage wordmark centered, professional cannabis business management SaaS tagline, clean minimal corporate LinkedIn header, 1584x396 proportions",
+ "width":1584,"height":396,"steps":4},
+
+{"id":"p2_li_02","phase":"phase2_banners","subfolder":"linkedin","name":"linkedin_dark_gold",
+ "prompt":"CannaManage LinkedIn banner, dark charcoal background with gold accent stripe at bottom, company name and brief descriptor, cannabis compliance management platform, professional enterprise software company banner, LinkedIn header design",
+ "width":1584,"height":396,"steps":4},
+
+{"id":"p2_li_03","phase":"phase2_banners","subfolder":"linkedin","name":"linkedin_pattern_overlay",
+ "prompt":"CannaManage LinkedIn banner, emerald green base with subtle hexagonal cannabis molecule pattern overlay, semi-transparent pattern, company branding prominent, SaaS platform, wide horizontal LinkedIn company page header",
+ "width":1584,"height":396,"steps":4},
+
+{"id":"p2_li_04","phase":"phase2_banners","subfolder":"linkedin","name":"linkedin_split_design",
+ "prompt":"CannaManage LinkedIn banner, split design left dark right emerald, diagonal split line, cannabis management platform branding, professional SaaS company header, clean sharp design, LinkedIn profile banner 1584x396",
+ "width":1584,"height":396,"steps":4},
+
+{"id":"p2_li_05","phase":"phase2_banners","subfolder":"linkedin","name":"linkedin_metrics_banner",
+ "prompt":"CannaManage LinkedIn banner showing key business metrics and KPI numbers for cannabis industry, data-forward professional banner, emerald green with gold numbers, SaaS analytics platform positioning, LinkedIn company page header",
+ "width":1584,"height":396,"steps":4},
+
+{"id":"p2_li_06","phase":"phase2_banners","subfolder":"linkedin","name":"linkedin_gradient_minimal",
+ "prompt":"CannaManage LinkedIn banner, forest green to emerald gradient background, minimal white brand name and tagline only, ultra-clean professional company banner, premium SaaS positioning, LinkedIn header",
+ "width":1584,"height":396,"steps":4},
+```
+
+#### Twitter/X Headers — 6 variations (1500×500)
+
+```python
+{"id":"p2_tw_01","phase":"phase2_banners","subfolder":"twitter_x","name":"twitter_bold_emerald",
+ "prompt":"CannaManage Twitter X header banner, bold emerald green full bleed background, large white brand name, cannabis management platform tagline, strong social media brand presence, 1500x500",
+ "width":1500,"height":500,"steps":4},
+
+{"id":"p2_tw_02","phase":"phase2_banners","subfolder":"twitter_x","name":"twitter_dark_pattern",
+ "prompt":"CannaManage Twitter header, dark charcoal with subtle cannabis geometric pattern, emerald and gold accent colors, professional SaaS brand social header, 1500x500 proportions",
+ "width":1500,"height":500,"steps":4},
+
+{"id":"p2_tw_03","phase":"phase2_banners","subfolder":"twitter_x","name":"twitter_product_hint",
+ "prompt":"CannaManage Twitter header, dark background with glimpse of dashboard interface, cannabis business management software product preview, professional tech company social media header, 1500x500",
+ "width":1500,"height":500,"steps":4},
+
+{"id":"p2_tw_04","phase":"phase2_banners","subfolder":"twitter_x","name":"twitter_nature_abstract",
+ "prompt":"CannaManage Twitter header, abstract cannabis plant growing into data streams, green to dark gradient, artistic tech company social header, organic meets digital aesthetic, 1500x500",
+ "width":1500,"height":500,"steps":4},
+
+{"id":"p2_tw_05","phase":"phase2_banners","subfolder":"twitter_x","name":"twitter_community",
+ "prompt":"CannaManage Twitter header, cannabis business community theme, connected nodes network visualization in emerald green, SaaS platform connecting cannabis businesses, professional social banner, 1500x500",
+ "width":1500,"height":500,"steps":4},
+
+{"id":"p2_tw_06","phase":"phase2_banners","subfolder":"twitter_x","name":"twitter_white_clean",
+ "prompt":"CannaManage Twitter header, clean white background, emerald green brand elements only, ultra-professional minimal social media header, cannabis management SaaS, 1500x500",
+ "width":1500,"height":500,"steps":4},
+```
+
+#### Facebook Covers — 6 variations (820×312)
+
+```python
+{"id":"p2_fb_01","phase":"phase2_banners","subfolder":"facebook_cover","name":"facebook_primary_brand",
+ "prompt":"CannaManage Facebook cover photo, primary brand colors emerald and charcoal, professional cannabis business management company cover, centered branding, SaaS platform social presence, 820x312",
+ "width":820,"height":312,"steps":4},
+
+{"id":"p2_fb_02","phase":"phase2_banners","subfolder":"facebook_cover","name":"facebook_dark_professional",
+ "prompt":"CannaManage Facebook cover, dark sophisticated background, white and gold brand elements, enterprise cannabis management platform, premium company social media cover, 820x312",
+ "width":820,"height":312,"steps":4},
+
+{"id":"p2_fb_03","phase":"phase2_banners","subfolder":"facebook_cover","name":"facebook_compliance_theme",
+ "prompt":"CannaManage Facebook cover, cannabis regulatory compliance theme, shield and verification iconography, emerald green professional, compliance management SaaS company cover photo, 820x312",
+ "width":820,"height":312,"steps":4},
+
+{"id":"p2_fb_04","phase":"phase2_banners","subfolder":"facebook_cover","name":"facebook_product_launch",
+ "prompt":"CannaManage Facebook cover, product launch announcement style, bold emerald with gold accents, exciting software release visual, cannabis management platform new features, dynamic tech company cover, 820x312",
+ "width":820,"height":312,"steps":4},
+
+{"id":"p2_fb_05","phase":"phase2_banners","subfolder":"facebook_cover","name":"facebook_industry_leader",
+ "prompt":"CannaManage Facebook cover, industry leadership positioning, cannabis business management market leader visual, professional authoritative design, emerald green with subtle gold crown element, SaaS platform, 820x312",
+ "width":820,"height":312,"steps":4},
+
+{"id":"p2_fb_06","phase":"phase2_banners","subfolder":"facebook_cover","name":"facebook_seasonal_spring",
+ "prompt":"CannaManage Facebook cover, spring fresh brand refresh visual, bright emerald with sage green organic elements, cannabis growth season theme, professional seasonal company cover, SaaS platform, 820x312",
+ "width":820,"height":312,"steps":4},
+```
+
+#### Google Display Ads — 4 concepts × 4 sizes (16 assets)
+
+```python
+# Concept A: "Simplify Compliance" — 4 sizes
+{"id":"p2_ga_01a","phase":"phase2_banners","subfolder":"google_display","name":"gad_compliance_728x90",
+ "prompt":"CannaManage Google display ad leaderboard 728x90, simplify cannabis compliance theme, emerald green button, white background, professional B2B ad, cannabis management software CTA",
+ "width":728,"height":90,"steps":4},
+{"id":"p2_ga_01b","phase":"phase2_banners","subfolder":"google_display","name":"gad_compliance_300x250",
+ "prompt":"CannaManage Google display ad medium rectangle 300x250, simplify cannabis compliance theme, emerald green design, bold headline, professional SaaS ad creative, cannabis management platform",
+ "width":300,"height":250,"steps":4},
+{"id":"p2_ga_01c","phase":"phase2_banners","subfolder":"google_display","name":"gad_compliance_160x600",
+ "prompt":"CannaManage Google display ad wide skyscraper 160x600, simplify cannabis compliance theme, tall vertical format, emerald green, professional B2B cannabis software ad",
+ "width":160,"height":600,"steps":4},
+{"id":"p2_ga_01d","phase":"phase2_banners","subfolder":"google_display","name":"gad_compliance_320x50",
+ "prompt":"CannaManage Google display ad mobile banner 320x50, simplify compliance theme, minimal mobile ad, emerald green, cannabis management SaaS",
+ "width":320,"height":50,"steps":4},
+
+# Concept B: "Manage Everything" — 4 sizes
+{"id":"p2_ga_02a","phase":"phase2_banners","subfolder":"google_display","name":"gad_manage_728x90",
+ "prompt":"CannaManage Google display ad 728x90, manage everything cannabis business theme, dashboard preview hint, dark charcoal professional ad, SaaS platform leaderboard banner",
+ "width":728,"height":90,"steps":4},
+{"id":"p2_ga_02b","phase":"phase2_banners","subfolder":"google_display","name":"gad_manage_300x250",
+ "prompt":"CannaManage Google display ad 300x250, manage everything cannabis operations theme, product dashboard glimpse, emerald dark professional rectangle ad, cannabis management SaaS",
+ "width":300,"height":250,"steps":4},
+{"id":"p2_ga_02c","phase":"phase2_banners","subfolder":"google_display","name":"gad_manage_160x600",
+ "prompt":"CannaManage Google display skyscraper 160x600, manage cannabis business operations theme, vertical product feature list visual, emerald professional tall ad",
+ "width":160,"height":600,"steps":4},
+{"id":"p2_ga_02d","phase":"phase2_banners","subfolder":"google_display","name":"gad_manage_320x50",
+ "prompt":"CannaManage mobile banner 320x50, manage cannabis business theme, ultra-minimal mobile ad strip, brand colors",
+ "width":320,"height":50,"steps":4},
+
+# Concept C: "Grow Your Business" — 4 sizes
+{"id":"p2_ga_03a","phase":"phase2_banners","subfolder":"google_display","name":"gad_grow_728x90",
+ "prompt":"CannaManage Google ad 728x90, grow your cannabis business theme, upward growth arrow with cannabis leaf, gold and emerald, professional B2B leaderboard ad",
+ "width":728,"height":90,"steps":4},
+{"id":"p2_ga_03b","phase":"phase2_banners","subfolder":"google_display","name":"gad_grow_300x250",
+ "prompt":"CannaManage Google ad 300x250, cannabis business growth theme, ascending graph with emerald plant growth visual, professional SaaS rectangle ad",
+ "width":300,"height":250,"steps":4},
+{"id":"p2_ga_03c","phase":"phase2_banners","subfolder":"google_display","name":"gad_grow_160x600",
+ "prompt":"CannaManage skyscraper ad 160x600, cannabis business growth vertical story, plant growing upward through data visualization, emerald green tall display ad",
+ "width":160,"height":600,"steps":4},
+{"id":"p2_ga_03d","phase":"phase2_banners","subfolder":"google_display","name":"gad_grow_320x50",
+ "prompt":"CannaManage mobile ad 320x50, grow cannabis business, minimal mobile strip ad emerald green",
+ "width":320,"height":50,"steps":4},
+
+# Concept D: "Free Trial CTA" — 4 sizes
+{"id":"p2_ga_04a","phase":"phase2_banners","subfolder":"google_display","name":"gad_trial_728x90",
+ "prompt":"CannaManage Google ad 728x90, free trial call to action, bold gold CTA button, emerald professional leaderboard, cannabis management SaaS free trial offer ad",
+ "width":728,"height":90,"steps":4},
+{"id":"p2_ga_04b","phase":"phase2_banners","subfolder":"google_display","name":"gad_trial_300x250",
+ "prompt":"CannaManage Google ad 300x250, free trial offer, gold button emerald design, cannabis business management platform trial CTA rectangle ad",
+ "width":300,"height":250,"steps":4},
+{"id":"p2_ga_04c","phase":"phase2_banners","subfolder":"google_display","name":"gad_trial_160x600",
+ "prompt":"CannaManage skyscraper ad 160x600, free trial CTA vertical ad, gold call to action button, emerald green cannabis SaaS platform",
+ "width":160,"height":600,"steps":4},
+{"id":"p2_ga_04d","phase":"phase2_banners","subfolder":"google_display","name":"gad_trial_320x50",
+ "prompt":"CannaManage mobile ad 320x50, free trial minimal mobile strip, gold CTA emerald brand",
+ "width":320,"height":50,"steps":4},
+```
+
+#### App Store Feature Graphics — 4 variations (1024×500)
+
+```python
+{"id":"p2_as_01","phase":"phase2_banners","subfolder":"app_store","name":"appstore_hero_dashboard",
+ "prompt":"CannaManage app store feature graphic 1024x500, cannabis management app showcase, dark background with app dashboard UI preview, emerald green interface elements, professional mobile app store hero image, SaaS platform app",
+ "width":1024,"height":500,"steps":4},
+
+{"id":"p2_as_02","phase":"phase2_banners","subfolder":"app_store","name":"appstore_compliance_features",
+ "prompt":"CannaManage app store feature graphic, compliance and legal features highlight, shield icons and checkmarks, emerald green professional design, cannabis compliance app, feature screenshot graphic 1024x500",
+ "width":1024,"height":500,"steps":4},
+
+{"id":"p2_as_03","phase":"phase2_banners","subfolder":"app_store","name":"appstore_analytics_focus",
+ "prompt":"CannaManage app store graphic 1024x500, business analytics and reporting feature highlight, dashboard charts and graphs preview, gold and emerald data visualization, cannabis business intelligence app",
+ "width":1024,"height":500,"steps":4},
+
+{"id":"p2_as_04","phase":"phase2_banners","subfolder":"app_store","name":"appstore_team_management",
+ "prompt":"CannaManage app store graphic 1024x500, team and staff management feature, connected team nodes visualization, emerald green professional, cannabis dispensary team management app feature graphic",
+ "width":1024,"height":500,"steps":4},
+```
+
+#### Email Header Banners — 8 variations (600×200)
+
+```python
+{"id":"p2_em_01","phase":"phase2_banners","subfolder":"email_header","name":"email_primary_brand",
+ "prompt":"CannaManage email header banner 600x200, primary brand header for email newsletters, emerald green with white logo area, professional email marketing header, cannabis management SaaS",
+ "width":600,"height":200,"steps":4},
+
+{"id":"p2_em_02","phase":"phase2_banners","subfolder":"email_header","name":"email_welcome",
+ "prompt":"CannaManage welcome email header 600x200, warm welcome theme, emerald and sage green gradient, onboarding email banner, cannabis SaaS platform new user email header",
+ "width":600,"height":200,"steps":4},
+
+{"id":"p2_em_03","phase":"phase2_banners","subfolder":"email_header","name":"email_product_update",
+ "prompt":"CannaManage product update email header 600x200, new features announcement theme, gold accent notification style, cannabis management software update email banner",
+ "width":600,"height":200,"steps":4},
+
+{"id":"p2_em_04","phase":"phase2_banners","subfolder":"email_header","name":"email_compliance_alert",
+ "prompt":"CannaManage compliance alert email header 600x200, urgent compliance notification theme, amber gold accent on dark, cannabis regulatory update email header, professional alert banner",
+ "width":600,"height":200,"steps":4},
+
+{"id":"p2_em_05","phase":"phase2_banners","subfolder":"email_header","name":"email_monthly_report",
+ "prompt":"CannaManage monthly report email header 600x200, data and analytics theme, charts and metrics preview, emerald professional, cannabis business monthly summary email banner",
+ "width":600,"height":200,"steps":4},
+
+{"id":"p2_em_06","phase":"phase2_banners","subfolder":"email_header","name":"email_trial_ending",
+ "prompt":"CannaManage trial ending email header 600x200, urgency CTA theme, gold highlight on dark, cannabis management platform trial expiry email banner, convert to paid",
+ "width":600,"height":200,"steps":4},
+
+{"id":"p2_em_07","phase":"phase2_banners","subfolder":"email_header","name":"email_invoice",
+ "prompt":"CannaManage invoice and billing email header 600x200, clean minimal professional, white and emerald, cannabis SaaS billing email header, enterprise professional",
+ "width":600,"height":200,"steps":4},
+
+{"id":"p2_em_08","phase":"phase2_banners","subfolder":"email_header","name":"email_dark_premium",
+ "prompt":"CannaManage dark premium email header 600x200, dark charcoal with gold and emerald brand elements, VIP customer or enterprise tier email, cannabis management platform premium email header",
+ "width":600,"height":200,"steps":4},
+```
+
+---
+
+### PHASE 3 — Social Media Asset Pack (60 assets)
+
+#### Instagram Square Posts — 10 feature highlights (1080×1080)
+
+```python
+{"id":"p3_ig_01","phase":"phase3_social","subfolder":"instagram_square","name":"insta_inventory_mgmt",
+ "prompt":"CannaManage Instagram post 1080x1080, inventory management feature highlight, cannabis stock tracking dashboard visualization, emerald green UI elements, bold feature announcement, professional SaaS social post, clean white and dark design",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_ig_02","phase":"phase3_social","subfolder":"instagram_square","name":"insta_compliance_track",
+ "prompt":"CannaManage Instagram post 1080x1080, compliance tracking feature, regulatory checklist visualization, shield and checkmark icons, emerald and gold, cannabis compliance SaaS social media post",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_ig_03","phase":"phase3_social","subfolder":"instagram_square","name":"insta_analytics_dash",
+ "prompt":"CannaManage Instagram post 1080x1080, analytics dashboard feature, business intelligence data visualization, emerald charts and graphs on dark background, cannabis business analytics social post",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_ig_04","phase":"phase3_social","subfolder":"instagram_square","name":"insta_staff_scheduling",
+ "prompt":"CannaManage Instagram post 1080x1080, staff scheduling feature, team calendar and shift management visualization, cannabis dispensary staff management, clean emerald professional social post",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_ig_05","phase":"phase3_social","subfolder":"instagram_square","name":"insta_pos_integration",
+ "prompt":"CannaManage Instagram post 1080x1080, POS system integration feature, cannabis point-of-sale connection visualization, integration nodes and arrows, emerald and gold tech visualization social post",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_ig_06","phase":"phase3_social","subfolder":"instagram_square","name":"insta_reporting",
+ "prompt":"CannaManage Instagram post 1080x1080, automated reporting feature, beautiful report document preview, cannabis business reporting, emerald professional document visualization social post",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_ig_07","phase":"phase3_social","subfolder":"instagram_square","name":"insta_multi_location",
+ "prompt":"CannaManage Instagram post 1080x1080, multi-location management feature, cannabis dispensary chain management visualization, location pins on map with connecting emerald lines, SaaS multi-site management post",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_ig_08","phase":"phase3_social","subfolder":"instagram_square","name":"insta_mobile_app",
+ "prompt":"CannaManage Instagram post 1080x1080, mobile app feature highlight, iPhone and Android app preview mockup, cannabis management on-the-go, emerald green app UI, professional mobile SaaS social post",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_ig_09","phase":"phase3_social","subfolder":"instagram_square","name":"insta_security",
+ "prompt":"CannaManage Instagram post 1080x1080, enterprise security feature, data protection and encryption visualization, shield with lock icon, cannabis business data security, dark professional emerald security post",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_ig_10","phase":"phase3_social","subfolder":"instagram_square","name":"insta_brand_story",
+ "prompt":"CannaManage Instagram brand story post 1080x1080, company mission and vision, cannabis industry empowerment theme, beautiful abstract plant and technology fusion illustration, emerald and gold, inspiring brand post",
+ "width":1080,"height":1080,"steps":4},
+```
+
+#### Instagram Stories — 8 variations (1080×1920)
+
+```python
+{"id":"p3_st_01","phase":"phase3_social","subfolder":"instagram_story","name":"story_onboarding",
+ "prompt":"CannaManage Instagram story 1080x1920, onboarding tutorial slide, step-by-step cannabis management platform setup, emerald green vertical mobile design, swipe up CTA, professional SaaS story template",
+ "width":1080,"height":1920,"steps":4},
+
+{"id":"p3_st_02","phase":"phase3_social","subfolder":"instagram_story","name":"story_feature_announce",
+ "prompt":"CannaManage Instagram story 1080x1920, new feature announcement, bold emerald vertical design, cannabis software update story, gold accent highlight, tap to learn more CTA",
+ "width":1080,"height":1920,"steps":4},
+
+{"id":"p3_st_03","phase":"phase3_social","subfolder":"instagram_story","name":"story_stat_highlight",
+ "prompt":"CannaManage Instagram story 1080x1920, industry statistic highlight, large bold number with cannabis industry stat, dark background gold number emerald accent, data-driven story template",
+ "width":1080,"height":1920,"steps":4},
+
+{"id":"p3_st_04","phase":"phase3_social","subfolder":"instagram_story","name":"story_customer_quote",
+ "prompt":"CannaManage Instagram story 1080x1920, customer testimonial quote story, elegant quote typography on emerald background, cannabis business owner testimonial, premium brand testimonial vertical story",
+ "width":1080,"height":1920,"steps":4},
+
+{"id":"p3_st_05","phase":"phase3_social","subfolder":"instagram_story","name":"story_poll_template",
+ "prompt":"CannaManage Instagram story 1080x1920, interactive poll template, cannabis industry question visual, dark professional story background, poll options styled in emerald and gold, engagement story design",
+ "width":1080,"height":1920,"steps":4},
+
+{"id":"p3_st_06","phase":"phase3_social","subfolder":"instagram_story","name":"story_countdown",
+ "prompt":"CannaManage Instagram story 1080x1920, countdown timer event template, launch or deadline countdown visual, bold dramatic dark background with gold countdown element, cannabis SaaS event story",
+ "width":1080,"height":1920,"steps":4},
+
+{"id":"p3_st_07","phase":"phase3_social","subfolder":"instagram_story","name":"story_tips_series",
+ "prompt":"CannaManage Instagram story 1080x1920, cannabis compliance tip of the day template, bright educational story, numbered tip format, sage green professional, cannabis regulatory guidance story series",
+ "width":1080,"height":1920,"steps":4},
+
+{"id":"p3_st_08","phase":"phase3_social","subfolder":"instagram_story","name":"story_free_trial",
+ "prompt":"CannaManage Instagram story 1080x1920, free trial CTA story, bold gold call to action on dark emerald, cannabis management platform sign up story, strong conversion story design",
+ "width":1080,"height":1920,"steps":4},
+```
+
+#### LinkedIn Post Graphics — 8 variations (1200×627)
+
+```python
+{"id":"p3_lp_01","phase":"phase3_social","subfolder":"linkedin_post","name":"linkedin_thought_leader",
+ "prompt":"CannaManage LinkedIn post graphic 1200x627, thought leadership article header, cannabis industry insights theme, professional editorial design, emerald brand with white content area, SaaS company article image",
+ "width":1200,"height":627,"steps":4},
+
+{"id":"p3_lp_02","phase":"phase3_social","subfolder":"linkedin_post","name":"linkedin_product_demo",
+ "prompt":"CannaManage LinkedIn post 1200x627, product demo announcement, screenshot preview teaser, cannabis management platform demo invitation, emerald professional post graphic, enterprise SaaS LinkedIn post",
+ "width":1200,"height":627,"steps":4},
+
+{"id":"p3_lp_03","phase":"phase3_social","subfolder":"linkedin_post","name":"linkedin_hiring",
+ "prompt":"CannaManage LinkedIn hiring post 1200x627, we are hiring banner, team growth announcement, professional cannabis tech company hiring graphic, emerald and gold, clean company culture post",
+ "width":1200,"height":627,"steps":4},
+
+{"id":"p3_lp_04","phase":"phase3_social","subfolder":"linkedin_post","name":"linkedin_industry_stat",
+ "prompt":"CannaManage LinkedIn post 1200x627, cannabis industry statistic infographic, large bold number, data source cited, professional B2B data post, emerald green LinkedIn post graphic",
+ "width":1200,"height":627,"steps":4},
+
+{"id":"p3_lp_05","phase":"phase3_social","subfolder":"linkedin_post","name":"linkedin_partnership",
+ "prompt":"CannaManage LinkedIn partnership announcement post 1200x627, two brand logos connected, strategic partnership visual, cannabis tech ecosystem, professional announcement graphic emerald",
+ "width":1200,"height":627,"steps":4},
+
+{"id":"p3_lp_06","phase":"phase3_social","subfolder":"linkedin_post","name":"linkedin_webinar",
+ "prompt":"CannaManage LinkedIn webinar promotion post 1200x627, cannabis compliance webinar announcement, date and topic visual, professional event promotion graphic, emerald dark design",
+ "width":1200,"height":627,"steps":4},
+
+{"id":"p3_lp_07","phase":"phase3_social","subfolder":"linkedin_post","name":"linkedin_case_study",
+ "prompt":"CannaManage LinkedIn case study post 1200x627, customer success story preview, cannabis dispensary success metrics highlighted, gold numbers on dark, professional B2B case study promotional graphic",
+ "width":1200,"height":627,"steps":4},
+
+{"id":"p3_lp_08","phase":"phase3_social","subfolder":"linkedin_post","name":"linkedin_award",
+ "prompt":"CannaManage LinkedIn award announcement post 1200x627, award or recognition announcement, gold trophy or badge element, cannabis tech industry recognition, celebratory professional post graphic",
+ "width":1200,"height":627,"steps":4},
+```
+
+#### Feature Announcement Cards — 10 product features (1080×1080)
+
+```python
+{"id":"p3_fc_01","phase":"phase3_social","subfolder":"feature_cards","name":"feature_inventory_scan",
+ "prompt":"CannaManage feature card 1080x1080, barcode scanning inventory management, cannabis product scan interface, mobile scanning visualization, emerald UI feature card, product feature announcement social graphic",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_fc_02","phase":"phase3_social","subfolder":"feature_cards","name":"feature_auto_compliance",
+ "prompt":"CannaManage feature card 1080x1080, automated compliance reporting, robot or automation icon with compliance checklist, cannabis regulatory automation, emerald professional feature announcement",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_fc_03","phase":"phase3_social","subfolder":"feature_cards","name":"feature_real_time_alerts",
+ "prompt":"CannaManage feature card 1080x1080, real-time alerts and notifications, bell notification with cannabis threshold alerts, gold alert accent on dark, compliance boundary notification feature",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_fc_04","phase":"phase3_social","subfolder":"feature_cards","name":"feature_member_portal",
+ "prompt":"CannaManage feature card 1080x1080, member self-service portal, cannabis club member login interface, clean emerald member management feature, user portal visualization",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_fc_05","phase":"phase3_social","subfolder":"feature_cards","name":"feature_api_integrations",
+ "prompt":"CannaManage feature card 1080x1080, API integrations ecosystem, connected software logos with CannaManage hub, cannabis tech stack integration visualization, emerald connection diagram feature card",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_fc_06","phase":"phase3_social","subfolder":"feature_cards","name":"feature_batch_tracking",
+ "prompt":"CannaManage feature card 1080x1080, batch and lot tracking feature, cannabis product chain of custody visualization, numbered batch tracking flow, professional compliance feature card",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_fc_07","phase":"phase3_social","subfolder":"feature_cards","name":"feature_document_mgmt",
+ "prompt":"CannaManage feature card 1080x1080, document management system, cannabis licensing and permit documents organized, folder and document icons in emerald, digital document management feature",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_fc_08","phase":"phase3_social","subfolder":"feature_cards","name":"feature_role_permissions",
+ "prompt":"CannaManage feature card 1080x1080, role-based permissions feature, user role hierarchy visualization, shield with user silhouettes, cannabis team access control, dark professional feature card",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_fc_09","phase":"phase3_social","subfolder":"feature_cards","name":"feature_export_reports",
+ "prompt":"CannaManage feature card 1080x1080, one-click export and reporting, PDF report generation from cannabis data, download arrow with beautiful report preview, emerald feature announcement card",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_fc_10","phase":"phase3_social","subfolder":"feature_cards","name":"feature_audit_trail",
+ "prompt":"CannaManage feature card 1080x1080, complete audit trail feature, cannabis transaction history timeline visualization, chronological log entries, compliance audit visualization, professional dark feature card",
+ "width":1080,"height":1080,"steps":4},
+```
+
+#### Testimonial Cards — 6 styles (1080×1080)
+
+```python
+{"id":"p3_tc_01","phase":"phase3_social","subfolder":"testimonial_cards","name":"testimonial_dark_elegant",
+ "prompt":"CannaManage testimonial card 1080x1080, dark charcoal elegant quote card, gold quotation marks, customer name and title, cannabis business owner testimonial, premium quote card design",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_tc_02","phase":"phase3_social","subfolder":"testimonial_cards","name":"testimonial_emerald_bold",
+ "prompt":"CannaManage testimonial card 1080x1080, bold emerald green background, white quote text, customer review of cannabis management SaaS, bold confident testimonial design",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_tc_03","phase":"phase3_social","subfolder":"testimonial_cards","name":"testimonial_light_minimal",
+ "prompt":"CannaManage testimonial card 1080x1080, light white minimal quote card, emerald accent line, clean professional customer testimonial, cannabis dispensary owner review, minimal elegant design",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_tc_04","phase":"phase3_social","subfolder":"testimonial_cards","name":"testimonial_star_rating",
+ "prompt":"CannaManage testimonial card 1080x1080, 5-star rating testimonial card, gold stars prominently displayed, customer quote below, cannabis management platform review, star rating testimonial design",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_tc_05","phase":"phase3_social","subfolder":"testimonial_cards","name":"testimonial_split_design",
+ "prompt":"CannaManage testimonial card 1080x1080, split design half dark half emerald, quote on dark side, customer info on emerald side, cannabis SaaS testimonial split layout",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_tc_06","phase":"phase3_social","subfolder":"testimonial_cards","name":"testimonial_gradient",
+ "prompt":"CannaManage testimonial card 1080x1080, forest to emerald gradient background, white elegant quote text, customer testimonial cannabis management platform, gradient testimonial card",
+ "width":1080,"height":1080,"steps":4},
+```
+
+#### Stat/Data Cards — 8 cannabis industry statistics (1080×1080)
+
+```python
+{"id":"p3_sc_01","phase":"phase3_social","subfolder":"stat_cards","name":"stat_market_size",
+ "prompt":"CannaManage stat card 1080x1080, cannabis market size statistic, large bold dollar amount like 50 billion USD, emerald gold number on dark background, cannabis industry market data social card",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_sc_02","phase":"phase3_social","subfolder":"stat_cards","name":"stat_compliance_cost",
+ "prompt":"CannaManage stat card 1080x1080, compliance cost reduction statistic, percentage savings with management software, gold percentage number, cannabis business cost savings data card",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_sc_03","phase":"phase3_social","subfolder":"stat_cards","name":"stat_time_savings",
+ "prompt":"CannaManage stat card 1080x1080, hours saved per week statistic, clock icon with bold number, cannabis dispensary operational time savings, emerald professional data card",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_sc_04","phase":"phase3_social","subfolder":"stat_cards","name":"stat_dispensary_growth",
+ "prompt":"CannaManage stat card 1080x1080, dispensary industry growth rate, upward arrow with percentage growth, cannabis retail market growth stat, gold growth number on dark card",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_sc_05","phase":"phase3_social","subfolder":"stat_cards","name":"stat_compliance_fines",
+ "prompt":"CannaManage stat card 1080x1080, compliance violation fine amounts, cannabis regulatory penalty warning stat, amber warning colors, avoid fines messaging, data card",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_sc_06","phase":"phase3_social","subfolder":"stat_cards","name":"stat_customer_count",
+ "prompt":"CannaManage stat card 1080x1080, number of cannabis businesses managed, large customer count statistic, emerald green social proof data card, platform traction metric",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_sc_07","phase":"phase3_social","subfolder":"stat_cards","name":"stat_roi_metric",
+ "prompt":"CannaManage stat card 1080x1080, ROI return on investment metric for cannabis management software, large gold ROI percentage, business value data card, SaaS ROI statistic",
+ "width":1080,"height":1080,"steps":4},
+
+{"id":"p3_sc_08","phase":"phase3_social","subfolder":"stat_cards","name":"stat_legal_markets",
+ "prompt":"CannaManage stat card 1080x1080, number of legal cannabis markets worldwide, globe icon with country count, cannabis legalization data, emerald global market stat card",
+ "width":1080,"height":1080,"steps":4},
+```
+
+---
+
+### PHASE 4 — UI & Product Assets (32 assets)
+
+#### App Icons — 8 variations (1024×1024)
+
+```python
+{"id":"p4_ai_01","phase":"phase4_ui","subfolder":"app_icons","name":"appicon_ios_emerald",
+ "prompt":"CannaManage iOS app icon 1024x1024, Apple iOS style rounded square icon, emerald green gradient background, white cannabis leaf tech icon mark, premium mobile app icon, App Store quality",
+ "width":1024,"height":1024,"steps":4},
+
+{"id":"p4_ai_02","phase":"phase4_ui","subfolder":"app_icons","name":"appicon_ios_dark",
+ "prompt":"CannaManage iOS app icon 1024x1024, dark mode iOS icon, dark charcoal with emerald and gold brand mark, premium dark app icon, cannabis management mobile app",
+ "width":1024,"height":1024,"steps":4},
+
+{"id":"p4_ai_03","phase":"phase4_ui","subfolder":"app_icons","name":"appicon_ios_gold",
+ "prompt":"CannaManage iOS app icon 1024x1024, premium gold accent iOS icon, deep green background with gold leaf circuit brand mark, luxury cannabis management app icon",
+ "width":1024,"height":1024,"steps":4},
+
+{"id":"p4_ai_04","phase":"phase4_ui","subfolder":"app_icons","name":"appicon_android_material",
+ "prompt":"CannaManage Android app icon 1024x1024, Material Design 3 style adaptive icon, emerald green with white icon, Google Play Store quality, cannabis management Android app icon",
+ "width":1024,"height":1024,"steps":4},
+
+{"id":"p4_ai_05","phase":"phase4_ui","subfolder":"app_icons","name":"appicon_android_dark",
+ "prompt":"CannaManage Android dark mode app icon 1024x1024, dark adaptive icon, emerald outline icon on near-black background, Material You dark theme, cannabis management app",
+ "width":1024,"height":1024,"steps":4},
+
+{"id":"p4_ai_06","phase":"phase4_ui","subfolder":"app_icons","name":"appicon_gradient_modern",
+ "prompt":"CannaManage app icon 1024x1024, modern gradient icon, forest green to bright emerald gradient background, white geometric cannabis tech mark, contemporary app icon design",
+ "width":1024,"height":1024,"steps":4},
+
+{"id":"p4_ai_07","phase":"phase4_ui","subfolder":"app_icons","name":"appicon_flat_clean",
+ "prompt":"CannaManage app icon 1024x1024, flat design icon, solid emerald green no gradient, white minimal icon mark, Flat design philosophy, simple clean cannabis management app icon",
+ "width":1024,"height":1024,"steps":4},
+
+{"id":"p4_ai_08","phase":"phase4_ui","subfolder":"app_icons","name":"appicon_neumorphic",
+ "prompt":"CannaManage app icon 1024x1024, neumorphic soft UI style, light sage green background with embossed cannabis leaf icon, subtle shadows, premium modern icon design aesthetic",
+ "width":1024,"height":1024,"steps":4},
+```
+
+#### Device Mockups — 5 device frames (1440×900 or native)
+
+```python
+{"id":"p4_dm_01","phase":"phase4_ui","subfolder":"device_mockups","name":"mockup_macbook",
+ "prompt":"CannaManage dashboard shown on MacBook Pro mockup, professional product marketing screenshot, cannabis management SaaS interface on Apple laptop, emerald green UI on screen, clean white studio background, product marketing image",
+ "width":1440,"height":900,"steps":4},
+
+{"id":"p4_dm_02","phase":"phase4_ui","subfolder":"device_mockups","name":"mockup_ipad",
+ "prompt":"CannaManage dashboard on iPad Pro mockup, cannabis management SaaS tablet interface, emerald UI on Apple iPad screen, clean marketing product shot, professional studio white background",
+ "width":1024,"height":768,"steps":4},
+
+{"id":"p4_dm_03","phase":"phase4_ui","subfolder":"device_mockups","name":"mockup_iphone",
+ "prompt":"CannaManage mobile app on iPhone mockup, cannabis management mobile interface, emerald green mobile UI on iPhone, clean product marketing shot, white background professional",
+ "width":390,"height":844,"steps":4},
+
+{"id":"p4_dm_04","phase":"phase4_ui","subfolder":"device_mockups","name":"mockup_desktop_monitor",
+ "prompt":"CannaManage dashboard on large desktop monitor mockup, cannabis management enterprise software on wide screen, dark UI visible, professional product marketing display image",
+ "width":1920,"height":1080,"steps":4},
+
+{"id":"p4_dm_05","phase":"phase4_ui","subfolder":"device_mockups","name":"mockup_android_phone",
+ "prompt":"CannaManage mobile app on Android phone mockup, cannabis management Android interface, Material Design emerald UI on Android device, product marketing shot white background",
+ "width":390,"height":844,"steps":4},
+```
+
+#### Onboarding Illustrations — 6 scenes (800×600)
+
+```python
+{"id":"p4_ob_01","phase":"phase4_ui","subfolder":"onboarding_illustrations","name":"onboard_inventory",
+ "prompt":"CannaManage onboarding illustration, inventory management scene, cannabis product shelves with digital inventory overlay, cheerful professional flat illustration style, emerald and sage green, SaaS onboarding screen art",
+ "width":800,"height":600,"steps":4},
+
+{"id":"p4_ob_02","phase":"phase4_ui","subfolder":"onboarding_illustrations","name":"onboard_compliance",
+ "prompt":"CannaManage onboarding illustration, compliance tracking scene, person reviewing cannabis regulatory documents with digital checklist overlay, confident professional flat illustration, emerald gold colors",
+ "width":800,"height":600,"steps":4},
+
+{"id":"p4_ob_03","phase":"phase4_ui","subfolder":"onboarding_illustrations","name":"onboard_analytics",
+ "prompt":"CannaManage onboarding illustration, analytics and reporting scene, business person analyzing cannabis sales charts, dashboard visualization illustration, emerald data visualization, flat modern style",
+ "width":800,"height":600,"steps":4},
+
+{"id":"p4_ob_04","phase":"phase4_ui","subfolder":"onboarding_illustrations","name":"onboard_staff",
+ "prompt":"CannaManage onboarding illustration, staff scheduling scene, team members with shift calendar, cannabis dispensary team management illustration, professional flat art emerald colors",
+ "width":800,"height":600,"steps":4},
+
+{"id":"p4_ob_05","phase":"phase4_ui","subfolder":"onboarding_illustrations","name":"onboard_pos",
+ "prompt":"CannaManage onboarding illustration, POS integration scene, cannabis point of sale system connected to management platform, tech integration flat illustration, emerald connection visualization",
+ "width":800,"height":600,"steps":4},
+
+{"id":"p4_ob_06","phase":"phase4_ui","subfolder":"onboarding_illustrations","name":"onboard_reporting",
+ "prompt":"CannaManage onboarding illustration, automated reporting scene, report documents generating automatically from cannabis data, magic automation illustration, emerald gold professional flat art",
+ "width":800,"height":600,"steps":4},
+```
+
+#### Empty States — 6 variations (600×400)
+
+```python
+{"id":"p4_es_01","phase":"phase4_ui","subfolder":"empty_states","name":"empty_no_data",
+ "prompt":"CannaManage empty state illustration 600x400, no data yet illustration, friendly cannabis leaf with empty chart, get started messaging area, emerald green minimal illustration, SaaS empty state art",
+ "width":600,"height":400,"steps":4},
+
+{"id":"p4_es_02","phase":"phase4_ui","subfolder":"empty_states","name":"empty_no_results",
+ "prompt":"CannaManage empty state illustration, no search results found, magnifying glass with cannabis leaf, friendly search empty state, emerald minimal illustration, 600x400",
+ "width":600,"height":400,"steps":4},
+
+{"id":"p4_es_03","phase":"phase4_ui","subfolder":"empty_states","name":"empty_no_alerts",
+ "prompt":"CannaManage empty state illustration, no compliance alerts, happy shield with checkmark, all clear illustration, cannabis compliance all good state, emerald green positive empty state 600x400",
+ "width":600,"height":400,"steps":4},
+
+{"id":"p4_es_04","phase":"phase4_ui","subfolder":"empty_states","name":"empty_no_members",
+ "prompt":"CannaManage empty state illustration, no members added yet, friendly people silhouettes with plus icon, cannabis club member management empty state, emerald add members illustration 600x400",
+ "width":600,"height":400,"steps":4},
+
+{"id":"p4_es_05","phase":"phase4_ui","subfolder":"empty_states","name":"empty_loading_data",
+ "prompt":"CannaManage empty state illustration, loading and processing data, gentle spinner with cannabis leaf, patient loading state illustration, emerald animated-style still illustration 600x400",
+ "width":600,"height":400,"steps":4},
+
+{"id":"p4_es_06","phase":"phase4_ui","subfolder":"empty_states","name":"empty_offline",
+ "prompt":"CannaManage empty state illustration, offline or connection error, disconnected wifi with cannabis leaf, friendly error state illustration, amber warning on emerald 600x400",
+ "width":600,"height":400,"steps":4},
+```
+
+#### Splash/Loading Screens — 4 variations (1080×1920)
+
+```python
+{"id":"p4_sp_01","phase":"phase4_ui","subfolder":"splash_screens","name":"splash_primary",
+ "prompt":"CannaManage splash screen 1080x1920, app loading screen, dark charcoal background, large centered CannaManage logo mark, subtle emerald glow effect, premium app loading screen, cannabis management SaaS",
+ "width":1080,"height":1920,"steps":4},
+
+{"id":"p4_sp_02","phase":"phase4_ui","subfolder":"splash_screens","name":"splash_emerald",
+ "prompt":"CannaManage splash screen 1080x1920, emerald green background, white logo centered, minimal loading indicator, cannabis management app splash, clean brand loading screen",
+ "width":1080,"height":1920,"steps":4},
+
+{"id":"p4_sp_03","phase":"phase4_ui","subfolder":"splash_screens","name":"splash_animated_hint",
+ "prompt":"CannaManage splash screen 1080x1920, designed for future animation, cannabis leaf particles converging into logo mark, dark background with emerald particle animation first frame, dynamic loading screen concept",
+ "width":1080,"height":1920,"steps":4},
+
+{"id":"p4_sp_04","phase":"phase4_ui","subfolder":"splash_screens","name":"splash_gradient",
+ "prompt":"CannaManage splash screen 1080x1920, dramatic dark to emerald gradient background, white CannaManage brand mark, premium loading experience, cannabis SaaS gradient splash screen",
+ "width":1080,"height":1920,"steps":4},
+```
+
+---
+
+### PHASE 5 — Brand Collateral (23 assets)
+
+#### Business Cards — 4 directions × front+back = 8 (900×504)
+
+```python
+{"id":"p5_bc_01f","phase":"phase5_collateral","subfolder":"business_cards","name":"bizcard_modern_front",
+ "prompt":"CannaManage business card front design 900x504, modern minimal style, emerald green left accent panel, white main area, name and title placeholder, cannabis management SaaS company card, premium print design",
+ "width":900,"height":504,"steps":4},
+{"id":"p5_bc_01b","phase":"phase5_collateral","subfolder":"business_cards","name":"bizcard_modern_back",
+ "prompt":"CannaManage business card back design 900x504, modern minimal style, full emerald green back with white logo centered, website and tagline, cannabis management SaaS card back",
+ "width":900,"height":504,"steps":4},
+
+{"id":"p5_bc_02f","phase":"phase5_collateral","subfolder":"business_cards","name":"bizcard_dark_front",
+ "prompt":"CannaManage business card front 900x504, dark luxury style, dark charcoal background, gold foil accent logo, premium cannabis management company business card, executive tier",
+ "width":900,"height":504,"steps":4},
+{"id":"p5_bc_02b","phase":"phase5_collateral","subfolder":"business_cards","name":"bizcard_dark_back",
+ "prompt":"CannaManage business card back 900x504, dark luxury style, full dark charcoal, gold logo and emerald accent, premium back of business card",
+ "width":900,"height":504,"steps":4},
+
+{"id":"p5_bc_03f","phase":"phase5_collateral","subfolder":"business_cards","name":"bizcard_pattern_front",
+ "prompt":"CannaManage business card front 900x504, geometric cannabis pattern accent, white card with subtle hexagonal pattern header, professional pattern business card front",
+ "width":900,"height":504,"steps":4},
+{"id":"p5_bc_03b","phase":"phase5_collateral","subfolder":"business_cards","name":"bizcard_pattern_back",
+ "prompt":"CannaManage business card back 900x504, cannabis geometric pattern full bleed, emerald hexagonal pattern background, white logo, pattern business card back",
+ "width":900,"height":504,"steps":4},
+
+{"id":"p5_bc_04f","phase":"phase5_collateral","subfolder":"business_cards","name":"bizcard_bold_front",
+ "prompt":"CannaManage business card front 900x504, bold typographic style, large emerald brand name, clean white card, cannabis management SaaS typography-forward business card",
+ "width":900,"height":504,"steps":4},
+{"id":"p5_bc_04b","phase":"phase5_collateral","subfolder":"business_cards","name":"bizcard_bold_back",
+ "prompt":"CannaManage business card back 900x504, bold style, split emerald and white back, contact details area, cannabis company card back bold design",
+ "width":900,"height":504,"steps":4},
+```
+
+#### Pitch Deck Covers — 6 variations (1920×1080)
+
+```python
+{"id":"p5_pd_01","phase":"phase5_collateral","subfolder":"pitch_deck","name":"pitch_investor_dark",
+ "prompt":"CannaManage pitch deck cover slide 1920x1080, investor presentation, dark sophisticated background, large logo centered, funding round subtitle area, premium cannabis SaaS investor deck cover",
+ "width":1920,"height":1080,"steps":4},
+
+{"id":"p5_pd_02","phase":"phase5_collateral","subfolder":"pitch_deck","name":"pitch_growth_story",
+ "prompt":"CannaManage pitch deck cover 1920x1080, growth story visual, ascending cannabis plant becoming data chart, emerald to gold gradient, investor-grade presentation cover, cannabis management platform",
+ "width":1920,"height":1080,"steps":4},
+
+{"id":"p5_pd_03","phase":"phase5_collateral","subfolder":"pitch_deck","name":"pitch_market_opp",
+ "prompt":"CannaManage pitch deck cover 1920x1080, market opportunity theme, cannabis industry size visualization, globe with highlighted legal markets, emerald professional investor presentation, 1920x1080",
+ "width":1920,"height":1080,"steps":4},
+
+{"id":"p5_pd_04","phase":"phase5_collateral","subfolder":"pitch_deck","name":"pitch_team_deck",
+ "prompt":"CannaManage pitch deck cover 1920x1080, team presentation version, professional team imagery backdrop, cannabis tech startup team slide, emerald brand, people-forward investor deck cover",
+ "width":1920,"height":1080,"steps":4},
+
+{"id":"p5_pd_05","phase":"phase5_collateral","subfolder":"pitch_deck","name":"pitch_product_demo",
+ "prompt":"CannaManage pitch deck cover 1920x1080, product demonstration deck, dashboard preview as hero visual, cannabis management SaaS product tour deck cover, emerald UI preview",
+ "width":1920,"height":1080,"steps":4},
+
+{"id":"p5_pd_06","phase":"phase5_collateral","subfolder":"pitch_deck","name":"pitch_minimal_clean",
+ "prompt":"CannaManage pitch deck cover 1920x1080, ultra-minimal clean slide, white background, large emerald brand name only, minimalist investor presentation, cannabis SaaS simple deck cover",
+ "width":1920,"height":1080,"steps":4},
+```
+
+#### One-Pager Headers — 4 variations (1200×400)
+
+```python
+{"id":"p5_op_01","phase":"phase5_collateral","subfolder":"one_pager","name":"onepager_primary",
+ "prompt":"CannaManage one-pager header 1200x400, primary brand header, emerald green full bleed, white logo and tagline, cannabis management SaaS one-page brochure header, print quality",
+ "width":1200,"height":400,"steps":4},
+
+{"id":"p5_op_02","phase":"phase5_collateral","subfolder":"one_pager","name":"onepager_feature_rich",
+ "prompt":"CannaManage one-pager header 1200x400, feature-rich header, dashboard preview glimpse, cannabis management platform features introduction header, professional SaaS marketing one-pager",
+ "width":1200,"height":400,"steps":4},
+
+{"id":"p5_op_03","phase":"phase5_collateral","subfolder":"one_pager","name":"onepager_compliance",
+ "prompt":"CannaManage one-pager header 1200x400, compliance focus version, legal and regulatory theme, cannabis compliance management software, shield and legal icons, dark professional header",
+ "width":1200,"height":400,"steps":4},
+
+{"id":"p5_op_04","phase":"phase5_collateral","subfolder":"one_pager","name":"onepager_dark_premium",
+ "prompt":"CannaManage one-pager header 1200x400, dark premium version, charcoal background with gold and emerald accents, enterprise tier one-pager, premium cannabis SaaS marketing collateral header",
+ "width":1200,"height":400,"steps":4},
+```
+
+#### Trade Show Banners — 3 concepts (800×2000 representing 33x80in proportions)
+
+```python
+{"id":"p5_ts_01","phase":"phase5_collateral","subfolder":"trade_show","name":"tradeshow_primary_brand",
+ "prompt":"CannaManage trade show pull-up banner, tall vertical format, primary brand version, emerald green top section with logo, white middle with key platform features listed, dark bottom with website CTA, cannabis management SaaS conference banner, professional exhibition display",
+ "width":800,"height":2000,"steps":4},
+
+{"id":"p5_ts_02","phase":"phase5_collateral","subfolder":"trade_show","name":"tradeshow_product_showcase",
+ "prompt":"CannaManage trade show banner tall vertical, product showcase version, dashboard UI mockup as hero visual, dark sophisticated background, emerald accents, cannabis management software exhibition display, conference pull-up banner",
+ "width":800,"height":2000,"steps":4},
+
+{"id":"p5_ts_03","phase":"phase5_collateral","subfolder":"trade_show","name":"tradeshow_compliance_focus",
+ "prompt":"CannaManage trade show banner tall vertical, compliance authority positioning, legal cannabis management expertise visual, professional regulatory compliance focus, emerald and gold tall exhibition banner, cannabis industry conference display",
+ "width":800,"height":2000,"steps":4},
+```
+
+#### Sticker/Swag Designs — 10 fun branded stickers (600×600)
+
+```python
+{"id":"p5_sk_01","phase":"phase5_collateral","subfolder":"stickers","name":"sticker_leaf_circuit",
+ "prompt":"CannaManage sticker design 600x600, cannabis leaf made of circuit traces, emerald green on white, die-cut sticker style, fun tech cannabis brand sticker, transparent background sticker art",
+ "width":600,"height":600,"steps":4},
+
+{"id":"p5_sk_02","phase":"phase5_collateral","subfolder":"stickers","name":"sticker_wordmark_badge",
+ "prompt":"CannaManage sticker badge design 600x600, rounded rectangle badge sticker, emerald green background, white CannaManage text, premium brand sticker, laptop sticker style",
+ "width":600,"height":600,"steps":4},
+
+{"id":"p5_sk_03","phase":"phase5_collateral","subfolder":"stickers","name":"sticker_compliance_hero",
+ "prompt":"CannaManage sticker 600x600, compliance superhero theme, shield with cannabis leaf and checkmark, fun illustrated sticker, emerald and gold colors, die-cut sticker design",
+ "width":600,"height":600,"steps":4},
+
+{"id":"p5_sk_04","phase":"phase5_collateral","subfolder":"stickers","name":"sticker_data_plant",
+ "prompt":"CannaManage fun sticker 600x600, cannabis plant growing into data chart bars, punchy colorful sticker art, emerald plant gold bars, square sticker design",
+ "width":600,"height":600,"steps":4},
+
+{"id":"p5_sk_05","phase":"phase5_collateral","subfolder":"stickers","name":"sticker_canna_astronaut",
+ "prompt":"CannaManage sticker 600x600, cartoon astronaut holding cannabis leaf and laptop, space tech meets cannabis industry, fun illustrated sticker, emerald spacesuit, brand mascot sticker concept",
+ "width":600,"height":600,"steps":4},
+
+{"id":"p5_sk_06","phase":"phase5_collateral","subfolder":"stickers","name":"sticker_powered_by",
+ "prompt":"CannaManage powered by sticker 600x600, powered by CannaManage badge design, small horizontal badge sticker, emerald and white, partner sticker for cannabis businesses using platform",
+ "width":600,"height":600,"steps":4},
+
+{"id":"p5_sk_07","phase":"phase5_collateral","subfolder":"stickers","name":"sticker_compliance_100",
+ "prompt":"CannaManage sticker 600x600, 100 percent compliant badge sticker, bold green circle with checkmark and percentage, fun compliance achievement sticker, cannabis business compliance badge",
+ "width":600,"height":600,"steps":4},
+
+{"id":"p5_sk_08","phase":"phase5_collateral","subfolder":"stickers","name":"sticker_hexagon_icon",
+ "prompt":"CannaManage hexagon sticker 600x600, hexagonal border with cannabis circuit icon inside, honeycomb cannabis management brand sticker, emerald hex border gold icon, premium die-cut hex sticker",
+ "width":600,"height":600,"steps":4},
+
+{"id":"p5_sk_09","phase":"phase5_collateral","subfolder":"stickers","name":"sticker_420_compliant",
+ "prompt":"CannaManage funny sticker 600x600, 420 compliant badge design, playful cannabis compliance humor, professional but fun brand sticker, emerald with gold numbers, laptop culture sticker",
+ "width":600,"height":600,"steps":4},
+
+{"id":"p5_sk_10","phase":"phase5_collateral","subfolder":"stickers","name":"sticker_manage_everything",
+ "prompt":"CannaManage sticker 600x600, manage everything tagline sticker, bold typography sticker design, emerald green background white text, punchy brand statement sticker",
+ "width":600,"height":600,"steps":4},
+```
+
+#### Email Signature Blocks — 5 variations (600×150)
+
+```python
+{"id":"p5_es_01","phase":"phase5_collateral","subfolder":"email_signatures","name":"sigsblock_primary",
+ "prompt":"CannaManage email signature graphic block 600x150, primary brand version, horizontal logo left with tagline, emerald green line divider, professional email signature banner, cannabis management SaaS",
+ "width":600,"height":150,"steps":4},
+
+{"id":"p5_es_02","phase":"phase5_collateral","subfolder":"email_signatures","name":"sigblock_dark",
+ "prompt":"CannaManage email signature block 600x150, dark version, charcoal background with white logo and emerald accent, premium email signature graphic, cannabis SaaS company",
+ "width":600,"height":150,"steps":4},
+
+{"id":"p5_es_03","phase":"phase5_collateral","subfolder":"email_signatures","name":"sigblock_minimal",
+ "prompt":"CannaManage email signature graphic 600x150, minimal version, just logo and website, very clean white background, ultra-minimal email signature banner",
+ "width":600,"height":150,"steps":4},
+
+{"id":"p5_es_04","phase":"phase5_collateral","subfolder":"email_signatures","name":"sigblock_promo",
+ "prompt":"CannaManage email signature promo block 600x150, promotional version with free trial CTA, gold button area, white background emerald brand, email signature with conversion CTA",
+ "width":600,"height":150,"steps":4},
+
+{"id":"p5_es_05","phase":"phase5_collateral","subfolder":"email_signatures","name":"sigblock_social",
+ "prompt":"CannaManage email signature block 600x150, social media icons version, small social platform icons in emerald, company signature with social links, professional email signature footer graphic",
+ "width":600,"height":150,"steps":4},
+```
+
+---
+
+### PHASE 6 — Bonus / Wildcard Assets (22 assets)
+
+#### Animated Banner First-Frame Stills — 8 concepts (1200×628)
+
+```python
+{"id":"p6_an_01","phase":"phase6_bonus","subfolder":"animated_stills","name":"anim_particle_logo",
+ "prompt":"CannaManage animated banner first frame still, cannabis leaf particles forming CannaManage logo mark, particles mid-flight, dark background emerald particles, designed for CSS/JS animation, static first frame concept 1200x628",
+ "width":1200,"height":628,"steps":4},
+
+{"id":"p6_an_02","phase":"phase6_bonus","subfolder":"animated_stills","name":"anim_data_flow",
+ "prompt":"CannaManage animated banner first frame, data flow visualization beginning, cannabis data streams starting to form dashboard, dark background emerald data lines, first frame of data animation concept 1200x628",
+ "width":1200,"height":628,"steps":4},
+
+{"id":"p6_an_03","phase":"phase6_bonus","subfolder":"animated_stills","name":"anim_growth_chart",
+ "prompt":"CannaManage animated banner still, cannabis business growth chart animation first frame, bar chart at zero about to animate upward, gold bars on dark, growth animation concept still 1200x628",
+ "width":1200,"height":628,"steps":4},
+
+{"id":"p6_an_04","phase":"phase6_bonus","subfolder":"animated_stills","name":"anim_compliance_check",
+ "prompt":"CannaManage animated banner first frame, compliance checklist items unchecked ready to animate with checkmarks, emerald checklist on white, compliance animation concept still 1200x628",
+ "width":1200,"height":628,"steps":4},
+
+{"id":"p6_an_05","phase":"phase6_bonus","subfolder":"animated_stills","name":"anim_plant_grow",
+ "prompt":"CannaManage animated banner still, cannabis plant seedling about to grow into full data visualization plant, dark background, first frame seed sprouting, growth animation concept 1200x628",
+ "width":1200,"height":628,"steps":4},
+
+{"id":"p6_an_06","phase":"phase6_bonus","subfolder":"animated_stills","name":"anim_typing_headline",
+ "prompt":"CannaManage animated banner still, typing cursor before headline text, empty headline area with blinking cursor concept, emerald CTA button below, typewriter animation first frame still 1200x628",
+ "width":1200,"height":628,"steps":4},
+
+{"id":"p6_an_07","phase":"phase6_bonus","subfolder":"animated_stills","name":"anim_integration_connect",
+ "prompt":"CannaManage animated banner still, integration ecosystem nodes about to connect, partner software logos as unconnected nodes, emerald connecting lines forming, integration animation first frame 1200x628",
+ "width":1200,"height":628,"steps":4},
+
+{"id":"p6_an_08","phase":"phase6_bonus","subfolder":"animated_stills","name":"anim_counter_stat",
+ "prompt":"CannaManage animated banner still, number counter animation first frame showing zero, gold large number about to count up to impressive stat, dark background, counter animation concept still 1200x628",
+ "width":1200,"height":628,"steps":4},
+```
+
+#### Dark Mode vs Light Mode UI Pairs — 6 paired sets (1200×800 each, 12 total)
+
+```python
+{"id":"p6_dm_01l","phase":"phase6_bonus","subfolder":"dark_light_pairs","name":"uipair_dashboard_light",
+ "prompt":"CannaManage UI preview card 1200x800, light mode dashboard interface, clean white background, emerald green UI elements, cannabis management SaaS light theme interface preview, professional SaaS UI screenshot",
+ "width":1200,"height":800,"steps":4},
+{"id":"p6_dm_01d","phase":"phase6_bonus","subfolder":"dark_light_pairs","name":"uipair_dashboard_dark",
+ "prompt":"CannaManage UI preview card 1200x800, dark mode dashboard interface, dark charcoal background, emerald green glowing UI elements, cannabis management SaaS dark theme interface preview, premium dark mode UI",
+ "width":1200,"height":800,"steps":4},
+
+{"id":"p6_dm_02l","phase":"phase6_bonus","subfolder":"dark_light_pairs","name":"uipair_compliance_light",
+ "prompt":"CannaManage UI preview 1200x800, compliance module light mode, white clean interface with compliance checklist and status indicators, emerald green checkmarks, cannabis compliance UI light theme",
+ "width":1200,"height":800,"steps":4},
+{"id":"p6_dm_02d","phase":"phase6_bonus","subfolder":"dark_light_pairs","name":"uipair_compliance_dark",
+ "prompt":"CannaManage UI preview 1200x800, compliance module dark mode, dark interface with glowing emerald compliance indicators, cannabis compliance UI dark theme, premium dark mode",
+ "width":1200,"height":800,"steps":4},
+
+{"id":"p6_dm_03l","phase":"phase6_bonus","subfolder":"dark_light_pairs","name":"uipair_analytics_light",
+ "prompt":"CannaManage UI preview 1200x800, analytics dashboard light mode, white background with colorful cannabis business charts, emerald and gold data visualization, light theme analytics UI",
+ "width":1200,"height":800,"steps":4},
+{"id":"p6_dm_03d","phase":"phase6_bonus","subfolder":"dark_light_pairs","name":"uipair_analytics_dark",
+ "prompt":"CannaManage UI preview 1200x800, analytics dashboard dark mode, dark background with glowing emerald and gold cannabis business charts, dramatic dark mode analytics UI",
+ "width":1200,"height":800,"steps":4},
+```
+
+#### Integration/Partnership Badges — 6 variations (400×200)
+
+```python
+{"id":"p6_ib_01","phase":"phase6_bonus","subfolder":"integration_badges","name":"badge_pos_integration",
+ "prompt":"CannaManage integration badge 400x200, integrates with POS systems badge, cannabis point-of-sale integration certification badge, emerald green badge design, CannaManage logo plus POS icon, professional integration badge",
+ "width":400,"height":200,"steps":4},
+
+{"id":"p6_ib_02","phase":"phase6_bonus","subfolder":"integration_badges","name":"badge_accounting",
+ "prompt":"CannaManage integration badge 400x200, accounting software integration badge, cannabis financial software connection, emerald badge with accounting icon, works with your accounting tools badge",
+ "width":400,"height":200,"steps":4},
+
+{"id":"p6_ib_03","phase":"phase6_bonus","subfolder":"integration_badges","name":"badge_compliance_tools",
+ "prompt":"CannaManage integration badge 400x200, compliance tool integration badge, cannabis regulatory software connection, emerald shield badge design, integrates with compliance tools",
+ "width":400,"height":200,"steps":4},
+
+{"id":"p6_ib_04","phase":"phase6_bonus","subfolder":"integration_badges","name":"badge_api_ready",
+ "prompt":"CannaManage API ready badge 400x200, API first platform badge, developer integration badge, emerald and code brackets design, cannabis management API integration badge",
+ "width":400,"height":200,"steps":4},
+
+{"id":"p6_ib_05","phase":"phase6_bonus","subfolder":"integration_badges","name":"badge_partner_certified",
+ "prompt":"CannaManage partner certified badge 400x200, certified technology partner badge design, emerald green official partner badge, cannabis management platform partner program badge",
+ "width":400,"height":200,"steps":4},
+
+{"id":"p6_ib_06","phase":"phase6_bonus","subfolder":"integration_badges","name":"badge_white_label",
+ "prompt":"CannaManage white label partner badge 400x200, white label ready platform badge, cannabis SaaS white label partner certification, professional partner badge emerald design",
+ "width":400,"height":200,"steps":4},
+```
+
+#### Trust/Award Badges — 5 designs (400×400)
+
+```python
+{"id":"p6_tb_01","phase":"phase6_bonus","subfolder":"trust_badges","name":"trust_gdpr_compliant",
+ "prompt":"CannaManage trust badge 400x400, GDPR compliant badge design, data protection certification badge, emerald green shield with EU star circle, cannabis SaaS data privacy trust badge",
+ "width":400,"height":400,"steps":4},
+
+{"id":"p6_tb_02","phase":"phase6_bonus","subfolder":"trust_badges","name":"trust_soc2_ready",
+ "prompt":"CannaManage trust badge 400x400, SOC 2 ready certification badge, enterprise security trust badge, professional certification seal, dark emerald badge design, cannabis management enterprise security",
+ "width":400,"height":400,"steps":4},
+
+{"id":"p6_tb_03","phase":"phase6_bonus","subfolder":"trust_badges","name":"trust_uptime_guarantee",
+ "prompt":"CannaManage trust badge 400x400, 99.9 percent uptime guarantee badge, reliability certification badge, gold uptime number on emerald badge, cannabis SaaS reliability trust signal",
+ "width":400,"height":400,"steps":4},
+
+{"id":"p6_tb_04","phase":"phase6_bonus","subfolder":"trust_badges","name":"trust_cannabis_industry_choice",
+ "prompt":"CannaManage award badge 400x400, cannabis industry choice award badge design, industry recognition award seal, gold and emerald award badge, cannabis management software award",
+ "width":400,"height":400,"steps":4},
+
+{"id":"p6_tb_05","phase":"phase6_bonus","subfolder":"trust_badges","name":"trust_money_back",
+ "prompt":"CannaManage trust badge 400x400, 30-day money back guarantee badge, customer confidence seal, emerald circle badge with guarantee text, cannabis SaaS satisfaction guarantee trust badge",
+ "width":400,"height":400,"steps":4},
+```
+
+---
+
+## Script Specification for Code Mode
+
+### File: `mcp/mcp-image-gen/cannamanage_gen.py`
+
+```
+INPUTS:
+  - ASSET_MANIFEST: Python list of dicts (inlined in script from this plan)
+  - --output-dir: output root (default ~/Pictures/cannamanage_brand/)
+  - --comfyui: ComfyUI URL (default http://localhost:8188)
+  - --model: "schnell" (default) or "heretic" (flux2_klein_heretic.json)
+  - --dry-run: print asset list without generating
+  - --phase: generate only one phase (e.g., --phase phase1_logos)
+  - --resume: skip already-completed assets (default True)
+
+OUTPUTS:
+  - ~/Pictures/cannamanage_brand/{phase}/{subfolder}/{name}.png per asset
+  - ~/Pictures/cannamanage_brand/.progress.json (resume state)
+  - Console progress: [phase1_logos] [5/42] wordmark_modern_sans — ✅ done (1.2MB)
+
+WORKFLOW SELECTION:
+  if args.model == "heretic":
+      workflow_path = REPO/src/workflows/flux2_klein_heretic.json
+  else:
+      workflow_path = REPO/src/workflows/flux_schnell.json
+
+WORKFLOW PATCH (from gen.py, same node IDs):
+  workflow["2"]["inputs"]["text"] = asset["prompt"]
+  workflow["3"]["inputs"]["text"] = ""
+  workflow["10"]["inputs"]["noise_seed"] = random seed
+  workflow["6"]["inputs"]["width"] = asset["width"]
+  workflow["6"]["inputs"]["height"] = asset["height"]
+  workflow["7"]["inputs"]["steps"] = asset["steps"]
+  workflow["13"]["inputs"]["filename_prefix"] = asset["name"]
+
+RESUME STATE SCHEMA (.progress.json):
+  {
+    "completed": ["p1_wm_01", "p1_wm_02", ...],
+    "failed": ["p2_hw_03"],
+    "started_at": "2026-04-10T23:40:00",
+    "last_updated": "2026-04-11T01:15:33"
+  }
+
+ALGORITHM:
+  1. Load .progress.json (or create empty if not exists)
+  2. filter ASSET_MANIFEST to only assets not in completed[]
+  3. For each asset:
+     a. patch workflow
+     b. POST to /prompt → get prompt_id
+     c. Poll /history/{prompt_id} every 2s (timeout 300s)
+     d. GET /view?filename=...&type=output
+     e. mkdir -p output_dir/phase/subfolder/
+     f. save PNG
+     g. add id to completed[], flush .progress.json
+     h. print progress line
+  4. Print final summary
+
+NO EXTERNAL DEPENDENCIES — stdlib only: urllib.request, json, pathlib, argparse, time, random
+```
+
+### Total Asset Count by Phase
+
+| Phase | Category | Assets |
+|---|---|---|
+| Phase 1 | Logo Suite | 42 |
+| Phase 2 | Banner Suite | 50 |
+| Phase 3 | Social Media Pack | 60 |
+| Phase 4 | UI & Product Assets | 32 |
+| Phase 5 | Brand Collateral | 38 |
+| Phase 6 | Bonus Assets | 35 |
+| **TOTAL** | | **257** |
+
+### Runtime Estimates
+
+| Model | Speed | 257 assets |
+|---|---|---|
+| flux1-schnell | ~10s/image | ~43 minutes |
+| flux2-klein-heretic | ~52s/image | ~3.7 hours |
+
+**Recommendation:** Use `flux1-schnell` (default) for overnight batch. The heretic model is
+better quality but unnecessary for concept/mockup assets at this volume.
+
+### Launch Command
+
+```bash
+# From pi_mcps root — ensure ComfyUI is running first
+systemctl --user status comfyui   # check it's running
+python mcp/mcp-image-gen/cannamanage_gen.py
+
+# With options:
+python mcp/mcp-image-gen/cannamanage_gen.py --dry-run  # preview list only
+python mcp/mcp-image-gen/cannamanage_gen.py --phase phase1_logos  # one phase only
+python mcp/mcp-image-gen/cannamanage_gen.py --model heretic  # higher quality, slower
+```
+
+---
+
+## Handoff Checklist for Code Mode
+
+- [ ] Implement `cannamanage_gen.py` at `mcp/mcp-image-gen/cannamanage_gen.py`
+- [ ] Inline all 257 assets from ASSET_MANIFEST above
+- [ ] Use `mcp/mcp-image-gen/src/workflows/flux_schnell.json` as default workflow
+- [ ] Patch workflow at exact node IDs from gen.py (nodes 2, 3, 6, 7, 10, 13)
+- [ ] Implement `.progress.json` resume state (flush after every image)
+- [ ] Stdlib only — no pip installs required
+- [ ] Test with `--dry-run` to validate manifest before first run
+- [ ] Print `[phase] [N/total] name — ✅ Xkb` per image
+- [ ] Print final summary with counts and failed list
\ No newline at end of file