# `initialize(config_json)` 配置说明

`AuthProvider.initialize(String)` 与 C API `auth_initialize(const char* config_json)` 共用同一 JSON 语义，版本由 **`schemaVersion: 1`** 锁定。

## 规范与示例

| 资源 | 路径 |
|------|------|
| JSON Schema | `schemas/craftlabs-auth-config.schema.json` |
| 码头 / 集团拓扑示例 | `examples/config/wharf.bitanswer.json` |
| 学校 / 边设备示例 | `examples/config/school.bitanswer.json` |
| 流动人口 / 项目示例 | `examples/config/floating.bitanswer.json` |
| 学校 / 自研 HTTP 示例 | `examples/config/school.selfhosted.json` |

## Java 解析与校验

```java
import cn.craftlabs.auth.config.AuthConfig;
import cn.craftlabs.auth.config.AuthConfigException;
import cn.craftlabs.auth.config.AuthConfigs;

AuthConfig cfg = AuthConfigs.parse(jsonString);
// 再交给实现（与校验使用同一字符串即可）
provider.initialize(jsonString);
```

`AuthConfig` 提供 `bitanswerFeatureId(String logicalKey)` 等辅助方法，供后续在 `hasFeature` 与比特 `QueryFeature` 之间做映射。

## 场景字段摘要

- **wharf**：`wharf.topology`（`cloud` / `group` / `local_float`）等与集中授权拓扑相关的**提示**；实际连网方式仍以 `bitanswer.url` 为准。
- **school**：`school.edgeDeviceId` 等用于运营对账；是否写入比特自定义字段由实现阶段决定。
- **floating**：**必填** `floating.projectId`；表达「按项目」授权锚点，与商务合同、控制台业务模板需一致。

后续优化（错误码、OIDC、集团占点策略等）在保持 `schemaVersion` 或递增版本的前提下扩展字段即可。