docs(i1): engineering index, parallel tracks, and product context

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
This commit is contained in:
2026-04-06 21:04:49 +08:00
parent 3894315759
commit 76ff98db87
19 changed files with 2878 additions and 0 deletions
@@ -0,0 +1,26 @@
# 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` 保持一致即可)。