mirror of
https://github.com/hpd840321/craftlabs-authorization-sdk.git
synced 2026-06-09 18:10:30 +08:00
huangping
76ff98db87
Add PARALLEL_ITERATION_INDEX, workspace layout, system architecture, three-track execution packs, BPM/product references, and planned service manifests. Supports I1 alignment across backend, web, and SDK. Made-with: Cursor
27 lines
1.2 KiB
Markdown
27 lines
1.2 KiB
Markdown
# license-webhook-ingress（规划）
|
||
|
||
## 职责
|
||
|
||
- 接收比特授权云 **规则 Callback**（HTTPS POST + JSON）。
|
||
- 校验 `x-bitanswer-token`（或约定头）；**快速返回 2xx**；正文异步处理。
|
||
- 将事件写入 **消息队列** 或 **inbox 表**（与平台一致：**PostgreSQL 15** + **MyBatis-Plus**），由 `delivery-platform-api` 消费（或同仓 Worker 模块）。
|
||
|
||
## 建议技术栈
|
||
|
||
- **Java 21+**（与团队 JDK LTS 一致）、**Spring Boot 4.0.\***。
|
||
- 无 UI；可选 Spring Cloud Gateway 前置，或裸 Tomcat/Jetty + Actuator。
|
||
|
||
## 与本工作区关系
|
||
|
||
- **不依赖** `craftlabs-auth-bitanswer` native。
|
||
- 事件 Schema 对齐 [比特规则文档](../../../docs/bitanswer-licensing-design-and-rules.md) §5 与 [Callback 评估](../../../docs/bitanswer-callbacks-endpoints-assessment.md)。
|
||
|
||
## 构建与部署
|
||
|
||
- 与平台 API 相同策略：**Maven 多模块** + **唯一 `bootstrap` 模块** `spring-boot-maven-plugin` **repackage** → **单枚** `webhook-bootstrap.jar` 部署。
|
||
- **不依赖** `craftlabs-auth-bitanswer`。
|
||
|
||
## 仓库建议名
|
||
|
||
`craftlabs-license-webhook`（可改名；与 `workspace-manifest.json` 中 `plannedRepositories` 保持一致即可）。
|