G138 — Claudes Copilot
Gruppeprosjekt i IBE160 Programmering med KI ved Høgskolen i Molde, høsten 2026 (15 studiepoeng).
Repoet inneholder gruppens applikasjon og dokumentasjon av utvikling, testing og kvalitetssikring med KI.
Live: https://g138-skotheimsvik.vercel.app/
Medlemmer
Prosjekt: LearningHub
LearningHub er en nettside der du trener hverdagsferdigheter i korte, poengdrevne runder. Alle trenerne bruker den samme kjerneløkken:
prompt → svar → umiddelbar tilbakemelding → poeng/streak → neste
Innholdet er delt i tre nivåer: kategori → trener → tema.
| Kategori | Trenere |
|---|
| Math | Mental Math Sprint |
| Memory | Pattern Memory, Figure Pairs |
| Geography | Flag Guesser, Outline Guesser, Capital Guesser |
| People | Famous People |
Du velger nivået selv
Hver trener tilbyr fire vanskelighetsgrader — Beginner, Intermediate, Advanced og Expert — og hver grad er sin egen dagsoppgave med eget forsøk og egen rekord. Du kan spille Beginner om morgenen og Expert om kvelden; det er to forskjellige oppgaver.
Innenfor én grad er oppgaven den samme for alle i hele verden den dagen. Det er det som gjør en poengsum verdt å ha. Oppgavene genereres deterministisk fra treneren, nivået og datoen.
Hukommelse er unntaket: et tilfeldig mønster kan ikke meningsfullt forfattes som «intermediate», så der velger du brettstørrelse i stedet. Hver størrelse er sin egen dagsoppgave med sin egen rekord.
Famous People er det andre unntaket: der velger du emne — alt, musikk, film, sport, vitenskap eller historie. Hvert emne er sin egen dagsoppgave, så å være god på musikk telles for seg. Lista er på 1134 personer, og de mest kjente vises med portrett i tillegg til hintet.
Rundene slutter på tre måter
| Modus | Slutter når | Brukes av |
|---|
| Timed | Tiden går ut | Mental Math Sprint |
| Lives | Du er tom for liv | Geografi-trenerne (3 liv), Famous People (3 liv), Pattern Memory (1 liv) |
| Completion | Brettet er tomt | Figure Pairs |
Figure Pairs scorer feil, ikke riktige — der er lavest best. Famous People gir deg 15 personer per dag: gjetter du feil, får du se navnet før du går videre.
Å starte en runde forbruker forsøket
Forsøket brukes opp i det du starter, ikke når du er ferdig. Går du ut underveis, blir runden registrert med det du hadde klart så langt. Bytter du nivå midt i en runde, avsluttes den du forlot på samme måte. Det finnes ingen gratis omstart og ingen måte å kikke på dagens oppgave og trekke seg.
Practice mode
Ved siden av dagsoppgavene ligger en practice mode: ubegrenset, uten poeng og fullt konfigurerbar. Det er her filtrene bor — slå av alt unntatt algebra, velg bare Afrika, velg 6×6-brett. Practice-runder vises med full statistikk, men lagres aldri og påvirker aldri en rekord. En konfigurerbar runde er ikke sammenlignbar med noen andres.
Arkiv
Alle tidligere dagers oppgaver ligger i arkivet og teller likt med dagens. Det betyr at en sensor alltid har noe å spille, selv om dagens forsøk er brukt opp. Arkivet går tilbake til 1. oktober 2026.
Etter runden
Du ser antall riktige, nøyaktighet, hastighet og streak — og hvordan du gjorde det mot forrige forsøk og din beste noensinne på akkurat det nivået. Din virkelige motstander er deg selv i går.
Merk om dagsgrensen: den lagres i nettleseren, ikke på en server. Den kan omgås ved å tømme lagring eller bruke privat vindu, og en sideoppdatering midt i en runde unnslipper også forbruksregelen. Det er et bevisst valg i v1 — grensen skal bygge vane, ikke håndheve noe. Reell håndheving krever innlogging og server, som ligger i fase 2.
Full beskrivelse av konsept, omfang og suksesskriterier ligger i product-brief.md, og kravene i docs/PRD.md.
Hvorfor vi byttet idé
Prosjektet startet som GameHub, en tjeneste for å oppdage spill og velge hva man skulle spille. Vi gikk bort fra den idéen 5. oktober 2026 av to grunner.
Avhengighet av eksterne tjenester. Alt innhold måtte hentes fra et eksternt spill-API, og flere av de planlagte funksjonene krevde ytterligere betalte eller nøkkelbeskyttede tjenester. Det bryter med prinsippet om «no strings attached» og ville gjort at sensor ikke kunne kjøre applikasjonen uten våre egne API-nøkler.
Kjernefunksjonen lot seg ikke bygge. GameHub skulle anbefale hva du burde spille ut fra hvor mye du hadde spilt noe og når du sist spilte det. De dataene ligger inne hos hver enkelt plattform. Å hente spilletid ut av Steam, Epic, Xbox og PlayStation ville krevd en egen integrasjon mot hver av dem — og for et spill som Minecraft, som kjører gjennom flere ulike launchere uten én autoritativ kilde for spilletid, var det i praksis umulig. Uten pålitelig spilletid ville anbefalingene blitt gjetning.
LearningHub gir like mye egen logikk å utvikle og teste — spørsmålsgeneratorer, tidtaking, poengberegning og progresjonsanalyse — med innhold vi eier selv og data applikasjonen produserer selv.
Kjøre prosjektet
Du trenger Node.js 18 eller nyere. Ingen andre avhengigheter, ingen API-nøkler, og ingen byggesteg.
git clone https://github.com/IBE160-2026/G138-skotheimsvik.git
cd G138-skotheimsvik
npm run serve
Åpne så http://localhost:8080.
Applikasjonen må serveres over HTTP fordi nettleseren blokkerer ES-moduler og fetch av innholdsfilene over file://. Serveren i tools/serve.js bruker kun Node sitt standardbibliotek.
Kjøre testene
npm test
87 tester kjører med Node sin innebygde test runner (node --test) — ingen testrammeverk å installere. Hver test er navngitt etter kravet og brukerhistorien den verifiserer, for eksempel each level adds exactly one tile (FR-117, S15). Testmatrisen i tests/matrix.test.js spiller alle trener- og variantkombinasjoner til en naturlig slutt.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
