sebi/effigenix
1
0
Fork 0
mirror of https://github.com/s-frick/effigenix.git synced 2026-03-28 14:09:34 +01:00
Code Issues Releases Activity Actions

refactor: restructure repository with separate backend and frontend directories

Browse source 
- Move Java backend to backend/ directory
- Create frontend/ directory for TypeScript TUI and future WebUI
- Update .gitignore for Node.js and worktrees
- Update README.md with new repository structure
- Copy documentation to backend/
This commit is contained in:
Sebastian Frick 2026-02-17 22:08:51 +01:00
parent ec9114aa0a
commit c2c48a03e8
141 changed files with 734 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

162
docs/mvp/ddd/05-quality-bc.md
View file

@ -1,162 +0,0 @@
# Quality BC (HACCP/QM) - Detailliertes Domain Model
**Bounded Context:** Quality
**Domain Type:** CORE
**Verantwortung:** HACCP-Compliance, Qualitätsmanagement, Audit-Vorbereitung
---
## Aggregates
### 1. TemperatureLog (Aggregate Root)
```
TemperatureLog
├── TemperatureLogId (VO)
├── MeasurementPoint (VO: COLD_ROOM | FREEZER | DISPLAY_COUNTER | PRODUCTION_ROOM)
├── DeviceId (VO) - Reference to Equipment
├── MeasuredAt (VO: Timestamp)
├── Temperature (VO: with unit °C)
├── MeasuredBy (VO: UserId)
├── CriticalLimitMin (VO)
├── CriticalLimitMax (VO)
└── Status (VO: OK | WARNING | CRITICAL)
Invariants:
- Temperature must be within physically possible range (-50°C to +50°C)
- MeasuredAt cannot be in the future
- Status = CRITICAL if temperature outside critical limits
- Status = WARNING if temperature close to limits (within 10%)
- CriticalLimitMin < CriticalLimitMax
```
### 2. CleaningRecord (Aggregate Root)
```
CleaningRecord
├── CleaningRecordId (VO)
├── Area (VO: PRODUCTION_ROOM | COLD_STORAGE | SALES_COUNTER | EQUIPMENT)
├── CleaningPlanId (VO) - Reference to CleaningPlan
├── ScheduledFor (VO: Date)
├── CompletedAt (VO: Timestamp)
├── CompletedBy (VO: UserId)
├── ChecklistItems[] (Entity)
│ ├── Item (VO: "Floor mopped", "Surfaces disinfected")
│ ├── Checked (VO: boolean)
│ └── Remarks (VO: optional)
└── OverallRemarks (VO)
Invariants:
- All checklist items must be checked to complete
- CompletedAt must be >= ScheduledFor
- Cannot complete without CompletedBy
- Cannot modify after completion
```
### 3. GoodsReceiptInspection (Aggregate Root)
```
GoodsReceiptInspection
├── InspectionId (VO)
├── GoodsReceiptId (VO) - Reference to Procurement BC
├── InspectedAt (VO)
├── InspectedBy (VO: UserId)
├── TemperatureCheck (Entity)
│ ├── MeasuredTemperature (VO)
│ ├── ExpectedRange (VO)
│ └── Status (VO: PASSED | FAILED)
├── VisualInspection (Entity)
│ ├── PackagingIntact (VO: boolean)
│ ├── ColorAppearance (VO: NORMAL | ABNORMAL)
│ ├── SmellTest (VO: NORMAL | ABNORMAL)
│ └── Remarks (VO)
├── MHDCheck (Entity)
│ ├── ExpiryDate (VO)
│ ├── DaysUntilExpiry (VO)
│ ├── MinimumAcceptableDays (VO)
│ └── Status (VO: PASSED | FAILED)
├── DocumentCheck (Entity)
│ ├── DeliveryNoteReceived (VO: boolean)
│ ├── VeterinaryCertificateReceived (VO: boolean)
│ ├── QualityCertificates[] (VO)
│ └── AllDocumentsComplete (VO: boolean)
├── SupplierBatchNumber (VO) - For traceability!
└── FinalResult (VO: ACCEPTED | REJECTED | CONDITIONALLY_ACCEPTED)
Invariants:
- All checks must be performed before FinalResult can be set
- If REJECTED, OverallRemarks must be provided
- Temperature must be within acceptable range for ACCEPTED
- MHD must have minimum days for ACCEPTED
- VeterinaryCertificate required for meat products
```
### 4. TrainingRecord (Aggregate Root)
```
TrainingRecord
├── TrainingRecordId (VO)
├── EmployeeId (VO: UserId)
├── TrainingType (VO: HACCP | HYGIENE | FOOD_SAFETY | EQUIPMENT_OPERATION)
├── TrainingDate (VO)
├── ValidUntil (VO) - Auffrischung notwendig
├── Trainer (VO) - Internal or external
├── CertificateNumber (VO)
├── CertificateDocumentUrl (VO)
└── Status (VO: VALID | EXPIRED | REVOKED)
Invariants:
- ValidUntil must be after TrainingDate
- Status = EXPIRED if ValidUntil < TODAY
- Cannot revoke without reason
```
### 5. MaintenanceRecord (Aggregate Root)
```
MaintenanceRecord
├── MaintenanceRecordId (VO)
├── EquipmentId (VO)
├── MaintenanceType (VO: SCHEDULED | REPAIR | INSPECTION)
├── ScheduledFor (VO: Date)
├── PerformedAt (VO: Timestamp)
├── PerformedBy (VO) - Internal staff or external company
├── Findings (VO)
├── Actions (VO)
├── NextMaintenanceDue (VO: Date)
└── Status (VO: COMPLETED | PENDING | FAILED)
Invariants:
- PerformedAt must be >= ScheduledFor
- If FAILED, Findings and Actions must be documented
- NextMaintenanceDue must be calculated based on maintenance interval
```
## Repository Interfaces
```java
public interface TemperatureLogRepository {
Result<RepositoryError, Void> save(TemperatureLog log);
Result<RepositoryError, List<TemperatureLog>> findByPeriod(
LocalDate from, LocalDate to
);
Result<RepositoryError, List<TemperatureLog>> findCritical();
}
public interface GoodsReceiptInspectionRepository {
Result<RepositoryError, Void> save(GoodsReceiptInspection inspection);
Result<RepositoryError, GoodsReceiptInspection> findByGoodsReceiptId(
GoodsReceiptId id
);
}
```
## Domain Events
```java
TemperatureCriticalLimitExceeded(TemperatureLogId, MeasurementPoint, Temperature)
CleaningOverdue(CleaningPlanId, Area, LocalDate scheduledFor)
GoodsReceiptRejected(InspectionId, GoodsReceiptId, String reason)
TrainingExpiringSoon(TrainingRecordId, UserId, LocalDate expiryDate)
MaintenanceOverdue(EquipmentId, LocalDate scheduledFor)
```