docs: record 'Oops' crash fix (intl + PWA middleware) verified via Playwright

2026-06-13 10:45:44 +02:00
parent 4be9c4cf2c
commit 26a77b5e16
2 changed files with 210 additions and 0 deletions
@@ -0,0 +1,160 @@
+# 🌿 CannaManage — Local Test Tour Guide
+
+**URL:** http://192.168.188.119:3000  
+**Stack:** Next.js frontend → Spring Boot backend → PostgreSQL  
+**Deployed on:** TrueNAS.local (`/mnt/VM_SSD_Pool/cannamanage/`)
+
+---
+
+## 🔐 Login Credentials
+
+| Field | Value |
+|-------|-------|
+| Email | `admin@test.de` |
+| Password | `test123` |
+| Role | `ROLE_ADMIN` |
+| Club | Grüner Daumen e.V. (Berlin) |
+
+Go to **http://192.168.188.119:3000** → you'll land on the login page → enter the credentials above.
+
+---
+
+## 🗺️ What's Been Built — Where to Look
+
+### 1. Marketing / Public Pages (no login required)
+
+These are the public-facing pages Sprint 6 just shipped:
+
+| URL | What you'll see |
+|-----|-----------------|
+| `/pricing` | 3-tier pricing: Starter €19, Pro €49, Enterprise |
+| `/impressum` | Legal imprint placeholder |
+| `/datenschutz` | Privacy policy placeholder |
+| `/agb` | Terms of service placeholder |
+
+> These pages use a separate layout (no sidebar, no auth). The footer links to them from login page and portal.
+
+---
+
+### 2. The Portal (after login)
+
+Once you log in as `admin@test.de`, you're in the **club management portal** for *Grüner Daumen e.V.*
+
+#### 📊 Dashboard
+The main overview. Should show club stats, recent activity, quick links.
+
+#### 👥 Members
+5 test members pre-loaded:
+
+| Name | Email | Age | Membership # | Notes |
+|------|-------|-----|--------------|-------|
+| Max Mustermann | max@test.de | Adult | M-001 | Regular member |
+| Anna Schmidt | anna@test.de | Adult | M-002 | Regular member |
+| Jonas Weber | jonas@test.de | **Under 21** | M-003 | ⚠️ THC restricted |
+| Lisa Meyer | lisa@test.de | Adult | M-004 | Regular member |
+| Tom Fischer | tom@test.de | Adult | M-005 | Regular member |
+
+> **Try:** Click on Jonas Weber — his under-21 flag means he can only receive CBD strains and has a lower monthly limit (30g vs 50g).
+
+#### 🌱 Strains / Batches
+3 test strains and 3 available batches:
+
+| Strain | THC | CBD | Batch Code | Stock |
+|--------|-----|-----|------------|-------|
+| Northern Lights | 18.5% | 0.8% | BATCH-2024-001 | 500g |
+| Amnesia Haze | 22.0% | 1.2% | BATCH-2024-002 | 300g |
+| CBD Critical Mass | 5.0% | 12.0% | BATCH-2024-003 | 200g |
+
+> **Try:** Attempt to distribute Amnesia Haze (22% THC) to Jonas Weber — the compliance engine should **block it** (under-21 THC limit enforcement).
+
+#### 📦 Distributions / POS
+Try recording a distribution:
+1. Select a member (e.g., Max Mustermann)
+2. Select a batch (e.g., Northern Lights)
+3. Enter quantity in grams (e.g., 5g)
+4. Submit
+
+The backend compliance check runs: member active? batch available? THC ok? daily limit (25g)? monthly limit (50g)?
+
+> **Stress test:** Try distributing 30g in one go to Max — it should be blocked (daily limit is 25g per CanG).
+
+#### 👔 Staff Management (Sprint 3)
+Staff invite flow. You can invite staff members via email and assign roles. Check the staff list page.
+
+#### ⚙️ Club Settings
+Club details: name, address, license number, max members cap (500). Edit fields and save.
+
+---
+
+## 🧪 Compliance Engine — What to Test
+
+These are the core legal compliance rules from CanG (Cannabis Act):
+
+| Test | How | Expected result |
+|------|-----|-----------------|
+| Under-21 + high THC strain | Distribute Amnesia Haze to Jonas Weber | ❌ Blocked |
+| Under-21 + CBD strain | Distribute CBD Critical Mass to Jonas | ✅ Allowed (≤10% THC) |
+| Over daily limit | Try 26g for Max in one distribution | ❌ Blocked (max 25g/day) |
+| Over monthly limit | Try distributing 50g total to one member | ❌ Blocked (max 50g/month, 30g for under-21) |
+| Valid distribution | 5g Northern Lights to Anna Schmidt | ✅ Approved |
+
+---
+
+## 📑 API (for nerds)
+
+The Spring Boot API is exposed at **http://192.168.188.119:8080**
+
+Swagger UI (if enabled): http://192.168.188.119:8080/swagger-ui/index.html  
+Health check: http://192.168.188.119:8080/actuator/health
+
+### Get a JWT token:
+```bash
+curl -X POST http://192.168.188.119:8080/api/v1/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"email":"admin@test.de","password":"test123"}'
+```
+
+---
+
+## 🐳 Container Management
+
+All running on TrueNAS at `/mnt/VM_SSD_Pool/cannamanage/`:
+
+```bash
+# Check status
+ssh truenas.local "docker ps --filter name=cannamanage"
+
+# View backend logs
+ssh truenas.local "docker logs cannamanage-backend -f --tail=50"
+
+# View frontend logs  
+ssh truenas.local "docker logs cannamanage-frontend -f --tail=50"
+
+# Restart everything
+ssh truenas.local "cd /mnt/VM_SSD_Pool/cannamanage && docker compose -f docker-compose.yml -f docker-compose.truenas.yml restart"
+
+# Stop everything
+ssh truenas.local "cd /mnt/VM_SSD_Pool/cannamanage && docker compose -f docker-compose.yml -f docker-compose.truenas.yml down"
+
+# Pull latest + rebuild
+ssh truenas.local "cd /mnt/VM_SSD_Pool/cannamanage && git pull && docker compose -f docker-compose.yml -f docker-compose.truenas.yml up -d --build"
+```
+
+---
+
+## 🌍 i18n — Language Toggle
+
+The app has German and English translations. Look for a language switcher in the UI — should be visible on login page and in the portal header. Marketing pages (`/pricing` etc.) are also bilingual.
+
+---
+
+## ⚠️ Known Limits of the Test Environment
+
+- Legal page texts (`/impressum`, `/datenschutz`, `/agb`) are **placeholder templates** — not real legal text
+- Pricing page is a **mockup** — Stripe is not integrated yet
+- Email sending (staff invites) is not wired to a real mail server in dev
+- The "seed data" dates are from 2024 — the compliance quota engine uses current month/year, so the pre-seeded distributions won't count against current monthly limits
+
+---
+
+*Generated by Lumen — Homelab Mode — 2026-06-13*