11 lines
1011 B
Markdown
11 lines
1011 B
Markdown
# model 包
|
|
|
|
- 承载数据结构定义与数据访问：使用 Squirrel/SQL 构造查询、sqlx 执行与映射结果，驱动为 pgx stdlib。
|
|
- SQL 与查询逻辑显式写在这一层，不使用 ORM 自动持久化。
|
|
- 事务边界由 service 决定；需要同一事务时由 service 传入事务执行。这是设计目标，当前没有现成的事务接口封装。
|
|
- 查询缓存采用 cache-aside：先读缓存，命中直接返回（空列表也可命中）；未命中或缓存读取失败时回源数据库。
|
|
- 仅数据库查询成功后回填缓存；数据库失败不回填。缓存读写故障只记录日志并降级，不改变数据库查询结果。
|
|
- 缓存键使用 `internal/pkg/constant` 中的常量，遵循根 `AGENTS.md` 的 Redis 缓存键约定。
|
|
- 未来写路径应在事务提交后使相关缓存失效；当前 `cache` 包没有删除接口，失效策略属于后续设计约束。
|
|
- 使用标准 context.Context，不依赖 Gin，也不依赖 internal/api 的 DTO。
|