cannamanage/docs/TOURGUIDE.md

# 🌿 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*