脚本、模板、文档和 SDK 一起发版
- 每个公开文件都应该能追溯版本。
- 升级模板要和初始化脚本一起治理。
- 接入规范变更要同步反映到公开文档。
- 客户升级必须可解释、可回退、可追踪。
Release Track
Published Files
https://ziin.shenliu.cc/sql/ziin-agent.mysql.v1.sql
https://ziin.shenliu.cc/sql/ziin-agent.mysql.seed.v1.sql
https://ziin.shenliu.cc/sql/ziin-agent.postgres.v1.sql
https://ziin.shenliu.cc/templates/ziin-menu-mapping-template.csv
https://ziin.shenliu.cc/docs/ziin-customer-onboarding-checklist.v1.md
https://ziin.shenliu.cc/docs/ziin-api-integration-standard.v1.md
https://ziin.shenliu.cc/docs/ziin-sqlite-to-postgres-migration.v1.md
https://ziin.shenliu.cc/docs/ziin-sqlite-to-mysql-migration.v1.md
https://ziin.shenliu.cc/docs/ziin-pc-voice-integration.v1.md
https://ziin.shenliu.cc/sdk/js/ziin-sdk-js-latest.tgz
https://ziin.shenliu.cc/sdk/js/metadata.json
Governance Rule
数据库脚本、迁移模板、接入模板和实施文档都应当有明确版本,而不是口头说“你用最新的就行”。
只有版本信息透明,实施和客户才能知道这次升级改了什么、影响什么、是否需要调整现有适配器。