Introduction

Provides a concise overview of the crm/server package and links to feature-level pages (CRUD, Dynamic Objects, Flows, Extensions, Pub-Sub, metadata hooks and shared utilities).

Quick facts

• Package: crm/server
• Entry point: app.ts
• Router factory: routes/index.ts → createHonoRouter
• Middleware: lib/middleware/* (sessionMiddleware, tenantMiddleware, lifecycleMiddleware)
• Feature surface: features/* (per-feature layers & services)

Runtime & request flow

File map (important locations)

• app.ts — server bootstrap + global middleware + subscribers
• routes/ — Hono route modules that expose the public API
• features/ — feature modules (see feature pages linked below)
• lib/middleware/ — tenant/session/lifecycle middleware
• lib/hooks/ — request lifecycle hooks registry

Where to start reading

• CRUD Engine — Pure Prisma-backed CRUD logic.
• Dynamic Objects — Runtime-defined entities.
• Flows & Automation — Durable workflow engine.
• Extensions — Sandboxed actions and UI artifacts.
• Pub-Sub — Event-driven background tasks.
• Metadata Admin — Database migration hooks.
• Shared Utilities — Core operational building blocks.

---

Technical reference

For deeper maintenance guides, including sequence diagrams and runbooks, explore the sub-directories for each feature.