Internt dokument · v1.0
Manifest
Detta dokument är projektets pedagogiska och arkitektoniska grundlag. Varje framtida beslut — pedagogiskt, designmässigt eller tekniskt — ska kunna härledas härifrån.
01
Produktprinciper
Visualisering före textmängd
Vi förklarar genom att göra samband synliga, inte genom långa texter.
Förståelse före facit
Appen hjälper användaren att förstå varför något händer, inte bara vad svaret är.
Plattform före enskilda simuleringar
Visual Science är ett återanvändbart ramverk — inte en samling separata övningar.
Kvalitet före kvantitet
Hellre få stabila simuleringar än många ytliga.
Stabilitet före effektjakt
Designen får aldrig göra appen långsam, rörig eller instabil.
02
Designprinciper
Förstklassig och futuristisk
Professionell, lugn, tydlig, exklusiv. Inspirerad av Apple, Linear, Vercel — men eget uttryck.
Ingen barnslighet, ingen spelifiering
Allvar utan tråkighet. Inga onödiga effekter, inga generiska utbildningsmallar.
Konsekvent system
Färg, typografi och komponenter definieras en gång i designsystemet och återanvänds.
Tillgänglighet från början
God kontrast, tydlig typografi, tangentbordsstöd, begriplig struktur.
03
Tekniska principer
React + TypeScript + Tailwind
Modern, ren och skalbar frontend. Inga onödiga beroenden.
Modulär arkitektur
Varje simulering är ett modulobjekt enligt SimulationModule-kontraktet.
Ingen backend i v1
Ingen inloggning, ingen databas, ingen datainsamling. Allt körs lokalt i webbläsaren.
Återanvändning före speciallösningar
Komponenter byggs för att fungera över ämnen och simuleringar.
Långsiktig förvaltning
Tydlig filstruktur, dokumenterade kontrakt, små stabila enheter.
04
Pedagogiska principer
Varje element har ett syfte
Varje reglage, animation, färg och graf existerar för att göra något begripligt.
Synliggör variabler
Eleven ska kunna se hur en förändring i en variabel påverkar resultatet i realtid.
Vardagligt språk först
Förklaringar börjar i konkret språk innan formler introduceras.
Hantera missuppfattningar
Varje modul listar och adresserar vanliga felaktiga föreställningar.
05
Regler för framtida simuleringar
Samma kontrakt
Alla moduler följer SimulationModule i src/lib/simulations/types.ts.
Samma struktur per modul
Intro · Variabler · Visualisering · Förklaring · Fördjupning · Missuppfattningar · Reflektion · Lärarstöd · Begränsningar.
Registreras centralt
Nya moduler läggs till i src/lib/simulations/registry.ts — inga andra filer behöver ändras.
Inga sidoeffekter
En modul får inte påverka global state eller andra moduler.