Cursor rule

1---
2description: EEIK Architecture Rules — hexagonal architecture and DDD
3globs: ["**/*.java", "**/*.ts"]
4alwaysApply: true
5---
6<!-- Generated by EEIK generate_adapters.py on 2026-08-10 — do not edit by hand -->
7 
8## Hexagonal Architecture
9 
10Package structure (Java):
11```
12domain/         — Entities, value objects, domain events, ports (interfaces)
13application/    — Use cases, command/query handlers
14infrastructure/ — JPA repos, messaging, external clients
15web/            — REST controllers, DTOs
16```
17 
18Dependencies flow INWARD only:
19- infrastructure → application → domain
20- web → application
21- domain has ZERO dependencies on other layers
22 
23## DDD Rules
24 
25- Aggregates enforce invariants — no direct field access from outside
26- Domain events for cross-context communication — never direct DB joins across contexts
27- Value objects are immutable
28- Repositories return domain objects, not JPA entities
29 
30## Knowledge Base
31 
32- Patterns: `knowledge/patterns/`
33- Anti-patterns: `knowledge/anti-patterns/`
34- Reference architectures: `knowledge/reference-architectures/`
35