mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-14 20:21:09 +02:00
docs: add firsts module design document
Design spec for the "Erste Male / First Times" module — combining bucket-list dreams, social/people tracking, and rich-media experience journaling with expectation-vs-reality as the emotional core. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Till JS
parent
5c2ea614cd
commit
e943ac9d94
1 changed files with 252 additions and 0 deletions
252
docs/future/FIRSTS_MODULE.md
Normal file
252
docs/future/FIRSTS_MODULE.md
Normal file
|
|
@ -0,0 +1,252 @@
|
|||
# Mana — Firsts Module Design
|
||||
|
||||
Konzept fuer ein **"Erste Male / First Times"**-Modul. Kombiniert Bucket-List
|
||||
(traeumen + planen), soziale Personen-Verknuepfung und Rich-Media
|
||||
Erlebnis-Tagebuch.
|
||||
|
||||
Modul-ID: `firsts`
|
||||
Route: `(app)/firsts/`
|
||||
Kategorie: Mind & Reflection / Playful
|
||||
|
||||
---
|
||||
|
||||
## Kernidee
|
||||
|
||||
Ein persoenliches Archiv aller "ersten Male". Jeder Eintrag hat zwei
|
||||
Lebensphasen:
|
||||
|
||||
- **Dream** — ein erstes Mal, das man noch erleben will
|
||||
- **Lived** — ein erlebtes erstes Mal, dokumentiert mit Fotos, Orten, Personen
|
||||
|
||||
Der Uebergang von Dream zu Lived ist der zentrale Moment im Modul.
|
||||
|
||||
---
|
||||
|
||||
## Datenmodell
|
||||
|
||||
```ts
|
||||
interface LocalFirst {
|
||||
id: string
|
||||
userId: string
|
||||
createdAt: string
|
||||
updatedAt: string
|
||||
|
||||
// Kern
|
||||
title: string // "Erstes Mal Surfen"
|
||||
status: 'dream' | 'lived'
|
||||
category: FirstCategory
|
||||
|
||||
// Dream-Phase
|
||||
motivation?: string // "Warum will ich das erleben?"
|
||||
priority?: 1 | 2 | 3 // 1 = irgendwann, 2 = dieses Jahr, 3 = so bald wie moeglich
|
||||
|
||||
// Lived-Phase
|
||||
date?: string // wann es passiert ist
|
||||
note?: string // Freitext-Erfahrungsbericht
|
||||
expectation?: string // "Ich dachte es wird..."
|
||||
reality?: string // "Es war tatsaechlich..."
|
||||
rating?: number // 1-5
|
||||
wouldRepeat?: 'yes' | 'no' | 'definitely'
|
||||
|
||||
// Social
|
||||
personIds?: string[] // Verknuepfung zu contacts
|
||||
sharedWith?: string // Freitext-Fallback wenn kein Kontakt existiert
|
||||
|
||||
// Rich Media
|
||||
mediaIds?: string[] // Fotos, Videos (via uload)
|
||||
audioNoteId?: string // Sprachnotiz
|
||||
placeId?: string // Verknuepfung zu places
|
||||
|
||||
// Meta
|
||||
isArchived?: boolean
|
||||
isPinned?: boolean
|
||||
}
|
||||
|
||||
type FirstCategory =
|
||||
| 'culinary'
|
||||
| 'adventure'
|
||||
| 'travel'
|
||||
| 'people'
|
||||
| 'career'
|
||||
| 'creative'
|
||||
| 'nature'
|
||||
| 'culture'
|
||||
| 'health'
|
||||
| 'tech'
|
||||
| 'other'
|
||||
```
|
||||
|
||||
### Encryption
|
||||
|
||||
Sensitive Felder (encrypt): `title`, `motivation`, `note`, `expectation`,
|
||||
`reality`, `sharedWith`.
|
||||
|
||||
Plaintext (fuer Indexierung): `id`, `userId`, `status`, `category`, `priority`,
|
||||
`date`, `rating`, `wouldRepeat`, `personIds`, `mediaIds`, `placeId`,
|
||||
`isArchived`, `isPinned`, `createdAt`, `updatedAt`.
|
||||
|
||||
---
|
||||
|
||||
## UI-Konzept
|
||||
|
||||
### Drei Ansichten
|
||||
|
||||
#### 1. Timeline (Hauptansicht)
|
||||
|
||||
Vertikaler Stream, neueste oben. Erlebte Firsts als reichhaltige Karten:
|
||||
|
||||
```
|
||||
+-------------------------------------+
|
||||
| Erstes Mal Surfen **** |
|
||||
| 12. Maerz 2026 . Fuerteventura |
|
||||
| |
|
||||
| +-----+ +-----+ +-----+ |
|
||||
| | Foto| | Foto| | Foto| +2 |
|
||||
| +-----+ +-----+ +-----+ |
|
||||
| |
|
||||
| "Ich dachte ich stehe sofort -- |
|
||||
| in Wahrheit lag ich 2h im Wasser" |
|
||||
| |
|
||||
| Lisa Tom |
|
||||
| Corralejo Beach |
|
||||
| Definitely again |
|
||||
+-------------------------------------+
|
||||
```
|
||||
|
||||
Dazwischen eingestreut: Dream-Karten (visuell abgesetzt, gestrichelter Rand):
|
||||
|
||||
```
|
||||
+ - - - - - - - - - - - - - - - - - -+
|
||||
Fallschirmspringen
|
||||
Prioritaet: Dieses Jahr
|
||||
"Will wissen wie sich freier
|
||||
Fall anfuehlt"
|
||||
[ Erlebt ]
|
||||
+ - - - - - - - - - - - - - - - - - -+
|
||||
```
|
||||
|
||||
Der "Erlebt"-Button oeffnet das Erfassungs-Sheet und konvertiert den Dream zum
|
||||
Lived-Eintrag.
|
||||
|
||||
#### 2. Dreams (Bucket List)
|
||||
|
||||
Gefilterte Ansicht nur der offenen Wuensche. Gruppiert nach Prioritaet:
|
||||
|
||||
```
|
||||
SO BALD WIE MOEGLICH
|
||||
Nordlichter sehen mit Anna
|
||||
Fallschirmspringen
|
||||
|
||||
DIESES JAHR
|
||||
Kuchen von Grund auf backen
|
||||
Open Mic Night besuchen
|
||||
|
||||
IRGENDWANN
|
||||
Japan bereisen
|
||||
Marathon laufen mit Tom
|
||||
```
|
||||
|
||||
#### 3. People (Personen-Ansicht)
|
||||
|
||||
Gruppierung nach Personen — zeigt die gemeinsame Geschichte:
|
||||
|
||||
```
|
||||
LISA (7 gemeinsame Firsts)
|
||||
Surfen . Mrz 2026
|
||||
Sushi essen . Jan 2026
|
||||
Skifahren . Dez 2025
|
||||
Klettern (Dream)
|
||||
|
||||
TOM (3 gemeinsame Firsts)
|
||||
Surfen . Mrz 2026
|
||||
Konzert besuchen . Feb 2026
|
||||
Fallschirmspringen (Dream)
|
||||
|
||||
ALLEINE (4 Firsts)
|
||||
Buch an einem Tag gelesen
|
||||
10km gelaufen
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Erfassungs-Flow
|
||||
|
||||
### Schnell-Erfassung (Dream anlegen)
|
||||
|
||||
Titel + Kategorie + optional Personen. Zwei Taps, fertig.
|
||||
|
||||
### Dream -> Lived Conversion
|
||||
|
||||
Wenn man auf "Erlebt" tippt, oeffnet sich ein Sheet:
|
||||
|
||||
1. **Wann?** — Datum-Picker
|
||||
2. **Wo?** — Ort suchen / Places-Integration
|
||||
3. **Mit wem?** — Kontakte waehlen oder Freitext
|
||||
4. **Festhalten** — Fotos / Video / Sprachnotiz
|
||||
5. **Erzaehl mal**
|
||||
- Vorher: "Ich dachte..."
|
||||
- Nachher: "Es war tatsaechlich..."
|
||||
6. **Bewertung** — 1-5 Sterne
|
||||
- Nochmal? — Nein / Ja / Definitiv
|
||||
|
||||
Alles optional ausser Datum. Man kann auch einfach nur "12. Maerz, war super"
|
||||
eintragen.
|
||||
|
||||
### Direkt-Erfassung
|
||||
|
||||
Neues First ohne vorherigen Dream — gleicher Flow, ueberspringt Dream-Phase.
|
||||
|
||||
---
|
||||
|
||||
## Expectation vs. Reality — das Herzstueck
|
||||
|
||||
Das Vorher/Nachher-Feature ist das emotionale Zentrum. Beispiele:
|
||||
|
||||
> **Erstes Mal Karaoke**
|
||||
> Vorher: "Ich werde mich zu Tode blamieren"
|
||||
> Nachher: "Alle waren genauso schlecht, es war grossartig"
|
||||
> Nochmal? Definitiv
|
||||
|
||||
> **Erstes Mal alleine verreist**
|
||||
> Vorher: "Wird bestimmt einsam"
|
||||
> Nachher: "Hab mehr Leute kennengelernt als auf jeder Gruppenreise"
|
||||
> Nochmal? Ja
|
||||
|
||||
Das ist auch das, was beim Zurueckblaettern am meisten Spass macht.
|
||||
|
||||
---
|
||||
|
||||
## Integration mit bestehenden Modulen
|
||||
|
||||
| Integration | Modul | Wie |
|
||||
|-------------|------------|-----------------------------------------------------------|
|
||||
| Personen | `contacts` | `personIds[]` referenziert Contact-IDs, Picker in der UI |
|
||||
| Orte | `places` | `placeId` referenziert Place-ID, Kartenansicht optional |
|
||||
| Medien | `uload` | Fotos/Videos ueber bestehenden Upload-Flow, `mediaIds[]` |
|
||||
| Audio | `uload` | Sprachnotiz als Blob ueber Media-Service |
|
||||
|
||||
---
|
||||
|
||||
## Optionale Erweiterungen (spaeter)
|
||||
|
||||
- **Jahresrueckblick** — "2026: 23 Erste Male, Lieblingskategorie: Kulinarisch,
|
||||
meiste Firsts mit: Lisa"
|
||||
- **Erinnerungen** — "Du wolltest dieses Jahr noch Fallschirmspringen — noch 3
|
||||
Monate!"
|
||||
- **Teilen** — einzelnes First als huebsche Karte exportieren (Bild)
|
||||
- **Zufalls-Inspiration** — kuratierte Vorschlaege fuer Firsts die man ausprobieren
|
||||
koennte
|
||||
- **Statistiken** — Firsts pro Monat, aktivste Kategorie, laengste Streak
|
||||
|
||||
---
|
||||
|
||||
## Scaffolding (Standard-Modul-Pattern)
|
||||
|
||||
1. `apps/mana/apps/web/src/lib/modules/firsts/module.config.ts` — appId `firsts`, table `firsts`
|
||||
2. `apps/mana/apps/web/src/lib/modules/firsts/collections.ts` — Dexie table ref
|
||||
3. `apps/mana/apps/web/src/lib/modules/firsts/types.ts` — `LocalFirst`, `FirstCategory`
|
||||
4. `apps/mana/apps/web/src/lib/modules/firsts/queries.ts` — `useAllFirsts()`, `useFirstsByPerson()`, `useDreams()`
|
||||
5. `apps/mana/apps/web/src/lib/modules/firsts/stores/firsts.svelte.ts` — CRUD + dream-to-lived conversion
|
||||
6. `apps/mana/apps/web/src/lib/modules/firsts/index.ts` — barrel exports
|
||||
7. Route: `apps/mana/apps/web/src/routes/(app)/firsts/`
|
||||
8. Register in `module-registry.ts`, `database.ts` (schema bump), `crypto/registry.ts`, `mana-apps.ts`
|
||||
Loading…
Add table
Add a link
Reference in a new issue