318 lines
12 KiB
Markdown
318 lines
12 KiB
Markdown
# bDS Rust Rewrite - Vollständige Spezifikationssammlung
|
|
|
|
Diese Datei dient als Index zu allen Allium-Spezifikationen und Schema-Inventarisierungen für die Rust-Implementierung.
|
|
|
|
## Verfügbare Spezifikationen
|
|
|
|
### Kern-Spezifikationen
|
|
|
|
| Datei | Scope | Status | Beschreibung |
|
|
|-------|-------|--------|--------------|
|
|
| `bds.allium` | Core | ✅ Existiert | Haupt-Spezifikation mit allen Referenzen |
|
|
| `project.allium` | Core (Wave 1) | ✅ Existiert | Projekt-Management |
|
|
| `post.allium` | Core (Wave 1) | ✅ Existiert | Post-Lifecycle, Frontmatter, Dateistruktur |
|
|
| `media.allium` | Core (Wave 1) | ✅ Existiert | Media-Import, Thumbnails, Sidecars |
|
|
| `translation.allium` | Core (Wave 1) | ✅ Existiert | Post- und Media-Übersetzungen |
|
|
| `tag.allium` | Core (Wave 1) | ✅ Existiert | Tags mit Mass-Operationen |
|
|
| `template.allium` | Core (Wave 1/4) | ✅ Existiert | Liquid-Template-Management |
|
|
| `script.allium` | Core (Wave 6) | ✅ Existiert | Skripting (Lua in Rust) |
|
|
| `menu.allium` | Core (Read) | ✅ Existiert | OPML-Navigationsmenü |
|
|
| `metadata.allium` | Core (Wave 1) | ✅ Existiert | Projekt-Konfiguration, Kategorien, Publishing |
|
|
|
|
### Infrastruktur-Spezifikationen
|
|
|
|
| Datei | Scope | Status | Beschreibung |
|
|
|-------|-------|--------|--------------|
|
|
| `search.allium` | Core (Wave 1) | ✅ Existiert | FTS5 Full-Text Search mit Snowball |
|
|
| `generation.allium` | Core (Wave 4) | ✅ Existiert | Statische Site-Generierung |
|
|
| `preview.allium` | Core (Wave 4) | ✅ Existiert | Lokaler Preview-Server |
|
|
| `publishing.allium` | Core (Wave 5) | ✅ Existiert | SSH-Upload (SCP/rsync) |
|
|
| `task.allium` | Core (Wave 1) | ✅ Existiert | Background Task Manager |
|
|
| `i18n.allium` | Core (Alle) | ✅ Existiert | Split Localization (UI vs Content) |
|
|
| `schema.allium` | Core (Wave 1) | ✨ Neu | Vollständiges SQLite-Schema |
|
|
| `frontmatter.allium` | Core (Wave 1) | ✨ Neu | Alle Frontmatter-Formate |
|
|
| `template_context.allium` | Core (Wave 4) | ✨ Neu | Liquid-Template-Kontext |
|
|
| `media_processing.allium` | Core (Wave 1) | ✨ Neu | Thumbnail-Generierung, Bildverarbeitung |
|
|
|
|
### Integration-Spezifikationen
|
|
|
|
| Datei | Scope | Status | Beschreibung |
|
|
|-------|-------|--------|--------------|
|
|
| `git.allium` | Extension A | ✅ Existiert | Git-Operationen, LFS, Reconciliation |
|
|
| `import.allium` | Extension B | ✨ Neu | WordPress-WXR-Analyse, Konfliktprüfung und Importausführung |
|
|
| `mcp.allium` | Extension G | ✅ Existiert | MCP-Server (Tools, Resources) |
|
|
| `ai.allium` | Core/Extension C | ✅ Existiert | AI One-Shot Tasks und Chat |
|
|
| `embedding.allium` | Extension D | ✅ Existiert | Semantic Similarity (HNSW) |
|
|
| `cli_sync.allium` | Core (Wave 5) | ✅ Existiert | CLI-zu-App Notification Sync |
|
|
| `metadata_diff.allium` | Core (Wave 1) | ✅ Existiert | DB/Dateisystem-Diff und Rebuild |
|
|
|
|
### Von bDS2 übernommene Spezifikationen (Sync 2026-07)
|
|
|
|
| Datei | Scope | Status | Beschreibung |
|
|
|-------|-------|--------|--------------|
|
|
| `rendering.allium` | Core | ✨ Neu | Render-Subsystem (Assigns, Filter, Makros für Preview + Generation) |
|
|
| `cli.allium` | Extension G | ✨ Neu | Workspace-CLI-Tool (rebuild, repair, render, upload, …) |
|
|
| `events.allium` | Extension | ✨ Neu | Domain Event Bus (Multi-Client-Synchronisation) |
|
|
| `server.allium` | Extension | ✨ Neu | Headless Server Mode (SSH-Transport für TUI/GUI) |
|
|
| `tui.allium` | Extension | ✨ Neu | Terminal UI (zweiter Renderer über gemeinsamem UI-Core) |
|
|
|
|
## Neuerstellte Spezifikationen (diese Session)
|
|
|
|
### 1. `schema.allium`
|
|
|
|
**Zweck:** Vollständige Inventarisierung des SQLite-Schemas aus dem TypeScript-Projekt.
|
|
|
|
**Inhalt:**
|
|
- 22 Entity-Definitionen mit allen Feldern und Typen
|
|
- Alle Relationship-Tabellen (PostLink, PostMedia)
|
|
- Alle Metadata-Tabellen (Settings, GeneratedFileHashes)
|
|
- FTS5 Virtual Tables für Search (posts_fts, media_fts)
|
|
- AI/Chat-Tabellen (Conversations, Messages, Model Catalog)
|
|
- Embedding-Tabellen (USearch keys, dismissed duplicates)
|
|
- Import-Tabellen (WXR definitions)
|
|
- Notification-Tabellen (CLI-to-App sync)
|
|
- Alle Unique-Constraints und Indexe
|
|
- Migration-History (Version 0001-0010)
|
|
|
|
**Kritische Details:**
|
|
- `posts` Tabelle: 21 Felder inkl. Legacy-Felder
|
|
- `post_translations` Tabelle: 12 Felder
|
|
- `media` Tabelle: 17 Felder
|
|
- `media_translations` Tabelle: 6 Felder
|
|
- `scripts` Tabelle: 13 Felder (Lua in Rust)
|
|
- `templates` Tabelle: 13 Felder
|
|
- FTS5 benötigt Snowball Stemmer für 24 Sprachen
|
|
- Embedding vectors: 384-dimensional Float32 (1536 bytes)
|
|
|
|
### 2. `frontmatter.allium`
|
|
|
|
**Zweck:** Exakte Spezifikation aller YAML-Frontmatter-Formate.
|
|
|
|
**Inhalt:**
|
|
- **Post-Dateiformat:** `posts/{YYYY}/{MM}/{slug}.md`
|
|
- Required fields: id, title, slug, status, createdAt, updatedAt, tags, categories
|
|
- Conditional fields: excerpt, author, language, templateSlug, publishedAt
|
|
- `doNotTranslate` nur wenn true
|
|
|
|
- **Translation-Dateiformat:** `posts/{YYYY}/{MM}/{slug}.{language}.md`
|
|
- Gleiche Struktur wie Posts mit language-Override
|
|
|
|
- **Media-Sidecar-Format:** `media/{id}.md`
|
|
- Required: id, filename, originalName, mimeType, size, createdAt, updatedAt, tags
|
|
- Optional: title, alt, caption, author, language, width, height
|
|
|
|
- **Template-Format:** `templates/{slug}.liquid`
|
|
- Required: id, slug, title, kind, enabled, version, createdAt, updatedAt
|
|
|
|
- **Script-Format:** `scripts/{slug}.lua` (Rust) / `{slug}.py` (TypeScript)
|
|
- Required: id, slug, title, kind, entrypoint, enabled, version, createdAt, updatedAt
|
|
|
|
- **Tags-Dateiformat:** `meta/tags.json`
|
|
- Sortiertes JSON-Array ohne interne IDs
|
|
|
|
- **Projekt-Metadaten:**
|
|
- `meta/project.json` - Projekt-Konfiguration
|
|
- `meta/categories.json` - Kategorie-Liste
|
|
- `meta/category-meta.json` - Render-Einstellungen pro Kategorie
|
|
- `meta/publishing.json` - SSH-Konfiguration
|
|
- `meta/menu.opml` - Navigation im OPML-Format
|
|
|
|
**Format-Konventionen:**
|
|
- Timestamps als Unix-Milliseconds (ISO 8601 in YAML)
|
|
- 2-Space Indentation
|
|
- Arrays als YAML-Liste
|
|
- Booleans als lowercase true/false
|
|
- Atomare Writes (temp file + rename)
|
|
|
|
### 3. `template_context.allium`
|
|
|
|
**Zweck:** Vollständige Spezifikation des an Liquid-Templates übergebenen Datenkontexts.
|
|
|
|
**Inhalt:**
|
|
- **Global Render Context:** 30+ Top-Level-Variablen
|
|
- `language`, `language_prefix`, `html_theme_attribute`
|
|
- `blog_languages` (List<BlogLanguage>)
|
|
- `alternate_links` (hreflang für SEO)
|
|
- `menu_items` (hierarchische Struktur)
|
|
- `post` (PostContext für Single-Post-Pages)
|
|
- `day_blocks` (für Archiv-Seiten)
|
|
- `canonical_post_path_by_slug` (Lookup-Map)
|
|
- `post_data_json_by_id` (Lookup-Map)
|
|
|
|
- **PostContext:** 18 Felder inkl. linked_media, outgoing_links, incoming_links
|
|
|
|
- **MediaContext:** 11 Felder für Media in Templates
|
|
|
|
- **PaginationContext:** 10 Felder für Paginierung
|
|
|
|
- **Liquid-Filters:**
|
|
- Built-in: `default`, `escape`, `url_encode`, `append`
|
|
- Custom: `i18n` (Übersetzungs-Lookup)
|
|
- Custom: `markdown` (Markdown→HTML mit Macro-Expansion)
|
|
|
|
- **Built-in Macros:**
|
|
- `gallery` - Bildergalerie
|
|
- `youtube` - YouTube-Einbettung
|
|
- `vimeo` - Vimeo-Einbettung
|
|
- `photo_archive` - Foto-Archiv-Grid
|
|
- `tag_cloud` - Tag-Cloud mit Größen-Faktoren
|
|
|
|
- **Template-Lookup-Regeln:**
|
|
- Priority: post-specific → tag-specific → category-specific → default
|
|
- Partials via `{% render 'partial' %}`
|
|
|
|
### 4. `media_processing.allium`
|
|
|
|
**Zweck:** Exakte Spezifikation der Media-Verarbeitung (Thumbnails, Format-Konversion, EXIF).
|
|
|
|
**Inhalt:**
|
|
- **Datei-Organisation:**
|
|
- Binär: `media/{timestamp}_{random}.{ext}`
|
|
- Sidecar: `media/{id}.md`
|
|
- Thumbnail: `thumbnails/{id}.webp`
|
|
- Thumbnail-Source: `thumbnails/{id}_source.{ext}`
|
|
|
|
- **Thumbnail-Konfiguration:**
|
|
- Größe: 400x300 (default)
|
|
- Fit: "cover" (crop to fill)
|
|
- Qualität: 80% WEBP
|
|
- Format: WEBP
|
|
|
|
- **Bildverarbeitung:**
|
|
- Input-Formate: JPEG, PNG, GIF, WEBP, TIFF, BMP, HEIC, HEIF
|
|
- EXIF-Orientierung muss berücksichtigt werden
|
|
- EXIF wird aus Thumbnails entfernt (Privacy)
|
|
- Original-Format bleibt erhalten
|
|
|
|
- **Import-Flow:**
|
|
1. Validiere Dateityp
|
|
2. Generiere eindeutigen Dateinamen
|
|
3. Kopiere nach media/
|
|
4. Generiere Thumbnail
|
|
5. Erstelle Sidecar mit Metadaten
|
|
6. Indexiere für Search (FTS5)
|
|
7. Generiere Embedding (wenn aktiviert)
|
|
|
|
- **Media-Übersetzungen:**
|
|
- Dateipfad: `media/{id}/{language}.md`
|
|
- Felder: title, alt, caption pro Sprache
|
|
|
|
- **Validierungs-Regeln:**
|
|
- Fehlende Binary-Dateien
|
|
- Fehlende Sidecar-Dateien
|
|
- Fehlende Thumbnails
|
|
- Korrupte Bilddateien
|
|
- Orphan Media (nicht verlinkt)
|
|
|
|
## Spezifikations-Abdeckungs-Analyse
|
|
|
|
### Vollständig Abgedeckt ✅
|
|
|
|
1. **Database Schema** - `schema.allium` deckt alle 22 Tabellen mit allen Feldern
|
|
2. **File Formats** - `frontmatter.allium` deckt alle Dateitypen und Formate
|
|
3. **Post Lifecycle** - `post.allium` + `translation.allium` vollständig
|
|
4. **Media Processing** - `media.allium` + `media_processing.allium` vollständig
|
|
5. **Template System** - `template.allium` + `template_context.allium` vollständig
|
|
6. **Search** - `search.allium` mit FTS5 und Snowball Stemming
|
|
7. **Generation** - `generation.allium` mit allen Section-Typen
|
|
8. **Publishing** - `publishing.allium` mit SCP und rsync
|
|
9. **AI Integration** - `ai.allium` mit One-Shot Operations
|
|
10. **i18n** - `i18n.allium` mit Split Localization
|
|
|
|
### Spezifikations-Lücken vor dieser Session ❌
|
|
|
|
1. **Schema nicht dokumentiert** - Nur aus TypeScript-Code lesbar
|
|
2. **Frontmatter-Regeln nicht explizit** - Feld-Logik verstreut in Engine-Code
|
|
3. **Template-Kontext unvollständig** - Variable-Liste existierte nicht zentral
|
|
4. **Media-Processing-Regeln implizit** - Thumbnail-Größen, EXIF-Handling nicht spezifiziert
|
|
|
|
### Status nach dieser Session ✅
|
|
|
|
Alle kritischen Lücken geschlossen:
|
|
- ✅ Vollständiges SQLite-Schema inventarisiert
|
|
- ✅ Alle Frontmatter-Formate spezifiziert
|
|
- ✅ Template-Kontext vollständig dokumentiert
|
|
- ✅ Media-Processing-Regeln explizit gemacht
|
|
|
|
## Nächste Schritte für die Implementierung
|
|
|
|
### Wave 0 (Foundation)
|
|
1. Cargo-Workspace aufsetzen (bds-core, bds-editor, bds-ui, bds-cli)
|
|
2. SQLite-Connection mit Diesel (gebündeltes SQLite)
|
|
3. Eingebettete Diesel-Migrationen
|
|
4. bds-editor PoC (ropey + syntect + cosmic-text)
|
|
5. Iced App Shell mit muda-Menüs
|
|
6. Slug-Compatibility-Tests (deunicode vs transliteration)
|
|
|
|
### Wave 1 (Data Layer)
|
|
1. Alle Engines implementieren (Project, Post, Media, Tag, Meta, etc.)
|
|
2. Frontmatter-Parser/Writer für alle Dateitypen
|
|
3. Thumbnail-Generierung mit image-crate
|
|
4. FTS5-Index mit Snowball-Stemming
|
|
5. Metadata-Diff und Rebuild
|
|
6. Round-trip-Tests für alle Entity-Typen
|
|
|
|
### Wave 2 (Native Shell)
|
|
1. Muda-Menü-Bar mit allen Menüs
|
|
2. rfd-Datei-Dialoge
|
|
3. Iced-Message-Routing
|
|
4. macOS Lifecycle-Shim (objc2)
|
|
5. Tab-Management und Workspace-Layout
|
|
|
|
### Wave 3 (Authoring UI)
|
|
1. Post-Editor mit bds-editor
|
|
2. Media-Browser und Editor
|
|
3. Template-Editor
|
|
4. Script-Editor
|
|
5. Settings-View
|
|
6. Tag/Category-Management
|
|
|
|
### Wave 4 (Rendering)
|
|
1. Markdown-Render mit pulldown-cmark
|
|
2. Liquid-Template-Engine (subset)
|
|
3. Built-in Macros (gallery, youtube, vimeo, etc.)
|
|
4. Preview-Server (axum)
|
|
5. Site-Generation mit rayon-Parallelisierung
|
|
6. One-Shot AI Operations (reqwest)
|
|
7. Pagefind-Search-Index
|
|
|
|
### Wave 5 (Publishing)
|
|
1. SSH/SCP Upload mit ssh2-crate
|
|
2. rsync-Integration
|
|
3. Publish-Progress-UI
|
|
4. Validierung vor Publish
|
|
|
|
### Wave 6 (Lua Scripting)
|
|
1. Lua-Runtime mit mlua
|
|
2. Lua-API-Bridge
|
|
3. Script-Execution
|
|
4. Generated API-Documentation
|
|
|
|
## Referenz-Implementierung
|
|
|
|
Für Implementierungsdetails immer referenzieren:
|
|
- **TypeScript-Code:** `/Users/gb/Projects/bDS/src/main/engine/`
|
|
- **Spezifikationen:** `/Users/gb/Projects/RuDS/specs/`
|
|
- **Pläne:** `/Users/gb/Projects/RuDS/RUST_*.md`
|
|
|
|
## Kompatibilitäts-Garantien
|
|
|
|
Die Rust-Implementierung muss garantieren:
|
|
|
|
1. **Datenbank-Kompatibilität** - Alle TypeScript-Daten lesbar
|
|
2. **Datei-Format-Kompatibilität** - Frontmatter byte-genau gleich
|
|
3. **Generierungs-Kompatibilität** - Output-Hashes übereinstimmend (normalisiert)
|
|
4. **Slug-Kompatibilität** - deunicode Output muss transliteration Output entsprechen
|
|
5. **URL-Kompatibilität** - Gleiche Routes und Canonical URLs
|
|
6. **Such-Kompatibilität** - FTS5 mit identischem Stemming
|
|
7. **Template-Kompatibilität** - Identisches Liquid-Subset
|
|
|
|
## Spezifikations-Quellen
|
|
|
|
Alle Spezifikationen wurden extrahiert aus:
|
|
|
|
- TypeScript-Engine-Code: `/Users/gb/Projects/bDS/src/main/engine/*.ts`
|
|
- TypeScript-Schema: `/Users/gb/Projects/bDS/src/main/database/schema.ts`
|
|
- TypeScript-Tests: `/Users/gb/Projects/bDS/tests/engine/*.test.ts`
|
|
- Bestehende Allium-Specs: `/Users/gb/Projects/RuDS/specs/*.allium`
|