单二进制分布式配置服务：Rust 主服务（Raft 集群 + 内嵌 Admin UI + 三语言 SDK）。 配置按 项目 → 分支（dev/test/prod + 自定义）→ 分组 → item 组织； 修改走"草稿 → 版本 → 发布 → 通知"闭环；结构项目级强一致，仅值按分支不同。
server/target/debug/defing --dev-single --admin-password admin123 --allow-no-master-key --http-addr 127.0.0.1:8384
# 管理面: http://127.0.0.1:8384 （/admin 内嵌控制台，/metrics，/healthz）
# 数据面: GET /v1/projects/{p}/branches/{b}/snapshot （SDK 拉配置，纯值+版本号）
# SSE /v1/projects/{p}/branches/{b}/watch （订阅发布事件）方式一（推荐）：静态成员表 --bootstrap-peers —— 三节点传完全相同的三段式成员表，
并行启动直接选举，全员 voter，无需 join/promote（研究/设计见 docs/research-cluster-bootstrap.md）：
SEED="1@127.0.0.1:8385@127.0.0.1:8384,2@127.0.0.1:8387@127.0.0.1:8386,3@127.0.0.1:8389@127.0.0.1:8388"
defing --node-id 1 --bootstrap-peers "$SEED" --http-addr 127.0.0.1:8384 --raft-addr 127.0.0.1:8385 --data-dir ./n1 --admin-password admin123 --allow-no-master-key --join-token demo --raft-token demo
defing --node-id 2 --bootstrap-peers "$SEED" --http-addr 127.0.0.1:8386 --raft-addr 127.0.0.1:8387 --data-dir ./n2 --admin-password admin123 --allow-no-master-key --join-token demo --raft-token demo
defing --node-id 3 --bootstrap-peers "$SEED" --http-addr 127.0.0.1:8388 --raft-addr 127.0.0.1:8389 --data-dir ./n3 --admin-password admin123 --allow-no-master-key --join-token demo --raft-token demo
# 三段式必填：node_id@raft_addr@http_addr；条目校验：地址查重、拒绝 0.0.0.0、端口 1-65535；
# 已有数据（重启/crash 恢复）自动 resume，seed 与集群成员表不一致会 WARN（不覆盖）；
# 运行期扩缩容走 --join / promote / remove-node方式二：bootstrap + join（动态扩容）
defing --node-id 1 --bootstrap --http-addr 127.0.0.1:8384 --raft-addr 127.0.0.1:8385 --data-dir ./n1 --admin-password admin123 --allow-no-master-key --join-token demo --raft-token demo
defing --node-id 2 --join http://127.0.0.1:8384 --http-addr 127.0.0.1:8386 --raft-addr 127.0.0.1:8387 --data-dir ./n2 --admin-password admin123 --allow-no-master-key --join-token demo --raft-token demo
defing --node-id 3 --join http://127.0.0.1:8384 --http-addr 127.0.0.1:8388 --raft-addr 127.0.0.1:8389 --data-dir ./n3 --admin-password admin123 --allow-no-master-key --join-token demo --raft-token demo
# 提升为 voter：
# POST /api/v1/cluster/promote {"node_id": 2} / {"node_id": 3}（需管理员 Bearer）
# 重启自动恢复：同 data-dir 直接启动（无需 --bootstrap/--join）安全（F3）：集群模式强制要求
--join-token（join 端点鉴权）与--raft-token（raft RPC 鉴权）， 集群内所有节点须传相同值；生产环境请使用强随机值。
import { ConfigClient } from './sdk/ts/src/index.ts';
const c = new ConfigClient([{ grpc: '127.0.0.1:8383', http: 'http://127.0.0.1:8384' }]);
const snap = await c.get('my-app', 'dev'); // 读活动版本（gRPC 数据面）
c.watch('my-app', 'dev', (e) => console.log(e)); // 订阅发布事件（gRPC 流，断线 after_version 续传）
await c.listMembers(); // 集群成员（端点池刷新）Go：sdk/go（configclient.NewGrpc(addr, token) / New(endpoints) HTTP 降级）；
Python：sdk/python（ConfigClient([{'grpc': ..., 'http': ...}])）。
端点带 grpc 地址时优先走 gRPC 数据面（:8383），纯字符串端点自动降级 HTTP/SSE；
gRPC 契约测试：bash scripts/sdk-grpc-contract-test.sh（依赖：npm install、pip install grpcio、go mod tidy）。
- 集群：Raft 强一致、静态成员表建群（--bootstrap-peers，全员 voter 无需 promote）、 join/promote 动态扩容、leader 击杀容错、节点重启自动恢复
- 配置模型：项目→分支→分组→item；结构强一致（仅值按分支）
- 发布闭环：草稿 → 版本（不可变）→ 发布 → 通知；回滚；共享配置项（扁平库，含描述字段）与级联——引用关系由项目结构页的「共享引用」决定（引用项只读，值由共享库物化）
- 安全：secret 项 AES-256-GCM 信封加密（主密钥 env/文件）、多会话并存（每会话独立管理 + 草稿乐观锁防并发编辑冲突）、审计、CSP、 join/raft 集群令牌（--join-token/--raft-token 集群模式强制）、HTTP 数据面令牌（--data-plane-token）
- 多格式：YAML / TOML / JSON 渲染
- 可观测：/healthz、/readyz、/metrics（Prometheus）、审计 API
- Admin UI：内嵌 /admin（项目/配置/watch）
cd server
source ../scripts/build-env.sh # CARGO_HOME + CXXFLAGS（本机 /home 只读环境）
cargo build --workspace
cargo test --workspace # 172 测试（core/storage/raft/crypto/render/jobs/watch/api…）
# 端到端：
bash ../scripts/dev-single-demo.sh # 单节点全流程（含 watch）
bash ../scripts/cluster-demo.sh # 3 进程集群 kill 容错
bash ../scripts/chaos-test.sh # leader 击杀/重启追赶混沌
bash ../scripts/sdk-contract-test.sh # 三语言 SDK 契约
bash ../scripts/check-contracts.sh # proto/openapi/schema lint- 需求演进：docs/proposl.md → docs/proposal-v4.md
- 可行性分析：docs/feasibility-report.md
- 详细设计：docs/design-v3.md、docs/design-modules/（15 份模块规格）
- 进度记录：docs/progress.md
- 生态集成调研：docs/research-ecosystem-integration.md（综合结论 + 路线图）
Apache-2.0