Skip to content
bitzorcas
EN

Guide

概述

平台模块——Files、Notifications、Webhooks、PlatformBilling、Catalog、Tickets、Chat。

Last updated

当前已实现 7 个平台模块,每个都是一个具有自己的端口、适配器和 Contracts 程序集的限界上下文。业务模块(Cases、Billing、Workflow)计划在后续阶段实现。

已实现模块

模块用途契约关键端口
Files文件资产管理、预签名上传 URL、Owner 策略FileAssetFileAssetSummaryFileAssetStateIFileAssetRepositoryIFileStorage
Notifications站内通知 Inbox,含严重程度和状态追踪NotificationNotificationSummaryNotificationStateINotificationRepositoryINotificationPublisher
Webhooks外部事件订阅、HMAC 签名、投递日志、重试WebhookSubscriptionWebhookDeliveryLogWebhookSignatureIWebhookSubscriptionRepositoryIWebhookDeadLetterQueue
PlatformBillingSaaS 套餐、订阅、权益、用量计量、发票PlanPlatformSubscriptionUsageRecordPlatformInvoiceIPlatformBillingRepository
Catalog商品目录,含分类、定价和套餐映射CatalogItemCatalogItemSummaryPriceModelCategoryICatalogRepository
Tickets支持工单,含生命周期、评论、附件和状态机TicketTicketStatusTicketTransitionRulesITicketRepositoryITicketAttachmentAccessService
Chat频道、消息、成员、已读标记、提及、实时ChatMessageChannelChannelMembershipReadMarkerIChatRepositoryIChatRealtimeAdapter

计划模块(后续阶段)

模块用途
Identity用户账号、MFA、外部身份联邦
Cases案件管理——核心业务域
Billing财务账单、发票管理、资损防护
Workflow自研流程引擎核心——定义、实例、任务、网关、SLA

模块五件套

每个模块遵循相同的结构,见 ADR 0017

src/Modules/<Category>/<Module>/
BitzOrcas.<Module>.Contracts/ # 公共契约(DTO、集成事件、常量)
BitzOrcas.<Module>.Domain/ # 领域模型(实体、值对象、领域事件)
BitzOrcas.<Module>.Application/ # 用例(命令、查询、处理器、管道)
BitzOrcas.<Module>.Infrastructure/ # 持久化 / 外部集成
BitzOrcas.<Module>.Endpoints/ # Minimal API 端点 + AddModule 扩展

依赖方向严格单向:Endpoints → Application → Domain。跨模块通信仅通过 *.Contracts 程序集。

相关