gaetan/knowledgify

Wayfinder map: Anki-like spaced repetition web app for culture générale #1

New issue

Open

opened 2026-08-20 13:58:18 +02:00 by gaetan · 0 comments

gaetan commented

2026-08-20 13:58:18 +02:00

Owner

Destination

A small, single-user web app that delivers French "culture générale" content via spaced repetition flashcards — curated facts and Q&A, not user-generated content. Go backend with a simple web UI.

Notes

• Stack: Go (per .oc-forge.yaml)
• This is a planning effort — produce decisions, not deliverables
• One ticket per decision, sized for one 100K token agent session
• The user speaks French but engineering work is in English

Decisions so far

Content model — Q&A + Vrai/Faux cards, 7 categories (4 at launch), freeform tags, one JSON file per category, numeric IDs, optional explanation field
User model — No auth, SQLite for progress, SM-2 fields (next_review, interval, ease_factor, repetitions, last_review), no decks
Content source — Manually authored JSON, 100-200 cards at launch, direct JSON editing, French-only, JSON→DB sync on startup
Tech stack — net/http (stdlib) backend, Go templates + Alpine.js frontend, no build step
Data storage — Cards in DB (upserted from JSON), hash-based sync, modernc.org/sqlite, KNOWLEDGIFY_DB env var
SRS algorithm — SM-2, 4 buttons (Again/Hard/Good/Easy) + keyboard shortcuts (1-4), max 10 new cards/day, interval cap 30 days
Card review UI — Anki-style (space+1-4), minimal card with category badge + progress, Vrai/Faux no reveal step, post-session summary
Dashboard and stats — Dashboard home + category overview at launch, stats page and card browser deferred

Not yet specified

• Mobile responsiveness — Should the app work on mobile browsers? PWA?
• Offline support — Is this a local-only app or does it need syncing?
• Progress export/import — Should users be able to backup/restore their progress?
• Notifications/reminders — Should the app nudge users to review?

Out of scope

• Multi-user / social features — No sharing, leaderboards, or collaborative decks
• User-generated content — Cards are curated by the app, not created by users
• Native mobile app — Web only
• AI-generated content — Content is manually curated for quality

## Destination A small, single-user web app that delivers French "culture générale" content via spaced repetition flashcards — curated facts and Q&A, not user-generated content. Go backend with a simple web UI. ## Notes • Stack: Go (per .oc-forge.yaml) • This is a planning effort — produce decisions, not deliverables • One ticket per decision, sized for one 100K token agent session • The user speaks French but engineering work is in English ## Decisions so far - [Content model](https://git.zonline.ovh/gaetan/knowledgify/issues/2) — Q&A + Vrai/Faux cards, 7 categories (4 at launch), freeform tags, one JSON file per category, numeric IDs, optional explanation field - [User model](https://git.zonline.ovh/gaetan/knowledgify/issues/6) — No auth, SQLite for progress, SM-2 fields (next_review, interval, ease_factor, repetitions, last_review), no decks - [Content source](https://git.zonline.ovh/gaetan/knowledgify/issues/7) — Manually authored JSON, 100-200 cards at launch, direct JSON editing, French-only, JSON→DB sync on startup - [Tech stack](https://git.zonline.ovh/gaetan/knowledgify/issues/9) — net/http (stdlib) backend, Go templates + Alpine.js frontend, no build step - [Data storage](https://git.zonline.ovh/gaetan/knowledgify/issues/10) — Cards in DB (upserted from JSON), hash-based sync, modernc.org/sqlite, KNOWLEDGIFY_DB env var - [SRS algorithm](https://git.zonline.ovh/gaetan/knowledgify/issues/8) — SM-2, 4 buttons (Again/Hard/Good/Easy) + keyboard shortcuts (1-4), max 10 new cards/day, interval cap 30 days - [Card review UI](https://git.zonline.ovh/gaetan/knowledgify/issues/11) — Anki-style (space+1-4), minimal card with category badge + progress, Vrai/Faux no reveal step, post-session summary - [Dashboard and stats](https://git.zonline.ovh/gaetan/knowledgify/issues/12) — Dashboard home + category overview at launch, stats page and card browser deferred ## Not yet specified • **Mobile responsiveness** — Should the app work on mobile browsers? PWA? • **Offline support** — Is this a local-only app or does it need syncing? • **Progress export/import** — Should users be able to backup/restore their progress? • **Notifications/reminders** — Should the app nudge users to review? ## Out of scope • **Multi-user / social features** — No sharing, leaderboards, or collaborative decks • **User-generated content** — Cards are curated by the app, not created by users • **Native mobile app** — Web only • **AI-generated content** — Content is manually curated for quality

gaetan added the

wayfinder:map

label

2026-08-20 13:58:18 +02:00

gaetan referenced this issue

2026-08-20 13:58:35 +02:00

Decision: Content model — structure of culture générale cards and categories #2

gaetan referenced this issue

2026-08-20 13:58:51 +02:00

Decision: Spaced repetition algorithm — SM-2, FSRS, or custom? #3

gaetan referenced this issue

2026-08-20 13:59:03 +02:00