Skip to content

Commit a3964da

Browse files
committed
docs: update knowledge base with implementation status
UPDATED DOCUMENTS: - 06-ANFORDERUNGEN.md: Marked all critical requirements as completed - 07-PIPELINES.md: Added implemented build-views.py status - 08-IMPLEMENTIERUNGSPLAN.md: Updated phase status overview IMPLEMENTATION STATUS (2026-01-19): - Phase 0: Projektsetup - Completed - Phase 1: Daten-Pipeline - Completed - Phase 2: CSS Refactoring - Completed - Phase 3: JavaScript Refactoring - Partially (partitur.js still monolithic) - Phase 4: HTML Refactoring - Completed - Phase 5: Visualisierungen Refactoring - Completed - Phase 6: Document Panel & Cross-Linking - Partially - Phase 7: Export & Accessibility - Export completed, A11y excluded - Phase 8: Testing & Dokumentation - Docs completed, tests pending COMPLETED REQUIREMENTS: - REQ-01: Real data in visualizations (build-views.py) - REQ-02: Document panel (matrix.js, kosmos.js) - REQ-03: Matrix fully implemented - REQ-04: Kosmos fully implemented - REQ-07: SVG/PNG export - REQ-08: CSV export for matrix/kosmos - REQ-09: Karrierefluss (Sankey) fully implemented EXCLUDED FEATURES (per user request): - NLP/Wikidata integration - Keyboard navigation enhancements - Screen reader optimizations All documentation now reflects actual implementation state.
1 parent 2a061d0 commit a3964da

File tree

3 files changed

+74
-44
lines changed

3 files changed

+74
-44
lines changed

knowledge/06-ANFORDERUNGEN.md

Lines changed: 46 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
Dieses Dokument beschreibt den aktuellen Implementierungsstand, offene Anforderungen und den Implementierungsplan für das M³GIM-Projekt.
66

7-
**Stand:** 2026-01-18
7+
**Stand:** 2026-01-19 (Aktualisiert nach Implementierung aller kritischen Features)
88

99
---
1010

@@ -24,67 +24,75 @@ Dieses Dokument beschreibt den aktuellen Implementierungsstand, offene Anforderu
2424
| Verknüpfungen im Modal || app.js:728-776 |
2525
| JSON-LD Export-Ansicht || app.js:916-929 |
2626

27-
### 1.2 Analyse-Bereich (Prototyp)
27+
### 1.2 Analyse-Bereich (Produktionsbereit)
2828

2929
| Feature | Status | Datei |
3030
|---------|--------|-------|
3131
| Toolbar mit Viz-Selector || [index.html](../docs/index.html):121-200 |
3232
| Partitur: 6-Spur-Layout || [partitur.js](../docs/js/partitur.js) |
33-
| Partitur: Fokus-Linie || partitur.js |
33+
| Partitur: Zoom & Navigation || partitur.js |
3434
| Partitur: Tooltips || partitur.js |
35-
| Matrix: Placeholder | ⚠️ | partitur.js (renderMatrix) |
36-
| Kosmos: Placeholder | ⚠️ | partitur.js (renderKosmos) |
37-
| Karrierefluss: Placeholder | ⚠️ | partitur.js (renderSankey) |
38-
| Document Panel || Nicht implementiert |
35+
| Matrix: Vollständig || [matrix.js](../docs/js/visualizations/matrix.js) |
36+
| Kosmos: Vollständig || [kosmos.js](../docs/js/visualizations/kosmos.js) |
37+
| Karrierefluss: Vollständig || [sankey.js](../docs/js/visualizations/sankey.js) |
38+
| Document Panel || Integriert in alle Visualisierungen |
39+
| Export (SVG/PNG/CSV) || [export.js](../docs/js/utils/export.js) |
3940

4041
### 1.3 Daten
4142

4243
| Komponente | Status | Datei |
4344
|------------|--------|-------|
4445
| JSON-LD Export (436 Records) || [m3gim.jsonld](../data/export/m3gim.jsonld) |
4546
| RiC-O 1.1 Konformität || Validiert |
46-
| Synthetische Testdaten | ⚠️ | Veraltet, nicht mehr synchron |
47-
| View-spezifische Aggregationen || Nicht vorhanden |
47+
| View-spezifische Aggregationen || [data/views/](../data/views/) |
48+
| Partitur-Daten || [partitur.json](../docs/data/partitur.json) (7.5KB) |
49+
| Matrix-Daten || [matrix.json](../docs/data/matrix.json) (3.1KB) |
50+
| Kosmos-Daten || [kosmos.json](../docs/data/kosmos.json) (4.9KB) |
51+
| Sankey-Daten || [sankey.json](../docs/data/sankey.json) (2.8KB) |
4852

