# ADMINVERKTYG — RAPPORTFLÖDE (Back-engineerad)
## Jesper Melin Demo Case → Generisk Systemstruktur

---

## 1. RAPPORTKOMPONENTER (vad som skapades för Jesper)

### 1.1 Input-data (kundens produkt)
```
Produkt: Fasting Support Spray™
- Typ: Munsprej
- Ingredienser: Elektrolyter, vitaminer, växtbaserade extrakt
- Användning: Periodisk fasta, keto
- Format: 30ml pocket
- Pris: Premium (15-25 EUR/USD)
- Certifieringar: GMP, vegansk, sockerfri
```

### 1.2 Output-sektioner (rapporten)
1. **Sammanfattning** — Topp 5 marknader, strategi, investering
2. **Produktdefinition & Målgrupp** — TAM/SAM/SOM, segmentering
3. **Marknadsmatris** — Rankningskriterier, marknadsranking per land
4. **Konkurrensanalys** — Direkta/indirekta konkurrenter, SWOT
5. **Omvärldsanalys** — Makrotrender, drivkrafter, risker
6. **Etableringsstrategi** — Fasad approach, budget, mätpunkter
7. **Produktanpassning** — Per marknad: smak, förpackning, påståenden
8. **Finansiell projektion** — Investering, omsättning, marginal
9. **Riskanalys** — Sannolikhet, impact, mitigering
10. **Rekommendation** — Omedelbara/kortsiktiga/långsiktiga åtgärder
11. **Datakällor & Metodologi** — Primär/sekundärdata, metoder
12. **Appendix** — Djupanalyser per marknad, konkurrent deep-dives

---

## 2. SYSTEMFLÖDE (no-code)

### Steg 1: PRODUKTINPUT (kunden fyller i)
```
┌─────────────────────────────────────┐
│  PRODUKTINPUT-FORMULÄR              │
├─────────────────────────────────────┤
│  • Produktnamn                      │
│  • Produkttyp (dropdown)            │
│  • Ingredienser/teknik              │
│  • Användningsområde                │
│  • Format/storlek                   │
│  • Prisnivå                         │
│  • Certifieringar                   │
│  • Målgrupp (förifylld från typ)    │
│  • Nuvarande marknader              │
│  • Konkurrenter (frivilligt)        │
└─────────────────────────────────────┘
```

### Steg 2: AUTOMATISK DATAHÄMTNING (systemet)
```
┌─────────────────────────────────────┐
│  DATAMOTOR                            │
├─────────────────────────────────────┤
│  A. Marknadsdata (Landvex intern)   │
│     • quiXzoom fältdatainsamling    │
│     • Stadsmässig data              │
│     • Marknadstrender               │
│                                     │
│  B. Extern data (APIer)             │
│     • Google Trends API             │
│     • Statista/Euromonitor          │
│     • Nationell statistik           │
│     • E-handelsdata                 │
│                                     │
│  C. Konkurrensdata                  │
│     • Amazon/Alibaba scraping       │
│     • Prisjämförelse                │
│     • Review-analys                 │
│                                     │
│  D. Regulatorisk data               │
│     • EU-förordningar (EUR-Lex)     │
│     • FDA-databas                   │
│     • Nationella myndigheter        │
└─────────────────────────────────────┘
```

### Steg 3: ANALYS & BERÄKNING (systemet)
```
┌─────────────────────────────────────┐
│  ANALYSMOTOR                        │
├─────────────────────────────────────┤
│  1. Marknadsstorleksberäkning       │
│     • TAM = Global marknad × segment│
│     • SAM = TAM × geografisk andel  │
│     • SOM = SAM × realistisk andel  │
│                                     │
│  2. Marknadsranking                 │
│     • Viktad skoringsmodell         │
│     • Kriterier: storlek, reglering,│
│       e-handel, konkurrens, kultur, │
│       logistik                      │
│                                     │
│  3. Konkurrensmapping               │
│     • Direkta vs indirekta          │
│     • Prispositionering             │
│     • Differentieringsfaktorer      │
│                                     │
│  4. Trendanalys                     │
│     • Makrotrender (PESTEL)         │
│     • Drivkrafter                   │
│     • Risker                        │
│                                     │
│  5. Finansiell modell               │
│     • Investeringsbehov per fas     │
│     • Omsättningsprojektion         │
│     • Marginalstruktur              │
│     • Break-even-analys             │
└─────────────────────────────────────┘
```

