用途:在 laneweaverTMS 的 Go/Echo/pgx 后端中实现新 API 端点、业务逻辑、数据库查询、模型与 DTO、事务、复杂筛选与校验,并编写 OpenAPI 3.0/Swagger 注解。
主要能力:采用分层架构 HTTP 请求→Handler→Service→Repository→PostgreSQL。Handler(/internal/handlers/)负责 Echo 上下文、绑定 JSON、返回 APIResponse;Service(/internal/services/)负责业务逻辑、校验与编排;Repository(/internal/repository/)负责 SQL、pgx 操作与事务;Models(/internal/models/)用 db/json 标签定义结构体、枚举与请求响应 DTO。包含依赖注入式 Handler 构造、创建/列表/按 ID 查询处理器、查询参数解析与空指针安全转换、分页响应、校验错误与操作错误分别映射 400/500、唯一约束冲突重试、事务提交回滚、pgx.ErrNoRows 处理、QueryBuilder 构造 IN/日期/布尔/文本搜索条件与排序白名单、Find-or-Create 模式、带 db/json 标签的实体与校验枚举(如 LoadStatus、ModeOfTransport)等示例。
使用方式:将技能描述作为编码约定,按对应层放置代码,遵循标签命名(db 用 snake_case、json 用 camelCase、可选字段用 omitempty),日期格式 "2006-01-02",分页默认 page=1、page_size=50(上限 100)。
适用场景:laneweaverTMS 中运输/负载相关实体的 CRUD 与查询接口开发。
限制:资料仅针对该特定 Go/Echo/pgx 项目与技术栈,未提供安装命令、依赖版本、测试方式、性能或收费信息;实际字段与表结构以项目为准,不应外推至其它框架或语言。