Introductie

Beam Vision — Index

Toekomstvisie voor het Beam platform. Alle documenten hier beschrijven geplande features, niet de huidige implementatiestatus.

Documenten

#	Document	Onderwerp
—	README.md (dit bestand)	Index, glossary, dependency map, open vragen
01	Brand Identity	Onboarding wizard + styling builder
02	AI Content Generatie	AI pagina-generatie + per-block hergeneratie
03	Expansion Pack Systeem	Addon architectuur, specialisaties, synergieën
04	Experience & Community	Progressie, achievements, community, directory
05	Interaction Design	Micro-animaties, geluiden, Nintendo Juice
06	Guild Taxonomy	Gilden, classes, archetypes, vertical pack catalogus
07	Design Tokens	W3C token spec, cascade, guardrails, styling builder UI
08	Brand JSON & Database	Brand JSON contract + alle database schemas

Dependency Map

Welk document bouwt op welk ander?

06-guild-taxonomy          ← basis voor bijna alles
    ↓
01-brand-identity          ← onboarding levert brand JSON + gilde selectie
    ↓
07-design-tokens           ← brand JSON → token schema (styling builder)
    ↓
03-expansion-system        ← addons lezen tokens, Style Packs zijn token sets
    ↓
02-ai-content              ← AI leest brand JSON + tokens + blocks uit addon systeem
    ↓
04-experience-community    ← progressie bouwt op addon activaties + journey milestones
    ↓
05-interaction-design      ← animaties + geluiden per gilde, gekoppeld aan alle bovenstaande
    ↓
08-brand-json-spec         ← consolidatie: contract + alle DB schemas uit alle docs

Leesadvies: Begin met 06-guild-taxonomy (wie zijn de gebruikers), dan 01-brand-identity (wat leveren ze op bij sign-up), dan 07-design-tokens (hoe vertaalt dat naar visuele identiteit).

Glossary

Term	Definitie
Gilde	Industrie/identiteitsgroep (6 total: Healers, Creators, Merchants, Scholars, Hosts, Builders)
Class	Businessmodel (5 total: Storyteller, Shopkeeper, Guide, Entertainer, Curator)
Archetype	Combinatie van Gilde × Class — wie je bent in het Beam ecosysteem
Vertical Pack	Complete site-ervaring voor een specifiek archetype (bijv. “Yoga Studio”)
Functional Addon	Losse capability-uitbreiding (bijv. Blog, Shop, Bookings)
Style Pack	Visuele identiteitset per gilde (“Healer Calm”, “Creator Bold”, etc.)
Kit	Kleine block-pack, 1-3 blocks (bijv. Pricing Kit)
Beam Codex	Visuele catalogus van alle blocks — geïnspireerd door de Pokédex
Brand JSON	Gestructureerde output van de onboarding-wizard
Token Schema	W3C Design Token spec — de geresolveerde visuele identiteit
Synergie block	Block dat alleen verschijnt als 2+ addons gecombineerd zijn
Blueprint	Complete site-setup die een vertical pack uitrolt bij onboarding
Milestone	Voortgangsstap per vertical pack (bijv. “Eerste les toegevoegd”)
Journey	5-hoofdstuk persoonlijk verhaal van de Beam-gebruiker
Achievement	Moment van erkenning voor een bijzondere actie of mijlpaal
Nintendo Juice	Meervoudige feedback-signalen per actie (visueel + audio)
Guardrail	Technische beperking die slechte keuzes onmogelijk maakt
LQIP	Low Quality Image Placeholder — blur-up thumbnail bij laden

Gedeelde Database Overzicht

Alle schemas in detail: zie 08-brand-json-spec.md. Samenvatting per domein:

Brand & Tokens

brand_profiles — brand JSON + design tokens per site (zie §01, §07, §08)
token_versions — snapshot history van token schemas
style_packs — gilde style packs als opgeslagen token sets

Addons & Content