### Steg 4: RAPPORTGENERERING (systemet)
```
┌─────────────────────────────────────┐
│  RAPPORTGENERERARE                  │
├─────────────────────────────────────┤
│  • Mallbaserad (Markdown/HTML/PDF)  │
│  • Variabler fylls i automatiskt    │
│  • Grafer genereras (Chart.js/D3)   │
│  • Källor listas automatiskt        │
│  • Spårbarhet: varje påstående har  │
│    en datakälla länkad              │
└─────────────────────────────────────┘
```

### Steg 5: GRANSKNING & EXPORT (kunden)
```
┌─────────────────────────────────────┐
│  GRANSKNINGSGRÄNSSNITT              │
├─────────────────────────────────────┤
│  • Förhandsvisning av rapport       │
│  • Redigera sektioner               │
│  • Lägg till kommentarer            │
│  • Godkänn / begär ändringar        │
│  • Export: PDF, Word, HTML          │
│  • Dela: Länk, e-post, Slack        │
└─────────────────────────────────────┘
```

---

## 3. DATAMODELL (databasstruktur)

### 3.1 Produkter (products)
```sql
CREATE TABLE products (
  id UUID PRIMARY KEY,
  name VARCHAR(255),
  type VARCHAR(100), -- enum: spray, capsule, powder, device, etc.
  description TEXT,
  ingredients JSONB,
  usage_scenarios JSONB,
  format VARCHAR(100),
  price_range_min DECIMAL,
  price_range_max DECIMAL,
  currency VARCHAR(3),
  certifications JSONB,
  target_audience JSONB,
  current_markets JSONB,
  created_by UUID,
  created_at TIMESTAMP,
  updated_at TIMESTAMP
);
```

### 3.2 Marknader (markets)
```sql
CREATE TABLE markets (
  id UUID PRIMARY KEY,
  country_code CHAR(2),
  country_name VARCHAR(100),
  population INTEGER,
  gdp_per_capita DECIMAL,
  e_commerce_penetration DECIMAL,
  if_trend_index INTEGER,
  keto_adoption VARCHAR(20),
  regulatory_environment VARCHAR(20),
  competition_level VARCHAR(20),
  cultural_acceptance INTEGER,
  logistics_ease INTEGER,
  data_sources JSONB,
  updated_at TIMESTAMP
);
```

### 3.3 Konkurrenter (competitors)
```sql
CREATE TABLE competitors (
  id UUID PRIMARY KEY,
  name VARCHAR(255),
  product_type VARCHAR(100),
  price DECIMAL,
  currency VARCHAR(3),
  markets JSONB,
  channels JSONB,
  strengths TEXT,
  weaknesses TEXT,
  threat_level VARCHAR(20),
  data_source VARCHAR(255),
  updated_at TIMESTAMP
);
```

### 3.4 Rapporter (reports)
```sql
CREATE TABLE reports (
  id UUID PRIMARY KEY,
  product_id UUID REFERENCES products(id),
  title VARCHAR(255),
  status VARCHAR(20), -- draft, review, approved, archived
  content JSONB, -- strukturerad rapportdata
  generated_at TIMESTAMP,
  generated_by UUID,
  approved_by UUID,
  approved_at TIMESTAMP,
  version INTEGER,
  parent_report_id UUID -- för versionering
);
```

### 3.5 Datakällor (data_sources)
```sql
CREATE TABLE data_sources (
  id UUID PRIMARY KEY,
  name VARCHAR(255),
  type VARCHAR(50), -- internal, api, scraper, manual
  url VARCHAR(500),
  api_key_encrypted TEXT,
  last_sync TIMESTAMP,
  sync_frequency VARCHAR(20),
  reliability_score INTEGER,
  active BOOLEAN
);
```

