8. 附录与历史
附录与历史
本章保留版本背景、历史设计记录和需要特别说明的兼容信息。历史文章不等同于当前保证；实施或运维决策必须以 v2.22.3 代码、测试和前文配置/API 说明为准。
历史 ADR
该记录源自一次短码生成算法调整。原文章中的部分数学结论过强，本次整理保留问题背景和设计意图，同时明确当前实现仍需测试覆盖的边界。
版本兼容摘要
- 配置使用
HTTP_*、DATABASE_DBNAME、CACHE_DRIVER=memory|redis、ID_GENERATOR_DRIVER=local|redis。 - 数据库结构由 Goose 管理，早期 AutoMigrate 数据库会建立有限的历史基线。
- 控制器通过 go-web 的
RouterContextInterface工作，不再以*gin.Context作为公共签名。 - 前端是
admin-webui子模块，生产资源在后端编译时嵌入。 - 本项目使用自定义软件授权协议，不应描述为标准开源许可证。
术语
| 术语 | 含义 |
|---|---|
| 短码 | 域名下唯一的 URL 路径段 |
| 发号器 | 为域名分配递增 ID 的 local/Redis 服务 |
| 工作区 | 业务资源和成员权限的隔离边界 |
| Campaign | 单选的营销活动归因实体 |
| Tag | 可多选的分类标签 |
| 反馈 Token | A/B 跳转签发的转化上下文，不是 API Token |
| ADR | 架构决策记录，描述当时背景、选择与后续复核 |