# 发版说明 · 数据同步（智建平台）

## 对默认客户

- **无感**：未显式开通时，不改变现有保存 / 自增表行为。  
- `local_dbsync` 为**增值开通**（客户端显式配置）；平台**不会**全员切默认。  

## 本版本智建已交付

| 能力 | 说明 |
|------|------|
| 通道校验 | UUID TEXT PK + FK 闭包；拒绝自增整数作同步键 |
| Agent API | 拉白名单、push / push batch → 线上 A |
| Binding | `local_database_id ↔ online_db_id` 登记查询 |
| LWW | 默认源端覆盖；超管审计 + 单行回滚；公司 conflicts → 403 |
| 同步修复 | 对账限流（默认 300s） |

## 管理员文档

- [数据同步-开通说明.md](./数据同步-开通说明.md)  
- [数据同步-迁移手册.md](./数据同步-迁移手册.md)（旧客迁入，禁止静默）  
- [同步表约定.md](./同步表约定.md)  
- [数据同步-中间件.md](./数据同步-中间件.md)  

## 配置（platform）

```yaml
DBSync:
  Enabled: true
  DataDir: ./data/dbsync
  LwwAuditTTLDays: 90
  ReconcileMinSec: 300
```

客户端 agent / 写网关由对接方自行落地；接口以本文档与 OpenAPI `/api/v1/meta/openapi.yaml` 为准。