---

## 4. API-ENDPOINTS (för integrationer)

```
POST   /api/v1/products              # Skapa produkt
GET    /api/v1/products/:id          # Hämta produkt
PUT    /api/v1/products/:id          # Uppdatera produkt
DELETE /api/v1/products/:id          # Ta bort produkt

POST   /api/v1/reports               # Generera rapport
GET    /api/v1/reports/:id           # Hämta rapport
PUT    /api/v1/reports/:id/approve   # Godkänn rapport
GET    /api/v1/reports/:id/export    # Exportera rapport (PDF/Word)

GET    /api/v1/markets               # Lista marknader
GET    /api/v1/markets/:code         # Hämta specifik marknad
GET    /api/v1/markets/:code/trends  # Hämta trenddata

GET    /api/v1/competitors           # Lista konkurrenter
POST   /api/v1/competitors           # Lägg till konkurrent

GET    /api/v1/data-sources          # Lista datakällor
POST   /api/v1/data-sources/:id/sync # Tvinga synkronisering
```

---

## 5. FRONTEND-KOMPONENTER (React/Vue)

### 5.1 Produktskapare
```
┌─────────────────────────────────────┐
│  Steg 1: Grundinfo                  │
│  [Produktnamn    ] [Typ ▼]         │
│                                     │
│  Steg 2: Tekniska specs             │
│  [Ingredienser   ] [Format ▼]      │
│  [Användning     ] [Pris ▼]        │
│                                     │
│  Steg 3: Målgrupp                   │
│  ☑ Biohackers  ☑ Hälsomedvetna     │
│  ☑ Keto        ☑ Fastande          │
│                                     │
│  [Generera rapport →]               │
└─────────────────────────────────────┘
```

### 5.2 Rapportvisare
```
┌─────────────────────────────────────┐
│  📊 Marknadsrapport                 │
│  Fasting Support Spray™             │
├─────────────────────────────────────┤
│  ┌─────────────────────────────┐   │
│  │  Marknadsranking            │   │
│  │  [Graf: Topp 5 länder]      │   │
│  └─────────────────────────────┘   │
│                                     │
│  ┌─────────────────────────────┐   │
│  │  Konkurrenslandskap         │   │
│  │  [Graf: Pris vs Position]   │   │
│  └─────────────────────────────┘   │
│                                     │
│  ┌─────────────────────────────┐   │
│  │  Investeringsprojektion     │   │
│  │  [Graf: Omsättning över tid]│   │
│  └─────────────────────────────┘   │
│                                     │
│  [Redigera] [Exportera PDF] [Dela] │
└─────────────────────────────────────┘
```

### 5.3 Datakontrollpanel
```
┌─────────────────────────────────────┐
│  📡 Datakällor                      │
├─────────────────────────────────────┤
│  🟢 quiXzoom API        Senast: 5m │
│  🟢 Google Trends       Senast: 1h │
│  🟡 Statista API        Senast: 6h │
│  🔴 Euromonitor         Senast: 2d │
│                                     │
│  [Synkronisera alla]                │
└─────────────────────────────────────┘
```

---

## 6. AUTOMATISERAD SONDINHÄMTNING (quiXzoom-integration)

### 6.1 Triggervillkor
```
När rapport genereras för produkttyp X:
  1. Kontrollera om quiXzoom har data för relevanta marknader
  2. Om JA: Hämta fältdatainsamling
  3. Om NEJ: Skapa automatisk sond (mission) för datainsamling
```

### 6.2 Sondtyp per produktkategori
```
Produkttyp: Kosttillskott/fastaprodukter
Sondtyp:    Butiksgång (retail audit)
Data:       • Pris på konkurrerande produkter
            • Förekomst på hyllor
            • Prominens (end cap, etc.)
            • Utgångsdatum (freshness)
            
Produkttyp: Infrastruktur/IoT
Sondtyp:    Fältobservation
Data:       • Fysisk tillstånd
            • Installation
            • Användning
            
Produkttyp: Fastighet/retail
Sondtyp:    Platsbesök
Data:       • Fotodokumentation
            • Mänsklig trafik
            • Konkurrensnärhet
```

