Core Systems Documentation

This directory contains detailed documentation for CepatEdge's core systems and components.

Planned Systems Documentation

Authentication System

Status: Implemented
Location: apps/worker/src/lib/services/auth/

• JWT-based authentication with stateless sessions
• Durable Object-based session management
• Role-based access control (RBAC)

Maintenance Management System

Status: Implemented (spec evolution: see lifecycle docs)
Location: apps/worker/src/routes/maintenance/

• Locked behavior: ../../lifecycle/maintenance/ — status transitions, permissions, finalSnapshot, archive/purge
• Architecture overview: maintenance-lifecycle.md
• Multi-role workflow support; permission-based operations

Caching System

Status: Implemented
Location: apps/worker/src/lib/services/cache/

• Durable Objects for edge caching
• Multi-instance architecture
• Timestamp-based invalidation

Database Layer

Status: Implemented
Location: apps/worker/src/lib/db/

• Drizzle ORM with Neon PostgreSQL
• Type-safe queries and migrations
• Connection pooling optimization

API Framework

Status: Implemented
Location: apps/worker/src/

• Hono framework for edge APIs
• OpenAPI schema generation
• Middleware stack (auth, validation, response)

TODO: Additional Systems

• File Storage System - Cloudflare R2 integration for attachments
• Notification System - Email/SMS notifications for workflow updates
• Analytics System - Usage tracking and reporting
• Audit Logging System - Comprehensive activity logging
• Integration APIs - Third-party system integrations