effigenix/bin

Effigenix Fleischerei ERP

ERP-System für Fleischereien mit HACCP-Compliance, GoBD-konform, Mehrfilialen-Support.

Schnellstart

Backend

# 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

# Backend bauen & starten
cd backend
mvn spring-boot:run

Kein Docker? Das Backend startet auch ohne Datenbank im Stub-Modus (Warnlog erscheint). Die OpenAPI-Spec ist dann unter http://localhost:8080/api-docs abrufbar.

Frontend (Terminal UI)

cd frontend
pnpm install
pnpm dev      # startet direkt, kein Build-Schritt nötig

---

Repository Structure

effigenix/
├── backend/          # Java Spring Boot Backend
│   ├── src/          # Java source code (DDD + Clean Architecture)
│   ├── docs/         # Backend documentation
│   └── pom.xml
│
└── frontend/         # TypeScript Frontend (pnpm Monorepo)
    ├── apps/cli/     # Terminal UI (Ink/React)
    └── packages/     # Shared: api-client, types, validation, config

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

• 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

• Labeling – Etikettendruck mit HACCP-Daten
• Filiales – Mehrfilialen-Verwaltung

Generic Subdomains

• User Management – Authentifizierung, Autorisierung, Rollen (implementiert)
• Reporting – Standard-Reports
• Notifications – E-Mail/SMS-Benachrichtigungen

Tech Stack

Schicht	Technologie
Backend	Java 21, Spring Boot 3.2, Spring Security 6
Datenbank	PostgreSQL 15+, Liquibase
Auth	JWT (JJWT), Stateless
Build	Maven
Frontend	TypeScript, React, Ink (TUI)
Packages	pnpm Workspaces, tsup, Zod, Axios

Weiterführend

• Backend README
• Frontend README
• Quick Start (Detail)
• User Management

License

Proprietary – Effigenix GmbH