addons — geactiveerde addons per site
vertical_packs — geactiveerde vertical packs
addon_collections — content collections (posts, products, etc.)
addon_items — items in een collection (met Block[] body)
addon_archive_pages — custom archief-page overrides
addon_taxonomies — categorieën en tags
addon_item_taxonomies — item ↔ taxonomie koppeling
content_references — cross-content relaties (synergieën)
site_milestones — vertical pack voortgang per site

AI Generatie

ai_generations — log van alle AI page-generaties
page_content_summaries — gecachede samenvattingen voor AI context
media_descriptions — AI-beschrijvingen van media items

Experience & Community

user_achievements — behaalde achievements per gebruiker
site_journey — Journey hoofdstuk + milestones per site
beam_events — event bus voor achievement triggers
beam_profiles — publieke gebruikersprofielen
connections — verbindingen tussen gebruikers
messages — directe berichten (alleen tussen verbonden gebruikers)
directory_listings — opt-in vermeldingen in de Beam Directory
user_preferences — audio, cursor en animatie-instellingen

Build Volgorde (aanbevolen)

Fase 0: Core + Infra (al live)

Huidige editor, pages, media library, Hono API, Supabase, R2.

Fase 1: Brand Fundament

brand_profiles tabel + brand JSON ontvangen (onboarding app)
Token schema opslaan + token API endpoint
OKLCH shade generator (culori)
Guardrail engine (contrast, harmonie, font-paar)
6 gilde Style Packs als seed data

Fase 2: Styling Builder

Styling Builder UI (split layout)
Live canvas met inline element selectie
WCAG contrast checks real-time
Seasonal overrides

Fase 3: AI Content

Block registry met content field descriptors
Prompt verrijkings-pipeline (brand + pagina-samenvattingen + media)
Quick generatie (één tekstveld → pagina)
Per-block hergeneratie

Fase 4: Addon Fundament

Addon manifest types + registry
Database migratie addon tabellen
Dynamische block picker met addon secties
Blog + Portfolio addons (eerste functional addons)

Fase 5: Experience

Sound engine + basis geluidseffecten
Micro-animaties op block operaties
Achievement engine + Journey systeem

Fase 6: Community

Beam profielen + connecties
Gilde Hubs
Beam Directory (opt-in)

Fase 7: Volledige Addon Suite

Shop, Bookings, Forms, Popups, Reviews
Synergieën + secret blocks
Vertical Packs + Blueprints

Fase 8: Codex & Sets

Beam Codex interface
Booster pack unboxing ervaring
Seizoensgebonden set releases

Open Vragen

#	Vraag	Beslissing nodig voor
OQ-1	Wordt de onboarding app op `start.beambuilder.com` een aparte Next.js app of een Astro/Vite route binnen het bestaande platform?	Fase 1
OQ-2	Supabase of aparte database voor onboarding app?	Fase 1
OQ-3	Welk AI model voor content generatie: Claude (voorkeur) of configureerbaar per site?	Fase 3
OQ-4	Zijn Style Packs hardcoded seed data of beheerbaar via een admin-interface?	Fase 4
OQ-5	Hoe werkt de addon public site rendering in Astro voor custom routes? Middleware of file-based routing override?	Fase 4
OQ-6	Stockfoto’s in Asset Packs: Unsplash/Pexels API bij activatie, of vooraf gecachete R2 assets?	Fase 7
OQ-7	Worden achievements gedreven door de bestaande `beam_events` tabel, of via een aparte event bus (Cloudflare Queue)?	Fase 5
OQ-8	Directory screenshot generatie: Puppeteer op Worker (memory-intensief) of Cloudflare Browser Rendering API?	Fase 6
OQ-9	Pricing model voor addons: per addon, per vertical pack, of flat-rate per tier?	Vóór launch
OQ-10	GDPR: welke data valt onder “gebruikersdata” die exporteerbaar/verwijderbaar moet zijn?	Vóór launch