#Go 后端实现约定

#代码组织

• router/web：管理端接口
• router/client：客户端接口
• db：数据库连接与数据访问
• service：规则计算与业务编排
• startup：初始化与启动流程

#接口风格

• 优先保持与既有前端契约兼容
• 参数校验错误返回 400
• 资源缺失返回 404
• 服务内部异常返回 500

#数据写入策略

• 配置类写入统一使用 upsert（ON CONFLICT ... UPDATE ALL）
• 涉及多表一致性的操作（如复制配置）必须使用事务

#课表/作息相关约束

• 常日 为必选作息模板
• timetable 与 divider key 必须一致（后端自动修正）
• 不合法作息引用应回退到 常日

#调试与验证

建议在提交前执行：

go build ./...