mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-15 21:39:39 +02:00
f2ac3e245e
Add new @manacore/shared-splitscreen package enabling iFrame-based
split-screen functionality across Calendar, Todo, and Contacts apps.
Features:
- SplitPaneContainer with CSS Grid layout
- AppPanel with iFrame sandbox permissions and loading/error states
- ResizeHandle with mouse, touch, and keyboard support (20-80% range)
- PanelControls for swap and close actions
- Svelte 5 runes-based store with Context API
- URL persistence (?panel=todo&split=60)
- localStorage persistence with versioning
- Mobile auto-disable (<1024px breakpoint)
Integration:
- PillNavigation: added onOpenInPanel prop and Ctrl/Cmd+click support
- PillDropdown: added split button per app item
- Calendar, Todo, Contacts layouts wrapped with SplitPaneContainer
Also fixes:
- WeekView.svelte: fixed {@const} placement error
- MultiDayView.svelte: fixed {@const} placement error
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
92 lines
3.3 KiB
Markdown
92 lines
3.3 KiB
Markdown
# Central Services
|
|
|
|
Dieses Verzeichnis dokumentiert zentrale Services, die von allen Manacore-Apps gemeinsam genutzt werden. Diese Services laufen in `mana-core-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-core-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-core-auth erstellt werden:
|
|
|
|
```
|
|
Todo-DB mana-core-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 | `@manacore/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-core-auth
|
|
pnpm db:push
|
|
```
|
|
|
|
## Shared Packages
|
|
|
|
| Package | Beschreibung |
|
|
|---------|--------------|
|
|
| `@manacore/shared-tags` | Tags Client für zentrale Tags API |
|
|
| `@manacore/shared-theme` | Theme Store, A11y Store, User Settings |
|
|
| `@manacore/shared-theme-ui` | Svelte UI-Komponenten für Theming |
|
|
| `@manacore/shared-help-types` | TypeScript-Typen für Help-Inhalte |
|
|
| `@manacore/shared-help-content` | Content-Loader, Parser, Merger, Suche |
|
|
| `@manacore/shared-help-ui` | Svelte UI-Komponenten für Hilfeseite |
|
|
| `@manacore/shared-help-mobile` | React Native Komponenten für Hilfe |
|
|
| `@manacore/shared-splitscreen` | Split-Screen Container, Store, Komponenten |
|
|
|
|
## Hinzufügen neuer zentraler Services
|
|
|
|
1. **Schema erstellen:** `services/mana-core-auth/src/db/schema/<name>.schema.ts`
|
|
2. **Module erstellen:** `services/mana-core-auth/src/<name>/`
|
|
3. **In app.module.ts registrieren**
|
|
4. **Shared Package erstellen:** `packages/shared-<name>/`
|
|
5. **Dokumentation schreiben:** `docs/central-services/<NAME>.md`
|