Skip to main content

Directory module

Identity, organisations, users, roles, and permissions. The foundation every other module depends on.

  • Source: apps/directory/
  • Schema: identity
  • Domain events: organisation.created, organisation.verified, user.created, user.suspended, role.assigned, role.permission_changed, credential.expired, qualification.updated
  • Project Tracker prefix: DIR-*

Architecture layers​

LayerPath
API Routessrc/app/api/
Toolssrc/server/tools/
Servicessrc/server/services/
Repositoriessrc/server/repositories/
Policiessrc/server/policies/
Workflowssrc/server/workflows/
Eventssrc/server/events/

Call direction is strict: API Route → Tool → Service → Repository. Never call a service or repository directly from an API route.

API reference​

The Directory API reference is not yet wired into this site — adding Zod→OpenAPI to apps/directory/ is tracked as a follow-up to INF-18.