### 6.3 Automatisk rapportuppdatering
```
När sonddata inkommer:
  1. Matcha mot befintlig rapport
  2. Uppdatera relevanta sektioner
  3. Flagga ändringar för granskning
  4. Skicka notis till rapportägare
```

---

## 7. ROLLER & BEHÖRIGHETER

| Roll | Behörigheter |
|------|--------------|
| **Admin** | Allt: skapa, redigera, ta bort, godkänna, exportera |
| **Analytiker** | Skapa produkter, generera rapporter, redigera utkast |
| **Granskare** | Granska rapporter, godkänna, lägga till kommentarer |
| **Kund** | Se egna rapporter, exportera, dela |
| **Gäst** | Se demo-rapporter (anonymiserade) |

---

## 8. IMPLEMENTERINGSPLAN

### Fas 1: MVP (4 veckor)
- [ ] Produktskapare (grundläggande formulär)
- [ ] Rapportgenerator (Markdown, statisk)
- [ ] Marknadsdata (manuell inmatning + Statista API)
- [ ] Export (PDF)

### Fas 2: Automation (4 veckor)
- [ ] Google Trends-integration
- [ ] Automatisk konkurrensmapping
- [ ] Finansiell modell
- [ ] Datakontrollpanel

### Fas 3: quiXzoom-integration (4 veckor)
- [ ] API-koppling till quiXzoom
- [ ] Automatisk sondskapande
- [ ] Realtidsdata i rapporter
- [ ] Karta med fältdatainsamling

### Fas 4: Avancerat (4 veckor)
- [ ] AI-driven insiktsgenerering
- [ ] Scenario-planering
- [ ] Samarbetsverktyg (kommentarer, versionering)
- [ ] White-label (kundens varumärke på rapporter)

---

## 9. TEKNISK STACK (förslag)

| Komponent | Teknik |
|-----------|--------|
| **Frontend** | React + TypeScript + Tailwind CSS |
| **Backend** | Node.js + Express / Python + FastAPI |
| **Databas** | PostgreSQL + Redis (cache) |
| **Rapportgenerering** | Puppeteer (PDF), React-PDF |
| **Grafer** | Chart.js / D3.js / Recharts |
| **API-integrationer** | REST + GraphQL |
| **Filhantering** | AWS S3 |
| **Autentisering** | Auth0 / AWS Cognito |
| **Hosting** | AWS (ECS/Lambda) |

---

## 10. DEMO-CASE: Jesper Melin → Generisk mall

### Från specifik till generisk:

| Jespers produkt | Generisk parameter |
|-----------------|-------------------|
| Fasting Support Spray™ | `{product_name}` |
| Munsprej | `{product_type}` |
| Elektrolyter, vitaminer | `{ingredients}` |
| Periodisk fasta | `{usage_scenarios}` |
| 30ml | `{format}` |
| Premium (15-25 EUR) | `{price_range}` |
| Sverige, Tyskland, etc. | `{top_markets}` |
| LMNT, Snake Juice | `{competitors}` |

### Mall-exempel:
```markdown
# Marknadsintelligensrapport
## {product_name}

## SAMMANFATTNING
{product_name} är en {product_type} med potential inom 
{primary_market}. Marknaden växer med {cagr}% CAGR.

**Rekommenderad prioritet:**
{for each top_market}
1. **{country}** — {key_reason}
{end}

## 1. PRODUKTDEFINITION
| Attribut | Beskrivning |
|----------|-------------|
| **Produkttyp** | {product_type} |
| **Ingredienser** | {ingredients} |
| **Användning** | {usage_scenarios} |
| **Format** | {format} |
| **Pris** | {price_range} {currency} |
```

---

*Dokument producerat av Landvex Control Intelligence.*
*Datum: 2026-07-05*
*Version: 1.0 (MVP-specifikation)*