DDATMarketingDocs
HomeGitHub
Modules
Docs/Modules
Tài liệu sống được đồng bộ theo codebase hiện tại.

Foundation Modules

Các module nền tảng thay cho core/saas gom trách nhiệm.

Mô hình hiện tại

Repo dùng module phẳng modules/*. Không phát triển tiếp theo hướng một module lớn core hoặc saas gom nhiều trách nhiệm.

Nhóm nền tảng chính

ModuleTrách nhiệm
modules/authĐăng nhập, session, token, auth services
modules/usersAdmin users, SaaS users, profile, user security
modules/permissionsPlatform RBAC, role, permission, interface type
modules/organizationsOrganization và membership cấp organization
modules/workspacesWorkspace, workspace membership, bootstrap context
modules/sitesWebsite, domain, public runtime resolver
modules/billingPlan, subscription, pricing
modules/enablementWorkspace module enablement, quota, entitlement
modules/registryRegistry module và installation state
modules/themesTheme metadata và website theme mapping

Quy tắc ownership

  • Module sở hữu schema, relations, seed, API route và UI surface liên quan đến nghiệp vụ của nó.
  • packages/db-kit sở hữu DB runtime/helper chung.
  • packages/module-contracts sở hữu contract manifest/module shared.
  • packages/auth sở hữu JWT/helper dùng chung.
  • Không thêm alias hoặc dependency mới trỏ lại modules/core hoặc modules/saas.

Khi mở rộng

Tạo hoặc hoàn thiện module theo contract hiện tại: db, api, admin, saas, shared, README.md, rồi chạy bun run packages/cli/src/index.ts module:check.