Update project status and add detailed roadmap
Updated `PROJECT_STATUS.md` to reflect the current progress, including updates to the project status, phase overview, and milestones. Added a new section summarizing completed milestones (Phases 1-2.5) and detailed progress for Phase 3. Created `STATUS_UPDATE_17_01_2025.md` to document the latest project status, including the availability of the DevExpress Universal License, completed phases, and a step-by-step plan for the next sprint. Highlighted action items such as cleaning up the Application Layer and implementing the `DevExpressPdfProcessor` using TDD. These changes ensure alignment between the roadmap and the actual project status while providing clear next steps for stakeholders.
This commit is contained in:
OlgunR
@@ -1,255 +1,52 @@
|
||||
# DocumentOperator - Projekt Status & Zeitplan
|
||||
# DocumentOperator - Project Status
|
||||
|
||||
> **Letzte Aktualisierung:** 17.01.2025
|
||||
> **Aktueller Status:** Phase 3 - Infrastructure Layer (in Bearbeitung)
|
||||
> **Gesamtfortschritt:** ~28% (2.75 von 11 Phasen abgeschlossen)
|
||||
> **Stand:** 17.01.2025 | **Phase:** 4 (Application Layer - NEXT) | **Fortschritt:** ~30% | **Go-Live:** KW 8 (Ende Februar)
|
||||
|
||||
---
|
||||
|
||||
## ?? Projekt-Übersicht
|
||||
|
||||
**DocumentOperator** ist ein zentralisierter REST API Service für PDF-Dokumenten-Operationen in einer Multi-Tenant DMS-Umgebung.
|
||||
|
||||
### Kern-Features
|
||||
- ? PDF Validierung (Metadaten-Extraktion)
|
||||
- ? Attachment-Extraktion
|
||||
- ? PDF-Konkatenation (asynchron bei großen Dateien)
|
||||
- ? Stempel/Wasserzeichen (tenant-spezifisch)
|
||||
- ? Zertifikat-Einbettung
|
||||
|
||||
### Technologie-Stack
|
||||
- **.NET 8** (ASP.NET Core Minimal APIs)
|
||||
- **Clean Architecture** (pragmatisch, nicht dogmatisch)
|
||||
- **DevExpress PDF Core** (Universal License verfügbar)
|
||||
- **MediatR** (CQRS Pattern)
|
||||
- **EF Core + SQLite** (Tenant-Management)
|
||||
- **Lokale Temp-Ordner** (File Storage mit IFileStorage Abstraction)
|
||||
- **In-Memory Queue** (Async Processing)
|
||||
- **Polly** (Resilience: Retry, Circuit Breaker)
|
||||
- **Redis** (Caching, Rate-Limiting)
|
||||
- **Serilog** (Structured Logging)
|
||||
## ?? Projekt
|
||||
REST API für PDF-Operationen (Validierung, Konkatenation, Stempel, Attachments) - Multi-Tenant DMS
|
||||
**Stack:** .NET 8, DevExpress PDF, MediatR, EF Core + SQLite, Redis, Polly
|
||||
|
||||
---
|
||||
|
||||
## ?? Phasen-Übersicht
|
||||
## ?? Phasen (11 Total, ~25-30 Tage)
|
||||
|
||||
| Phase | Name | Status | Fortschritt | Zeitaufwand |
|
||||
|-------|------|--------|-------------|-------------|
|
||||
| **1** | Foundation | ? Abgeschlossen | 100% | ~2 Tage |
|
||||
| **2** | Domain Layer | ? Abgeschlossen | 100% | ~1 Tag |
|
||||
| **3** | Infrastructure Layer | ?? In Bearbeitung | 75% | ~3-4 Tage |
|
||||
| **4** | Application Layer | ? Ausstehend | 0% | ~2-3 Tage |
|
||||
| **5** | API Layer | ? Ausstehend | 0% | ~2 Tage |
|
||||
| **5.5** | Health Checks & Resilience | ? Ausstehend | 0% | ~1 Tag |
|
||||
| **6** | Weitere Features (synchron) | ? Ausstehend | 0% | ~3-4 Tage |
|
||||
| **6.5** | Async Processing (In-Memory Queue) | ? Ausstehend | 0% | ~2 Tage |
|
||||
| **7** | Swagger & API Docs | ? Ausstehend | 0% | ~1 Tag |
|
||||
| **8** | Multi-Tenancy (DB-based) | ? Ausstehend | 0% | ~3-4 Tage |
|
||||
| **9** | File Storage (Lokale Temp-Ordner) | ? Ausstehend | 0% | ~1 Tag |
|
||||
| **10** | Logging & Monitoring | ? Ausstehend | 0% | ~2 Tage |
|
||||
| **11** | Production Deployment | ? Ausstehend | 0% | ~2-3 Tage |
|
||||
|
||||
**Gesamtaufwand (Schätzung):** ~24-30 Arbeitstage (5-6 Wochen bei 1 Entwickler)
|
||||
| Phase | Name | Status | Deadline |
|
||||
|-------|------|--------|----------|
|
||||
| 1-3 | Foundation + Domain + Infrastructure | ? Fertig | - |
|
||||
| 4 | Application Layer (MediatR) | ?? **AKTUELL** | KW 4 |
|
||||
| 5 | API Layer (REST Endpoint) | ? | KW 4 |
|
||||
| 5.5 | Health Checks + Resilience | ? | KW 4 |
|
||||
| 6 | Weitere Features (4x) | ? | KW 5-6 |
|
||||
| 6.5 | Async Processing (Queue) | ? | KW 6 |
|
||||
| 7 | Swagger & Docs | ? | KW 6 |
|
||||
| 8 | **Multi-Tenancy (DB + Redis)** | ? | **KW 7** |
|
||||
| 9 | File Storage (lokal) | ? | KW 7 |
|
||||
| 10 | Logging & Monitoring | ? | KW 7 |
|
||||
| 11 | Production Deployment | ? | KW 8 |
|
||||
|
||||
---
|
||||
|
||||
## ? Bereits erledigt (Phasen 1-2.5)
|
||||
|
||||
### Phase 1: Foundation ?
|
||||
- [x] Solution-Struktur erstellt (4 Projekte: API, Application, Infrastructure, Domain)
|
||||
- [x] Clean Architecture Dependencies korrekt (Dependency Rule eingehalten)
|
||||
- [x] NuGet Packages installiert (MediatR, FluentValidation, DevExpress, xUnit, Moq, FluentAssertions)
|
||||
- [x] Folder-Struktur nach Vertical Slice Architecture
|
||||
- [x] Serilog Setup (Structured Logging)
|
||||
- [x] appsettings.json Konfiguration
|
||||
|
||||
### Phase 2: Domain Layer ?
|
||||
- [x] Domain Exceptions (4 Stück: DomainException, DomainValidationException, NotFoundException, PdfProcessingException)
|
||||
- [x] Enums (DocumentOperationType, ProcessingStatus)
|
||||
- [x] Value Objects (Base64String, TenantId, PdfMetadata) - selbst-validierend, immutable
|
||||
|
||||
### Phase 3: Infrastructure Layer (75% abgeschlossen) ??
|
||||
- [x] IPdfProcessor Interface (Application/Common/Interfaces/)
|
||||
- [x] Test-Struktur erstellt (Unit/Infrastructure/Services/PdfProcessing/)
|
||||
- [x] Test-PDF Datei (valid.pdf als Embedded Resource)
|
||||
- [x] DevExpressPdfProcessorTests.cs (TDD Red Phase - 6 Tests geschrieben)
|
||||
- [x] **ABGESCHLOSSEN:** DevExpressPdfProcessor.cs implementiert (TDD Green Phase) - Package: DevExpress.Document.Processor 26.1.3
|
||||
- [x] **ABGESCHLOSSEN:** Alle 6 Tests laufen erfolgreich (17.01.2025)
|
||||
- [ ] **Ausstehend:** DependencyInjection.cs (Infrastructure/DependencyInjection.cs)
|
||||
- [ ] **Ausstehend:** Polly Resilience Integration (Retry, Circuit Breaker, Timeout)
|
||||
- [ ] **Ausstehend:** IFileStorage Interface + LocalFileStorage (Dev)
|
||||
## ? Abgeschlossen
|
||||
- Solution-Struktur (Clean Architecture, 4 Projekte)
|
||||
- Domain Layer (Value Objects, Enums, Exceptions)
|
||||
- **DevExpressPdfProcessor** (TDD, 6 Tests grün, PDF-Validierung funktioniert)
|
||||
|
||||
---
|
||||
|
||||
## ?? Aktuell in Bearbeitung (Phase 3)
|
||||
|
||||
### Step 3.2: DevExpressPdfProcessor implementieren (TDD) - ? ABGESCHLOSSEN
|
||||
**Was wurde gemacht:**
|
||||
- ? Tests geschrieben (Red Phase - 17.01.2025)
|
||||
- ValidateAsync_ValidPdf_ReturnsMetadata
|
||||
- ValidateAsync_InvalidPdf_ThrowsPdfProcessingException
|
||||
- ValidateAsync_CorruptedPdf_ThrowsPdfProcessingException
|
||||
- ValidateAsync_EmptyByteArray_ThrowsDomainValidationException
|
||||
- ValidateAsync_NullByteArray_ThrowsDomainValidationException
|
||||
- ValidateAsync_PdfWithAttachments_ReturnsCorrectAttachmentCount
|
||||
- ? DevExpressPdfProcessor.cs implementiert (Green Phase - 17.01.2025)
|
||||
- DevExpress PDF API Integration mit `PdfDocumentProcessor`
|
||||
- Package: `DevExpress.Document.Processor` 26.1.3 (korrekt installiert)
|
||||
- Exception Handling (PdfProcessingException, DomainValidationException)
|
||||
- Metadaten extrahieren (Seitenzahl, Dateigröße, PDF-Version)
|
||||
- Attachments als TODO für Phase 6 markiert (API nicht direkt verfügbar)
|
||||
- ? Alle 6 Tests bestanden (17.01.2025)
|
||||
|
||||
**Erkenntnisse:**
|
||||
- `DevExpress.Document.Processor` ist das korrekte Package (nicht `DevExpress.Pdf.Core`)
|
||||
- `PdfDocumentProcessor` liegt in `DevExpress.Pdf` Namespace
|
||||
- Attachments-Handling benötigt erweiterte API (Phase 6)
|
||||
|
||||
**Zeitaufwand:** ~2 Tage (abgeschlossen)
|
||||
## ?? Diese Woche (KW 4)
|
||||
**Phase 4-5:** Erster funktionierender API-Endpoint (`POST /api/v1/documents/validate`)
|
||||
- MediatR Setup + ValidationBehavior
|
||||
- REST Endpoint + Exception Middleware
|
||||
- Swagger UI
|
||||
|
||||
---
|
||||
|
||||
## ? Nächste Schritte (Phase 4-5)
|
||||
|
||||
### Phase 4: Application Layer (~2-3 Tage)
|
||||
**Priorität:** Hoch
|
||||
**Abhängigkeiten:** Phase 3 muss abgeschlossen sein
|
||||
|
||||
**Tasks:**
|
||||
- [ ] MediatR Setup (DependencyInjection.cs, ValidationBehavior.cs, LoggingBehavior.cs)
|
||||
- [ ] ValidatePdf Feature (Query, Handler, Validator)
|
||||
- [ ] DTOs (ValidatePdfRequest, ValidatePdfResponse)
|
||||
- [ ] Unit Tests für Handler
|
||||
|
||||
**Deliverable:** Erste komplette Feature-Implementierung (ValidatePdf)
|
||||
|
||||
---
|
||||
|
||||
### Phase 5: API Layer (~2 Tage)
|
||||
**Priorität:** Hoch
|
||||
**Abhängigkeiten:** Phase 4 muss abgeschlossen sein
|
||||
|
||||
**Tasks:**
|
||||
- [ ] Exception Handling Middleware (zentrale Exception ? HTTP Status Code Mapping)
|
||||
- [ ] Minimal API Endpoint (POST /api/v1/documents/validate)
|
||||
- [ ] Swagger Configuration (API-Key Header Support)
|
||||
- [ ] Integration Test (End-to-End)
|
||||
|
||||
**Deliverable:** Funktionierender REST API Endpoint (testbar via Swagger)
|
||||
|
||||
---
|
||||
|
||||
## ?? Kritische Phasen (Production-Ready)
|
||||
|
||||
### Phase 5.5: Health Checks & Resilience (~1 Tag)
|
||||
**Priorität:** Mittel (aber wichtig für Production!)
|
||||
**Warum früh?** Load Balancer / Kubernetes brauchen Health Checks
|
||||
|
||||
**Tasks:**
|
||||
- [ ] DevExpressPdfHealthCheck (Smoke Test)
|
||||
- [ ] /health Endpoint (Liveness/Readiness Probes)
|
||||
- [ ] Polly Resilience (Retry, Circuit Breaker, Timeout für DevExpress Calls)
|
||||
|
||||
**Deliverable:** Production-ready Health Checks
|
||||
|
||||
---
|
||||
|
||||
### Phase 6.5: Async Processing (~2 Tage)
|
||||
**Priorität:** Mittel
|
||||
**Warum wichtig?** PDF-Konkatenation von 50 PDFs = 10+ Sekunden (HTTP Timeout!)
|
||||
|
||||
**Tasks:**
|
||||
- [ ] In-Memory Queue Setup (IJobQueue Interface)
|
||||
- [ ] Background Worker (JobProcessorService - IHostedService)
|
||||
- [ ] Async Endpoints (POST ? JobId, GET /jobs/{id} ? Status)
|
||||
- [ ] Job Status Tracking (In-Memory Dictionary mit ConcurrentDictionary)
|
||||
|
||||
**Deliverable:** Queue-basiertes Async Processing (In-Memory, einfache Implementierung)
|
||||
|
||||
**Hinweis:** In-Memory Queue = nicht persistent (Server-Neustart löscht Jobs). Für Production mit Load Balancer später auf Redis Queue upgraden.
|
||||
|
||||
---
|
||||
|
||||
### Phase 8: Multi-Tenancy (DB-based) (~3-4 Tage)
|
||||
**Priorität:** Hoch (für Multi-Tenant DMS!)
|
||||
**Warum DB-based?** Skalierbar, API-Key Rotation, Audit-Log
|
||||
|
||||
**Tasks:**
|
||||
- [ ] EF Core + SQLite Setup (Tenant-Datenbank)
|
||||
- [ ] Tenant/TenantSettings Entities
|
||||
- [ ] TenantRepository (ITenantRepository)
|
||||
- [ ] TenantResolutionMiddleware (API-Key ? Tenant, Redis Cache)
|
||||
- [ ] Tenant Admin API (CRUD für API-Keys)
|
||||
- [ ] API-Key Hashing (BCrypt)
|
||||
|
||||
**Deliverable:** Multi-Tenant fähige API mit DB-basiertem Tenant-Management
|
||||
|
||||
---
|
||||
|
||||
### Phase 9: File Storage (Lokale Temp-Ordner) (~1 Tag)
|
||||
**Priorität:** Mittel
|
||||
**Warum wichtig?** Temporäre Dateien für verarbeitete PDFs (Download-Links)
|
||||
|
||||
**Tasks:**
|
||||
- [ ] IFileStorage Interface
|
||||
- [ ] LocalFileStorage Implementation (appsettings: TempFolder-Pfad)
|
||||
- [ ] TempFileCleanupService (IHostedService - täglich um 3 Uhr)
|
||||
- [ ] Optionale Retention Policy (z.B. 24 Stunden)
|
||||
|
||||
**Deliverable:** Lokales File Storage mit automatischem Cleanup
|
||||
|
||||
**Hinweis:** Single-Server Setup (einfach). Für Multi-Server später auf Shared Network Drive (UNC-Pfad) upgraden.
|
||||
|
||||
---
|
||||
|
||||
## ?? Risiken & Abhängigkeiten
|
||||
|
||||
### Technische Risiken
|
||||
1. **DevExpress PDF API Stabilität**
|
||||
- **Risiko:** Unbekannte Edge Cases (korrupte PDFs, spezielles PDF-Format)
|
||||
- **Mitigation:** Polly Resilience (Retry, Circuit Breaker), umfangreiche Tests
|
||||
- **Impact:** Mittel
|
||||
|
||||
2. **In-Memory Queue (nicht persistent)**
|
||||
- **Risiko:** Server-Neustart löscht alle laufenden Jobs
|
||||
- **Mitigation:** Single-Server Setup empfohlen, später Redis Queue für Production
|
||||
- **Impact:** Niedrig (für MVP akzeptabel)
|
||||
|
||||
3. **Multi-Tenancy Komplexität**
|
||||
- **Risiko:** Tenant-Isolation muss 100% korrekt sein (Security!)
|
||||
- **Mitigation:** TDD, umfangreiche Integration Tests, Code Reviews
|
||||
- **Impact:** Hoch (aber planbar)
|
||||
|
||||
### Externe Abhängigkeiten
|
||||
- ? **DevExpress Universal License:** Verfügbar
|
||||
- ? **Redis Server:** Optional für Phase 8 (Tenant-Caching), Phase 11 (Rate-Limiting)
|
||||
- Alternative: In-Memory Cache für Single-Server Setup
|
||||
- ? **Shared Network Drive:** Nur bei Multi-Server Setup (für File Storage)
|
||||
- Alternative: Lokale Temp-Ordner für Single-Server
|
||||
|
||||
---
|
||||
|
||||
## ?? Zeitplan & Milestones
|
||||
|
||||
### Milestone 1: MVP (Minimum Viable Product) ??
|
||||
**Ziel:** Funktionierender API Endpoint (ValidatePdf)
|
||||
**Phasen:** 1-5 abgeschlossen
|
||||
**Zeitaufwand:** ~10-12 Arbeitstage
|
||||
**ETA:** Ende KW 4 / Anfang KW 5 (bei 1 Entwickler)
|
||||
|
||||
**Deliverables:**
|
||||
- ? REST API Endpoint: POST /api/v1/documents/validate
|
||||
- ? Swagger UI (testbar)
|
||||
- ? Exception Handling
|
||||
- ? Unit Tests + Integration Tests
|
||||
|
||||
---
|
||||
|
||||
### Milestone 2: Production-Ready (Core Features) ??
|
||||
**Ziel:** Production-ready API mit Health Checks, Resilience, Multi-Tenancy
|
||||
**Phasen:** 1-5.5, 6 (nur ValidatePdf + ExtractAttachments), 7, 8 abgeschlossen
|
||||
**Zeitaufwand:** ~20-25 Arbeitstage
|
||||
**ETA:** Ende KW 7 / Anfang KW 8
|
||||
## ?? Kritisch für Production
|
||||
- **KW 6:** Async Processing (Queue) - verhindert HTTP Timeouts bei großen PDFs
|
||||
- **KW 7:** Multi-Tenancy (EF Core + SQLite) - API-Key Management, Redis Cache
|
||||
|
||||
**Deliverables:**
|
||||
- ? Alle CRUD-Operationen (ValidatePdf, ExtractAttachments)
|
||||
|
||||
@@ -1,218 +0,0 @@
|
||||
# ?? Status Update - DocumentOperator (17.01.2025)
|
||||
|
||||
## ? Was wurde aktualisiert?
|
||||
|
||||
Die **ROADMAP.md** wurde vollständig mit dem **tatsächlichen Projektstand** abgeglichen und aktualisiert.
|
||||
|
||||
---
|
||||
|
||||
## ?? Haupterkenntnisse
|
||||
|
||||
### 1. **DevExpress Universal License** ?
|
||||
|
||||
**Wichtig:** Das Projekt verfügt über eine **DevExpress Universal License**!
|
||||
|
||||
**Das bedeutet:**
|
||||
- ? Vollzugriff auf **ALLE** DevExpress Bibliotheken
|
||||
- ? Nicht nur `DevExpress.Pdf.Core` - wir können **jedes** DevExpress Paket nutzen
|
||||
- ? Falls künftig Word/Excel-Verarbeitung benötigt wird ? einfach hinzufügen!
|
||||
|
||||
**Aktuell verwendet:**
|
||||
- `DevExpress.Pdf.Core` v25.2.8
|
||||
|
||||
**Bei Bedarf verfügbar:**
|
||||
- `DevExpress.Office.Core` (Word, Excel)
|
||||
- `DevExpress.Document.Processor` (erweiterte Dokumenten-Verarbeitung)
|
||||
- `DevExpress.Blazor` (falls UI später benötigt wird)
|
||||
- Alle weiteren DevExpress Produkte
|
||||
|
||||
---
|
||||
|
||||
### 2. **Aktueller Projektstand**
|
||||
|
||||
#### ? Abgeschlossen (Completed)
|
||||
|
||||
**Phase 1: Foundation**
|
||||
- ? Solution Structure (4 Projekte + Tests)
|
||||
- ? Dependencies (Clean Architecture Rules)
|
||||
- ? NuGet Packages installiert
|
||||
- ? Folder Structure erstellt
|
||||
- ? Configuration (appsettings.json, Options Pattern)
|
||||
- ? Serilog Setup
|
||||
- ? Program.cs Setup
|
||||
|
||||
**Phase 2: Domain Layer (Minimal)**
|
||||
- ? **4 Domain Exceptions:**
|
||||
- `DomainException.cs` (Basis)
|
||||
- `DomainValidationException.cs` (Value Object Validierung)
|
||||
- `NotFoundException.cs` (Resource nicht gefunden)
|
||||
- `PdfProcessingException.cs` (PDF-spezifische Fehler)
|
||||
|
||||
- ? **2 Enums:**
|
||||
- `DocumentOperationType` (Validate, ExtractAttachments, Concatenate, ApplyStamp, EmbedCertificate)
|
||||
- `ProcessingStatus` (Pending, Processing, Success, Failed)
|
||||
|
||||
- ? **3 Value Objects:**
|
||||
- `Base64String` (typsicher, selbst-validierend, mit Factory Methods)
|
||||
- `TenantId` (normalisiert, validiert)
|
||||
- `PdfMetadata` (PageCount, FileSizeBytes, PdfVersion, HasAttachments, etc.)
|
||||
|
||||
**Phase 3: Infrastructure Layer**
|
||||
- ? **IPdfProcessor Interface** erstellt
|
||||
- `Task<PdfMetadata> ValidateAsync(byte[] pdfBytes)`
|
||||
- Mit XML Comments dokumentiert
|
||||
|
||||
---
|
||||
|
||||
#### ?? In Arbeit (In Progress)
|
||||
|
||||
**Phase 3: Infrastructure Layer**
|
||||
- **NEXT:** Step 3.2 - `DevExpressPdfProcessor` implementieren (mit TDD!)
|
||||
- Ordner `Services/PdfProcessing/` existiert bereits
|
||||
- **Aber:** Noch leer - muss implementiert werden
|
||||
|
||||
---
|
||||
|
||||
#### ?? Wichtige Hinweise
|
||||
|
||||
**1. Application Layer - ProcessDocument vs ValidatePdf**
|
||||
- **Problem:**
|
||||
- Ordner: `Features/Documents/ProcessDocument/`
|
||||
- Dateien: `ProcessDocumentCommand.cs`, `ProcessDocumentHandler.cs`, `ProcessDocumentValidator.cs`
|
||||
- **Alle leer!**
|
||||
|
||||
- **Roadmap sagt:**
|
||||
- Wir sollten mit `ValidatePdf` Feature starten (nicht ProcessDocument)
|
||||
|
||||
- **Action Required:**
|
||||
- Entweder ProcessDocument-Dateien löschen
|
||||
- Oder umbenennen zu ValidatePdf
|
||||
- Oder erst später nutzen (wenn wir ein generisches ProcessDocument Command brauchen)
|
||||
|
||||
**2. Tests Layer**
|
||||
- **Problem:** Nur `UnitTest1.cs` (Dummy-Test)
|
||||
- **Action Required:**
|
||||
- Ordnerstruktur erstellen:
|
||||
```
|
||||
Tests/
|
||||
??? Unit/
|
||||
? ??? Application/
|
||||
? ??? Infrastructure/
|
||||
? ??? Domain/
|
||||
??? Integration/
|
||||
??? API/
|
||||
```
|
||||
- `UnitTest1.cs` löschen
|
||||
|
||||
**3. Infrastructure Services**
|
||||
- **Problem:** Ordner existieren, aber leer
|
||||
- `Services/PdfProcessing/` ? DevExpressPdfProcessor.cs fehlt
|
||||
- `Services/FileStorage/` ? leer
|
||||
- `Services/DocumentValidation/` ? leer
|
||||
|
||||
- **Action Required:**
|
||||
- Step 3.2 durchführen: DevExpressPdfProcessor implementieren
|
||||
|
||||
---
|
||||
|
||||
## ?? Nächste Schritte (Roadmap)
|
||||
|
||||
### Schritt 1: DevExpressPdfProcessor implementieren (Phase 3, Step 3.2)
|
||||
|
||||
**TDD-Flow:**
|
||||
1. **Test schreiben** (Red)
|
||||
- `Tests/Unit/Infrastructure/Services/PdfProcessing/DevExpressPdfProcessorTests.cs`
|
||||
- Test: `ValidateAsync_ValidPdf_ReturnsMetadata()`
|
||||
|
||||
2. **Code schreiben** (Green)
|
||||
- `Infrastructure/Services/PdfProcessing/DevExpressPdfProcessor.cs`
|
||||
- `IPdfProcessor` Interface implementieren
|
||||
- DevExpress PDF API nutzen
|
||||
|
||||
3. **Test grün machen**
|
||||
|
||||
4. **Refactoring** (falls nötig)
|
||||
|
||||
---
|
||||
|
||||
### Schritt 2: Application Layer aufräumen
|
||||
|
||||
**Option A: ProcessDocument löschen**
|
||||
```powershell
|
||||
Remove-Item "DocumentOperator.Application\Features\Documents\ProcessDocument" -Recurse
|
||||
```
|
||||
|
||||
**Option B: Zu ValidatePdf umbenennen**
|
||||
```powershell
|
||||
Rename-Item "ProcessDocument" "ValidatePdf"
|
||||
# Dann Dateien umbenennen + Namespaces anpassen
|
||||
```
|
||||
|
||||
**Option C: Behalten und später nutzen**
|
||||
- Erst ValidatePdf neu erstellen
|
||||
- ProcessDocument später für generisches Command nutzen
|
||||
|
||||
---
|
||||
|
||||
### Schritt 3: MediatR Setup (Phase 4, Step 4.1)
|
||||
|
||||
**Erstellen:**
|
||||
1. `Application/DependencyInjection.cs`
|
||||
- MediatR registrieren
|
||||
- FluentValidation registrieren
|
||||
- ValidationBehavior registrieren
|
||||
|
||||
2. `Application/Common/Behaviors/ValidationBehavior.cs`
|
||||
- Pipeline Behavior für FluentValidation
|
||||
|
||||
---
|
||||
|
||||
### Schritt 4: ValidatePdf Feature (Phase 4, Step 4.2)
|
||||
|
||||
**Erstellen:**
|
||||
1. `Application/Features/Documents/ValidatePdf/ValidatePdfQuery.cs`
|
||||
2. `Application/Features/Documents/ValidatePdf/ValidatePdfHandler.cs`
|
||||
3. `Application/Features/Documents/ValidatePdf/ValidatePdfValidator.cs`
|
||||
|
||||
**Mit TDD:**
|
||||
- `Tests/Unit/Application/Features/ValidatePdf/ValidatePdfHandlerTests.cs`
|
||||
|
||||
---
|
||||
|
||||
## ?? Empfehlung
|
||||
|
||||
**Nächster Sprint:**
|
||||
1. ? ROADMAP.md ist aktuell
|
||||
2. **Jetzt:** DevExpressPdfProcessor implementieren (mit TDD)
|
||||
3. **Dann:** Application Layer aufräumen (ProcessDocument ? ValidatePdf)
|
||||
4. **Dann:** MediatR Setup + ValidationBehavior
|
||||
5. **Dann:** ValidatePdf Feature komplett durchziehen
|
||||
|
||||
**Vorteil dieses Ansatzes:**
|
||||
- Wir sehen **echten** Code (DevExpress Integration)
|
||||
- Wir wissen welche Exceptions geworfen werden
|
||||
- Application Layer kann darauf aufbauen
|
||||
- Schneller Feedback-Loop
|
||||
|
||||
---
|
||||
|
||||
## ?? Build Status
|
||||
|
||||
? **Build erfolgreich!** (17.01.2025)
|
||||
|
||||
Alle Projekte kompilieren ohne Fehler.
|
||||
|
||||
---
|
||||
|
||||
## ?? Dokumentation
|
||||
|
||||
- ? **ROADMAP.md** vollständig aktualisiert
|
||||
- ? **STATUS_UPDATE_17_01_2025.md** erstellt (diese Datei)
|
||||
- ? DevExpress Universal License dokumentiert
|
||||
- ? Aktueller Projektstand dokumentiert
|
||||
- ? Nächste Schritte klar definiert
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** 17.01.2025
|
||||
**Status:** Ready für Phase 3, Step 3.2 (DevExpressPdfProcessor)
|
||||
Reference in New Issue
Block a user