Architecture Overview

Module Status

Module	Status	Notes
Core/Platform	🚧 In Progress	AbstractId, Timestamps, DomainEventInterface, TenantId, FileStorage, org context contracts
Core/Identity	🚧 In Progress	Tenant, User, ApiKey aggregates, Zitadel OIDC auth, API key auth, admin CRUD
Module/Organization	🚧 In Progress	Full DDD module: Organization + OrgMembership, ltree hierarchy, admin + API
Module/People	📋 Designed	User profiles, privacy, directory. Modeled on User aggregate.
Module/Groups	🚧 In Progress	Full DDD module: Group + GroupMembership, member management, admin + API
Module/Events	🚧 In Progress	Full DDD module: Event + EventRegistration, publish/cancel, recurrence, admin + API
Module/News	📋 Designed	Multi-level feed, push notifications
Module/Giving	⏳ Phase 2	Donations, pledges, campaigns
Module/Chat	⏳ Phase 2	Group chat, 1:1 messaging
Pipeline/Audit	🚧 In Progress	AuditEntry, async handler, superadmin UI
Pipeline/History	🚧 In Progress	EntitySnapshot, versioned snapshots

Architecture Layers


┌─────────────────────────────────────────────────────────────┐
│                     Presentation Layer                       │
│            API Controllers · Admin (Twig + Vue 3)            │
├─────────────────────────────────────────────────────────────┤
│                     Application Layer                        │
│         Commands · Queries · Handlers · DTOs                 │
├─────────────────────────────────────────────────────────────┤
│                       Domain Layer                           │
│   Aggregates · Value Objects · Domain Events · Contracts     │
│                  ← Pure PHP, no framework →                  │
├─────────────────────────────────────────────────────────────┤
│                   Infrastructure Layer                        │
│     Doctrine · Messenger · Flysystem · Zitadel · Redis       │
└─────────────────────────────────────────────────────────────┘

Project Structure


src/
├── Core/           ← Platform, Identity (shared contracts)
│   ├── Platform/   ← AbstractId, Timestamps, TenantId, events
│   └── Identity/   ← User, Tenant, ApiKey, auth
├── Module/         ← Feature modules (DDD bounded contexts)
│   ├── Organization/
│   ├── Groups/
│   ├── Events/
│   ├── People/     ← Designed, not yet implemented
│   └── News/       ← Designed, not yet implemented
└── Pipeline/       ← Observe & Protect (cross-cutting)
    ├── Audit/      ← Append-only audit log
    └── History/    ← Entity version snapshots

Key Architecture Rules

Domain layer is pure PHP. No Doctrine, no Symfony, no framework imports.
Modules communicate via domain events or contract interfaces. Never import another module's domain or infrastructure.
Every domain event is JSON-serializable with a version field.
Deptrac enforces all boundaries. If Deptrac fails, the code doesn't merge.
No cross-module database queries. One module, one schema prefix.
Tests accompany every feature. Unit tests for domain, integration for infrastructure.

Tech Stack

Layer	Technology
Backend	Symfony 8.0, PHP 8.4+
Database	PostgreSQL 16 + ltree
Cache/Queue	Redis 7 + Symfony Messenger
Identity	Zitadel (self-hosted OIDC)
Frontend	React Native (Expo) — iOS, Android, Web
Storage	Cloudflare R2 + CDN
Hosting	Hetzner, Docker, Cloudflare Pages
IaC	OpenTofu
CI/CD	GitLab CI/CD