craftlabs-authorization-sdk/README.md

# CraftLabs Authorization SDK

创飞 **客户端授权 SDK** 工作区：Java API + Native 动态库 + **授权配置 JSON Schema** + 示例与文档。  
**商业交付管理平台**（合同/交付/SN/Webhook 运营后台）按架构设计为 **独立仓库**，见 [`engineering/planned/`](engineering/planned/) 与 [`docs/engineering/WORKSPACE_ENGINEERING_LAYOUT.md`](docs/engineering/WORKSPACE_ENGINEERING_LAYOUT.md)。  
平台后端 **运维部署** 为 **单枚可执行 Fat JAR**（多模块源码、`bootstrap` 唯一 `repackage`）；**切勿**与下方 **客户端 SDK** 工件混用或把 SDK 打进平台 JAR。

## 仓库结构

| 目录 | 说明 |
|------|------|
| [`java/`](java/) | Maven 多模块：`craftlabs-auth-core`、`craftlabs-auth-bitanswer`、`craftlabs-auth-selfhosted`、`craftlabs-auth-tests` |
| [`native/`](native/) | **Rust Cargo workspace**：`craft-core` cdylib 导出 `craft_*` C ABI（对齐 `docs/平台架构思路.md`）；旧 C++ CMake 见 `.deprecated-cmake/` |
| [`schemas/`](schemas/) | `craftlabs-auth-config` JSON Schema |
| [`examples/`](examples/) | 示例配置与烟测脚本 |
| [`docs/`](docs/) | 比特对接、创飞平台产品/流程/工程架构文档 |
| [`engineering/`](engineering/) | 工作区 manifest、**规划工程占位** |

## 构建

```bash
# Java（需 JDK 17+）
mvn -f java/pom.xml verify

# Rust 核心库（需 Rust 1.70+）
cargo build --manifest-path native/craft-core/Cargo.toml --release
# 产物：native/target/release/libcraftlabs_auth_bitanswer.{so,dylib,dll}
```

## 发布与完整性（SHA-256 / GPG）

对外发版前生成 **`SHA256SUMS`**、可选 **GPG 签 JAR** 与 **`SHA256SUMS.asc`**，见 **[`java/RELEASING.md`](java/RELEASING.md)**（脚本：`scripts/sdk-release-checksums.sh`）。

## 文档索引

- 工程划分与边界（架构）：[`docs/engineering/WORKSPACE_ENGINEERING_LAYOUT.md`](docs/engineering/WORKSPACE_ENGINEERING_LAYOUT.md)
- 三轨并行迭代（后端/前端/SDK）：[`docs/engineering/PARALLEL_ITERATION_INDEX.md`](docs/engineering/PARALLEL_ITERATION_INDEX.md)
- 平台功能模块：[`docs/chuangfei-platform-product-modules.md`](docs/chuangfei-platform-product-modules.md)
- 业务流程与版本排期：[`docs/chuangfei-platform-bpm-and-roadmap.md`](docs/chuangfei-platform-bpm-and-roadmap.md)
- 比特授权与规则纲要：[`docs/bitanswer-licensing-design-and-rules.md`](docs/bitanswer-licensing-design-and-rules.md)

## 许可证

版权所有 © 广州创飞人工智能技术有限公司（以项目实际声明为准）。