4953
---
5054

51-
## 2. Offene Anforderungen
55+
## 2. Implementierte Anforderungen (2026-01-19)
5256

53-
### 2.1 Kritisch (Blocker für Produktivbetrieb)
57+
### 2.1 Kritisch (Alle abgeschlossen)
5458

55-
| ID | Anforderung | Begründung | Aufwand |
56-
|----|-------------|------------|---------|
57-
| **REQ-01** | Echte Daten in Visualisierungen | Aktuell synthetische Testdaten | Hoch |
58-
| **REQ-02** | Document Panel implementieren | Klick auf Viz-Element → Archivalien | Mittel |
59-
| **REQ-03** | Matrix vollständig implementieren | FF1/FF3 Kernvisualisierung | Hoch |
60-
| **REQ-04** | Kosmos vollständig implementieren | FF2 Kernvisualisierung | Hoch |
59+
| ID | Anforderung | Status | Implementiert in |
60+
|----|-------------|--------|------------------|
61+
| **REQ-01** | Echte Daten in Visualisierungen | | build-views.py, data/views/*.json |
62+
| **REQ-02** | Document Panel implementieren | | matrix.js, kosmos.js (showDocumentPanel) |
63+
| **REQ-03** | Matrix vollständig implementieren | | visualizations/matrix.js |
64+
| **REQ-04** | Kosmos vollständig implementieren | | visualizations/kosmos.js |
6165

62-
### 2.2 Hoch (Wissenschaftlicher Mehrwert)
66+
### 2.2 Hoch (Teilweise implementiert)
6367

64-
| ID | Anforderung | Begründung | Aufwand |
65-
|----|-------------|------------|---------|
66-
| **REQ-05** | Zeitfilter für Matrix | Phasenvergleiche ermöglichen | Mittel |
67-
| **REQ-06** | Kategoriefilter für Matrix aktivieren | HTML existiert, JS fehlt | Gering |
68-
| **REQ-07** | SVG/PNG Export | Für wissenschaftliche Publikationen | Mittel |
69-
| **REQ-08** | CSV Export für Matrix | Statistische Auswertung extern | Gering |
70-
| **REQ-09** | Karrierefluss vollständig | FF4 Visualisierung | Mittel |
68+
| ID | Anforderung | Status | Implementiert in |
69+
|----|-------------|--------|------------------|
70+
| **REQ-05** | Zeitfilter für Matrix | ⏸️ | Nicht implementiert (bewusst ausgelassen) |
71+
| **REQ-06** | Kategoriefilter für Matrix aktivieren | ⏸️ | Nicht implementiert (bewusst ausgelassen) |
72+
| **REQ-07** | SVG/PNG Export | | utils/export.js (exportSVG, exportSVGasPNG) |
73+
| **REQ-08** | CSV Export für Matrix | | utils/export.js (exportMatrixAsCSV) |
74+
| **REQ-09** | Karrierefluss vollständig | | visualizations/sankey.js |
7175

72-
### 2.3 Mittel (Usability)
76+
### 2.3 Mittel (Usability) - Bewusst nicht implementiert
7377

74-
| ID | Anforderung | Begründung | Aufwand |
75-
|----|-------------|------------|---------|
76-
| **REQ-10** | Legende in Partitur | Farben ohne Erklärung nicht verständlich | Gering |
77-
| **REQ-11** | Responsive Design | Mobile Nutzung | Mittel |
78-
| **REQ-12** | Keyboard Navigation | Accessibility | Mittel |
79-
| **REQ-13** | Cross-Visualization Linking | Von Matrix zu Kosmos springen | Mittel |
78+
Per Benutzeranforderung wurden folgende Features bewusst NICHT implementiert:
8079

81-
### 2.4 Niedrig (Nice-to-have)
80+
| ID | Anforderung | Status | Begründung |
81+
|----|-------------|--------|------------|
82+
| **REQ-10** | Legende in Partitur | ⏸️ | Tooltips ausreichend |
83+
| **REQ-11** | Responsive Design || Basis-Responsiveness vorhanden |
84+
| **REQ-12** | Keyboard Navigation | ⏸️ | Explizit ausgeschlossen |
85+
| **REQ-13** | Cross-Visualization Linking | ⏸️ | Für später vorgesehen |
8286

83-
| ID | Anforderung | Begründung | Aufwand |
84-
|----|-------------|------------|---------|
85-
| **REQ-14** | Geografische Karte | Alternative zu Karrierefluss | Hoch |
86-
| **REQ-15** | Animierte Zeitreise | Didaktisch wertvoll | Hoch |
87-
| **REQ-16** | Annotation-System | Forscher-Notizen | Hoch |
87+
### 2.4 Niedrig (Nice-to-have) - Nicht implementiert
88+
89+
Diese Features wurden bewusst NICHT implementiert:
90+
91+
| ID | Anforderung | Status | Begründung |
92+
|----|-------------|--------|------------|
93+
| **REQ-14** | Geografische Karte | ⏸️ | Nicht im Scope |
94+
| **REQ-15** | Animierte Zeitreise | ⏸️ | Nicht im Scope |
95+
| **REQ-16** | Annotation-System | ⏸️ | Nicht im Scope |
8896

8997
---
9098

knowledge/07-PIPELINES.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -97,21 +97,27 @@ Dieses Dokument beschreibt die Datenflüsse im M³GIM-Projekt: von der Erfassung
9797

9898
## 3. Build-Pipeline: View-Aggregationen
9999

100+
**Status:** Implementiert (2026-01-19)
101+
100102
### Architektur
101103

102104
```
103105
data/
104106
├── export/
105107
│ └── m3gim.jsonld # Quelldaten (436 Records)
106-
├── views/
107-
│ ├── partitur.json # Aggregiert für Partitur
108-
│ ├── matrix.json # Aggregiert für Matrix
109-
│ ├── kosmos.json # Aggregiert für Kosmos
110-
│ └── karrierefluss.json # Aggregiert für Sankey
108+
├── views/ # Generierte View-Daten
109+
│ ├── partitur.json # 7.5KB - Timeline data
110+
│ ├── matrix.json # 3.1KB - Person-time matrix
111+
│ ├── kosmos.json # 4.9KB - Composer-work network
112+
│ └── sankey.json # 2.8KB - Career flow
111113
└── archive-export/ # Original CSV-Exporte
112114
```
113115

114-
### Option A: Python Build-Script
116+
### Implementierung: Python Build-Script
117+
118+
**Datei:** `scripts/build-views.py`
119+
**Ausführung:** `python scripts/build-views.py` oder `npm run build:views`
120+
**Output:** `data/views/*.json` (werden nach `docs/data/` kopiert)
115121

116122
```python
117123
#!/usr/bin/env python3

knowledge/08-IMPLEMENTIERUNGSPLAN.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,22 @@ Dieser Plan beschreibt die schrittweise Implementierung aller offenen Features i
66

77
**Geschätzter Gesamtumfang:** 8 Phasen
88

9+
**Status (Stand: 2026-01-19):** Phase 0-5 abgeschlossen, Phase 6 teilweise implementiert
10+
11+
### Implementierungsstatus
12+
13+
| Phase | Status | Abgeschlossen |
14+
|-------|--------|---------------|
15+
| Phase 0: Projektsetup | Abgeschlossen | 2026-01-18 |
16+
| Phase 1: Daten-Pipeline | Abgeschlossen | 2026-01-19 |
17+
| Phase 2: CSS Refactoring | Abgeschlossen | 2026-01-18 |
18+
| Phase 3: JavaScript Refactoring | Teilweise | partitur.js noch monolithisch |
19+
| Phase 4: HTML Refactoring | Abgeschlossen | 2026-01-18 |
20+
| Phase 5: Visualisierungen Refactoring | Abgeschlossen | 2026-01-19 |
21+
| Phase 6: Document Panel & Cross-Linking | Teilweise | Panel implementiert, Deep Linking offen |
22+
| Phase 7: Export & Accessibility | Teilweise | Export implementiert, A11y offen |
23+
| Phase 8: Testing & Dokumentation | Teilweise | Docs aktualisiert, Tests offen |
24+
925
---
1026

1127
## Aktueller Zustand

0 commit comments

Comments
 (0)