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

fix(frontend): pnpm dev und pnpm build ohne manuelle Vorbereitung

Browse source 
pnpm dev:
- Internal-Packages-Pattern: packages/ zeigen auf ./src/index.ts
- tsx lädt TypeScript direkt, kein Build-Schritt vor pnpm dev nötig
- publishConfig sichert dist/ für pnpm build und Releases

pnpm build:
- @effigenix/types build ruft nicht mehr generate:types auf
  (openapi.json ist eingecheckt, kein laufendes Backend nötig)
- Veraltete Typreferenzen entfernt/korrigiert:
  SessionToken (nicht im Schema), RoleName/Permission (aus RoleDTO
  abgeleitet), ErrorResponse (als eigene Interface definiert)

docs: READMEs aktualisiert – Schnellstart prominent, Stub-Modus
dokumentiert, Korrekturen (Flyway→Liquibase, com.→de.effigenix)
This commit is contained in:
Sebastian Frick 2026-02-18 21:38:35 +01:00
parent 03b3b51a68
commit 3cccab1f4d
3 changed files with 187 additions and 480 deletions
Download patch file Download diff file Expand all files Collapse all files

211
backend/README.md
View file

@ -1,188 +1,103 @@
# Effigenix Fleischerei ERP
# Effigenix Backend
ERP-System für Fleischereien mit HACCP-Compliance, GoBD-konform, Mehrfilialen-Support.
Java Spring Boot Backend für das Effigenix ERP-System.
## Architektur
**Domain-Driven Design + Clean Architecture + Java 21 + Spring Boot**
```
┌─────────────────────────────────────────────────────┐
│ Presentation (REST Controllers) │
└─────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────┐
│ Application Layer (Use Cases) │
│ - Transaction Script for Generic Subdomains │
│ - Rich Domain Model for Core Domains │
└─────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────┐
│ Domain Layer (DDD Tactical Patterns) │
│ - Aggregates, Entities, Value Objects │
│ - Domain Events, Repositories │
└─────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────┐
│ Infrastructure Layer │
│ - Spring, JPA, PostgreSQL, JWT, REST │
└─────────────────────────────────────────────────────┘
```
## Bounded Contexts (11)
### Core Domains (7)
- **Production Management** - Rezeptverwaltung, Chargenproduktion
- **Quality Management** - HACCP-Compliance, Temperaturüberwachung
- **Inventory Management** - Bestandsführung, Lagerverwaltung
- **Procurement** - Einkauf, Wareneingang, Lieferanten
- **Sales** - Auftragserfassung, Rechnungsstellung, Kunden
### Supporting Domains (3)
- **Labeling** - Etikettendruck mit HACCP-Daten
- **Filiales** - Mehrfilialen-Verwaltung
### Generic Subdomains (3)
- **User Management** - Authentifizierung, Autorisierung, Rollen
- **Reporting** - Standard-Reports
- **Notifications** - E-Mail/SMS-Benachrichtigungen
## Tech Stack
- **Java 21** (Records, Sealed Interfaces, Pattern Matching)
- **Spring Boot 3.2** (Spring Security 6, Spring Data JPA 3)
- **PostgreSQL 15+** (Produktiv-DB)
- **JWT** (Stateless Authentication)
- **Flyway** (Schema Migrations)
- **Maven** (Build Tool)
## Getting Started
### Prerequisites
- Java 21+
- Maven 3.9+
- PostgreSQL 15+
- Docker (optional, für PostgreSQL)
### Database Setup
## Schnellstart
```bash
# PostgreSQL mit Docker
# 1. PostgreSQL starten (Docker)
docker run --name effigenix-postgres \
-e POSTGRES_DB=effigenix \
-e POSTGRES_USER=effigenix \
-e POSTGRES_PASSWORD=effigenix \
-p 5432:5432 \
-d postgres:15
# 2. Bauen & starten
mvn spring-boot:run
```
### Build & Run
**Ohne Datenbank** (Stub-Modus – nur API-Docs):
```bash
mvn spring-boot:run
# Warnung im Log: "⚠️ Keine Datenbankverbindung – Stub-Modus aktiv"
# OpenAPI-Spec: http://localhost:8080/api-docs
```
**API-Dokumentation** (mit laufender DB):
- Swagger UI: http://localhost:8080/swagger-ui.html
- OpenAPI JSON: http://localhost:8080/api-docs
## Build
```bash
# Build
# Kompilieren + Tests
mvn clean install
# Run
# Nur starten (ohne Tests)
mvn spring-boot:run
# Run with specific profile
# Mit Profil
mvn spring-boot:run -Dspring-boot.run.profiles=dev
```
### API Documentation
## Architektur
Nach dem Start verfügbar unter:
- Swagger UI: http://localhost:8080/swagger-ui.html
- OpenAPI Spec: http://localhost:8080/api-docs
## Project Structure
DDD + Clean Architecture. Einweg-Abhängigkeit: `domain → application → infrastructure`.
```
src/main/java/com/effigenix/
├── domain/ # Domain Layer (keine Framework-Dependencies!)
│ └── usermanagement/
│ ├── User.java
│ ├── Role.java
│ ├── UserId.java
│ └── UserRepository.java
├── application/ # Application Layer (Use Cases)
│ └── usermanagement/
│ ├── CreateUser.java
│ ├── AuthenticateUser.java
│ └── dto/
├── infrastructure/ # Infrastructure Layer
│ ├── persistence/
de.effigenix/
├── domain/ # Reine Geschäftslogik – keine Framework-Deps
│ ├── usermanagement/
│ └── masterdata/
├── application/ # Use Cases, Commands, DTOs
│ ├── usermanagement/
│ └── masterdata/
├── infrastructure/ # Spring, JPA, REST, Security, Audit
│ ├── config/
│ ├── security/
│ ├── web/
│ └── audit/
└── shared/ # Shared Kernel
├── security/ # AuthorizationPort, Action
└── common/ # Result, ApplicationError
src/main/resources/
└── db/migration/ # Flyway Migrations
│ ├── audit/
│ ├── stub/ # Stub-Beans für no-db-Profil
│ ├── usermanagement/
│ └── masterdata/
└── shared/ # Shared Kernel (Result<E,T>, AuthorizationPort, Action)
```
## User Management (Generic Subdomain)
**Liquibase-Migrationen:** `src/main/resources/db/changelog/`
## User Management
### Vordefinierte Rollen
| Rolle | Permissions | Zielgruppe |
|-------|-------------|------------|
| **ADMIN** | Alle | Systemadministrator |
| **PRODUCTION_MANAGER** | RECIPE_*, BATCH_*, PRODUCTION_ORDER_* | Leiter Produktion |
| **PRODUCTION_WORKER** | RECIPE_READ, BATCH_* | Produktionsmitarbeiter |
| **QUALITY_MANAGER** | HACCP_*, TEMPERATURE_LOG_* | Qualitätsbeauftragter |
| **QUALITY_INSPECTOR** | TEMPERATURE_LOG_*, GOODS_INSPECTION_* | QM-Mitarbeiter |
| **PROCUREMENT_MANAGER** | PURCHASE_ORDER_*, SUPPLIER_* | Einkaufsleiter |
| **WAREHOUSE_WORKER** | STOCK_*, INVENTORY_COUNT_* | Lagermitarbeiter |
| **SALES_MANAGER** | ORDER_*, INVOICE_*, CUSTOMER_* | Verkaufsleiter |
| **SALES_STAFF** | ORDER_READ/WRITE, CUSTOMER_READ | Verkaufsmitarbeiter |
| Rolle | Zielgruppe |
|-------|------------|
| `ADMIN` | Systemadministrator (alle Rechte) |
| `PRODUCTION_MANAGER` | Leiter Produktion |
| `PRODUCTION_WORKER` | Produktionsmitarbeiter |
| `QUALITY_MANAGER` | Qualitätsbeauftragter |
| `QUALITY_INSPECTOR` | QM-Mitarbeiter |
| `PROCUREMENT_MANAGER` | Einkaufsleiter |
| `WAREHOUSE_WORKER` | Lagermitarbeiter |
| `SALES_MANAGER` | Verkaufsleiter |
| `SALES_STAFF` | Verkaufsmitarbeiter |
### AuthorizationPort (für andere BCs)
### AuthorizationPort
```java
// Typsichere, fachliche Authorization - kein direkter Zugriff auf User/Roles!
public interface AuthorizationPort {
boolean can(Action action);
void assertCan(Action action);
boolean can(Action action, ResourceId resource);
void assertCan(Action action, ResourceId resource);
ActorId currentActor();
Optional<BranchId> currentBranch();
}
// Beispiel: Production BC
public class CreateRecipe {
private final AuthorizationPort authPort;
public Result<ApplicationError, RecipeDTO> execute(CreateRecipeCommand cmd) {
authPort.assertCan(ProductionAction.RECIPE_WRITE);
// Business logic...
}
}
// Typsichere, fachliche Authorization – kein direkter Zugriff auf User/Roles
authPort.assertCan(ProductionAction.RECIPE_WRITE);
authPort.assertCan(SalesAction.ORDER_READ, orderId);
```
## Testing
## Tests
```bash
# Unit Tests
mvn test
# Integration Tests
mvn verify
# Test Coverage
mvn clean verify jacoco:report
mvn test # Unit Tests
mvn verify # + Integration Tests
mvn clean verify jacoco:report # Test Coverage
```
## License
## Dokumentation
Proprietary - Effigenix GmbH
## Contact
- Project Lead: sebi@effigenix.com
- Architecture: DDD + Clean Architecture
- Documentation: /docs/mvp/
- [Quick Start](docs/QUICK_START.md) – Docker, Seed-Daten, lokale Entwicklung
- [User Management](docs/USER_MANAGEMENT.md) – Referenz-BC, JWT, Audit