Vision Index

Beam Vision — Index

Voor het complete productoverzicht zie Introductie en Vision Overzicht.

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

Documenten

Geordend op prioriteit — van fundament naar toekomst.

Prio	#	Document	Onderwerp	Status
—	—	README.md (dit bestand)	Index, glossary, dependency map, open vragen	—
🔴	01	Brand Identity	Onboarding wizard, sfeer-presets, styling builder	✅ Uitgewerkt
🔴	02	Brand JSON & Database	Brand JSON contract, Zod schema, API endpoints, DB schemas	✅ Uitgewerkt
🔴	03	Design Tokens	W3C token spec, cascade, guardrails, export	✅ Uitgewerkt
🔴	04	Business Model & Pricing	Pricing tiers, addon model, AI kosten	📋 Placeholder
🟡	05	Expansion Pack Systeem	Addon architectuur, specialisaties, synergieën, Codex	✅ Uitgewerkt
🟡	06	Guild Taxonomy	Gilden, classes, archetypes, vertical pack catalogus	✅ Uitgewerkt
🟢	07	AI Content Generatie	AI pagina-generatie + per-block hergeneratie	✅ Uitgewerkt
🟢	08	Experience & Community	Progressie, achievements, community, directory	✅ Uitgewerkt
🔵	09	Interaction Design	Micro-animaties, geluiden, Nintendo Juice	✅ Uitgewerkt

Legenda: 🔴 Fundament (moet eerst) · 🟡 Core product · 🟢 Differentiator · 🔵 Polish / later

Ondersteunende specs (notificaties, multi-language, privacy/GDPR) staan in docs/backlog/. Geen productvisie, maar technische systemen die nog uitgewerkt moeten worden.

Dependency Map

Welk document bouwt op welk ander?

01-brand-identity          ← zelfstandig: wizard + styling builder + sfeer-presets
    ↓
02-brand-json-spec         ← Brand JSON contract + alle DB schemas
    ↓
03-design-tokens           ← brand JSON → token schema (styling builder)

06-guild-taxonomy          ← optionele laag bovenop 01 (proto-guilds → guilds)
    ↓
05-expansion-system        ← addons, vertical packs, synergieën (leest tokens uit 03)
    ↓
07-ai-content              ← AI leest brand JSON + tokens + blocks uit addon systeem

08-experience-community    ← progressie, achievements, community (onafhankelijk)
09-interaction-design      ← animaties + geluiden (onafhankelijk, gilde-awareness optioneel)

Leesadvies: Begin met 01-brand-identity (wat verzamelen we bij sign-up), dan 02-brand-json-spec (het technische contract), dan 03-design-tokens (hoe vertaalt dat naar visuele identiteit). Guild taxonomy (06) is optioneel en voegt later een laag toe.

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 02-brand-json-spec.md. Samenvatting per domein:

Brand & Tokens

brand_profiles — brand JSON + design tokens per site (zie §01, §03, §02)
token_versions — snapshot history van token schemas
mood_presets — sfeer-presets 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

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