docs: and skills

bin/README.md

@@ -0,0 +1,115 @@
+# Effigenix Fleischerei ERP
+
+ERP-System für Fleischereien mit HACCP-Compliance, GoBD-konform, Mehrfilialen-Support.
+
+## Schnellstart
+
+### Backend
+
+```bash
+# 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)
+
+```bash
+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](backend/README.md)
+- [Frontend README](frontend/README.md)
+- [Quick Start (Detail)](backend/docs/QUICK_START.md)
+- [User Management](backend/docs/USER_MANAGEMENT.md)
+
+## License
+
+Proprietary – Effigenix GmbH