Enterprise Development Standards

Architecture Patterns

• Hexagonal architecture for all services
• CQRS for complex domains
• Event sourcing for audit trails
• Repository pattern for data access
• Factory pattern for object creation

Code Organization

src/
  domain/          # Business entities and value objects
  application/     # Use cases and application services
  infrastructure/  # External adapters (DB, APIs, etc.)
  presentation/    # Controllers and view models
  shared/          # Cross-cutting concerns

Naming Conventions

• Classes: PascalCase
• Interfaces: IPascalCase
• Methods: camelCase
• Constants: UPPER_SNAKE_CASE
• Files: kebab-case
• Database tables: snake_case

Documentation

• ADRs for all architectural decisions
• OpenAPI spec for all APIs
• Sequence diagrams for complex flows
• README in every directory

Performance

• N+1 query detection in CI
• Bundle size budget: 200KB initial JS
• Core Web Vitals monitoring
• Database query explain plans for queries > 100ms