wangjia
36564571fa
- fix(test): 同步 listInventory 签名（补 series/spec 参数） - test(backend): 新增 import_parse_test.go - chore(backend): 新增 cmd/test_xls 调试工具 - docs: UI 筛选组件设计规范、Gemini 项目配置 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1.5 KiB
1.5 KiB
酒库管理系统 — Gemini 编码规则
项目背景
这是一个多租户酒类库存管理系统，Go 后端 + Flutter 前端。
强制规则（违反即重写）
多租户隔离
shop_id永远从middleware.GetShopID(c)获取- 绝不从 request body、URL params、query string 读取 shop_id
- 所有数据库查询必须带
WHERE shop_id = ?条件
并发安全
- 同一事务内读后写必须用
FOR UPDATE锁行：tx.Set("gorm:query_option", "FOR UPDATE").Where(...).First(&model) - 适用：单号生成、库存扣减、任何 check-then-act 模式
代码风格（参考 handler/product.go）
- Handler 函数签名：
func (h *Handler) ActionName(c *gin.Context) - 统一错误返回：
c.JSON(http.StatusBadRequest, gin.H{"error": "..."}) - 成功返回：
c.JSON(http.StatusOK, result) - 所有 DB 操作通过
h.db，不直接引用全局变量
Schema 管理
- 表结构变更同步修改
backend/schema/schema.sql - 无单独迁移文件，启动时 AutoMigrate
- 不为单个字段加新列，用
custom_fields JSON扩展
测试规范
- 测试文件放在同包下：
xxx_test.go - 使用
testutil/下的辅助函数 - 每个 handler 至少覆盖：正常路径 + 缺少 shop_id 的 403 场景
参考文件
- Handler 模式：
backend/internal/handler/product.go - Model 模式：
backend/internal/model/product.go - 认证中间件：
backend/internal/middleware/auth.go - Schema：
backend/schema/schema.sql