new-model

根据 $ARGUMENTS 从 DDL 文档生成 GORM Model 文件。

公共步骤模板见 skills-spec/01_skill_authoring_guide.md §A-§E。本 Skill 特定内容如下。

第 0 步：拒绝规则与依赖前置

• ⛔ 拒绝（§A.1）：表名属于 BUILD_STATUS.md §0 的 🚫 模块时立即拒绝
• 状态检查（§A.2）：读 BUILD_STATUS.md §3 模型层明细
• 依赖（§A.3）：目标包目录（models/db_xxx/）不存在则先创建

第 1 步：读取 DDL（公共必读见 §B）

• 主文档：docs/schema/database_design.md
• 如参数为 all，提取所有表 DDL；否则定位到指定表
• 确认表所属库（§1 表清单 / §2 分库设计）

第 2 步：确定文件路径与类型映射

数据库	Go 包	目录
db_xxx_core	db_xxx_core	models/db_xxx_core/
db_xxx_trade	db_xxx_trade	models/db_xxx_trade/
db_xxx_log	db_xxx_log	models/db_xxx_log/
db_xxx_call_log	db_xxx_call_log	models/db_xxx_call_log/

类型映射：

• bigint unsigned NOT NULL AUTO_INCREMENT → uint64
• varchar(N) NOT NULL → string；可空 → *string
• tinyint NOT NULL → int8；可空 → *int8
• int NOT NULL → int；bigint NOT NULL → int64
• decimal NOT NULL → float64
• datetime NOT NULL → time.Time
• date NOT NULL → string（YYYY-MM-DD）

第 3 步：生成 struct

package {db_package}

import "time"

type {StructName} struct {
    ID        uint64    `gorm:"column:id;primaryKey" json:"id"`
    Field1    string    `gorm:"column:field_1;type:varchar(32);not null;default:''" json:"field_1"`
    Status    int8      `gorm:"column:status;not null;default:0" json:"status"`
    Deleted   int8      `gorm:"column:deleted;not null;default:0" json:"deleted"`
    CreatedAt time.Time `gorm:"column:created_at;not null" json:"created_at"`
    UpdatedAt time.Time `gorm:"column:updated_at;not null" json:"updated_at"`
}

func ({StructName}) TableName() string {
    return "{table_name}"
}

按月分片表需额外 ShardTableName：

func ShardTableName(t time.Time) string {
    return fmt.Sprintf("{table}_%s", t.Format("200601"))
}

GORM tag 规则：必含 column:{snake}；主键 primaryKey；varchar/decimal/text 加 type:{完整类型}；NOT NULL → not null；DEFAULT → default:{值}；敏感字段（凡含密钥 / 哈希 / token 类——落地按业务字段名补充）json:"-"。

第 4 步：已有文件处理 + 文档同步（公共项见 §C）