mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-14 22:21:10 +02:00
22a73943e1
Final cleanup of references missed in previous rename commits: - Dockerfiles: PUBLIC_MANA_CORE_AUTH_URL → PUBLIC_MANA_AUTH_URL - Go modules: github.com/manacore/* → github.com/mana/* (7 go.mod files) - launchd plists: com.manacore.* → com.mana.* (14 files renamed + content) - Image assets: *_Manacore_AI_Credits* → *_Mana_AI_Credits* (11 files) - .env.example files: ManaCore brand strings → Mana - .prettierignore: stale apps/manacore/* paths → apps/mana/* - Markdown docs (CLAUDE.md, /docs/*): mana-core-auth → mana-auth, etc. Excluded from rename: .claude/, devlog/, manascore/ (historical content), client testimonials, blueprints, npm package refs (@mana-core/*). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
92 lines
3.2 KiB
Markdown
92 lines
3.2 KiB
Markdown
# Central Services
|
|
|
|
Dieses Verzeichnis dokumentiert zentrale Services, die von allen Mana-Apps gemeinsam genutzt werden. Diese Services laufen in `mana-auth` und bieten einheitliche APIs.
|
|
|
|
## Übersicht
|
|
|
|
| Service | Beschreibung | Dokumentation |
|
|
|---------|--------------|---------------|
|
|
| **Tags** | Einheitliche Tags/Labels für Todo, Calendar, Contacts | [TAGS.md](./TAGS.md) |
|
|
| **Theming** | Theme-Varianten, Dark Mode, Accessibility, Custom Themes | [THEMING.md](./THEMING.md) |
|
|
| **Help** | Zentrale Hilfeseite mit FAQ, Features, Shortcuts, Changelog | [HELP.md](./HELP.md) |
|
|
| **Command Bar** | Globale Schnellsuche und Navigation (Cmd/Ctrl+K) | [COMMAND-BAR.md](./COMMAND-BAR.md) |
|
|
| **Split-Screen** | Zwei Apps nebeneinander im Browser (iFrame-basiert) | [SPLIT-SCREEN.md](./SPLIT-SCREEN.md) |
|
|
|
|
## Architektur-Prinzipien
|
|
|
|
### Zentralisierung
|
|
|
|
Bestimmte Daten und Funktionen werden zentral in `mana-auth` verwaltet:
|
|
|
|
- **User-bezogen:** Jeder Service speichert Daten pro User (`userId`)
|
|
- **App-übergreifend:** Daten sind in allen Apps verfügbar
|
|
- **API-basiert:** Zugriff erfolgt über REST-APIs
|
|
|
|
### Soft References
|
|
|
|
Da die Apps ihre eigenen Datenbanken haben, können keine Foreign Keys zu mana-auth erstellt werden:
|
|
|
|
```
|
|
Todo-DB mana-auth-DB
|
|
┌─────────────────┐ ┌─────────────────┐
|
|
│ task_to_tags │ │ tags │
|
|
│ │ │ │
|
|
│ tag_id ─ ─ ─ ─ ─│─ ─ ─ ─ ▶│ id │
|
|
│ (keine FK) │ │ │
|
|
└─────────────────┘ └─────────────────┘
|
|
```
|
|
|
|
**Konsequenz:** Apps müssen ungültige IDs beim Laden ignorieren.
|
|
|
|
### Shared Packages
|
|
|
|
Für jeden zentralen Service gibt es ein entsprechendes Client-Package:
|
|
|
|
| Service | Package |
|
|
|---------|---------|
|
|
| Tags | `@mana/shared-tags` |
|
|
|
|
Diese Packages enthalten:
|
|
- TypeScript Types
|
|
- API Client Klasse
|
|
- Helper-Funktionen
|
|
|
|
## Lokale Entwicklung
|
|
|
|
### Alle zentralen Services starten
|
|
|
|
```bash
|
|
# Infrastruktur
|
|
pnpm docker:up
|
|
|
|
# Auth-Service (enthält alle zentralen APIs)
|
|
pnpm dev:auth
|
|
```
|
|
|
|
### Datenbank-Schema pushen
|
|
|
|
```bash
|
|
cd services/mana-auth
|
|
pnpm db:push
|
|
```
|
|
|
|
## Shared Packages
|
|
|
|
| Package | Beschreibung |
|
|
|---------|--------------|
|
|
| `@mana/shared-tags` | Tags Client für zentrale Tags API |
|
|
| `@mana/shared-theme` | Theme Store, A11y Store, User Settings |
|
|
| `@mana/shared-theme-ui` | Svelte UI-Komponenten für Theming |
|
|
| `@mana/shared-help-types` | TypeScript-Typen für Help-Inhalte |
|
|
| `@mana/shared-help-content` | Content-Loader, Parser, Merger, Suche |
|
|
| `@mana/shared-help-ui` | Svelte UI-Komponenten für Hilfeseite |
|
|
| `@mana/shared-help-mobile` | React Native Komponenten für Hilfe |
|
|
| `@mana/shared-splitscreen` | Split-Screen Container, Store, Komponenten |
|
|
|
|
## Hinzufügen neuer zentraler Services
|
|
|
|
1. **Schema erstellen:** `services/mana-auth/src/db/schema/<name>.schema.ts`
|
|
2. **Module erstellen:** `services/mana-auth/src/<name>/`
|
|
3. **In app.module.ts registrieren**
|
|
4. **Shared Package erstellen:** `packages/shared-<name>/`
|
|
5. **Dokumentation schreiben:** `docs/central-services/<NAME>.md`
|