Lyra
链接、分类、设置等资源的后端服务（规划中）。目标结构与技术选型见 docs/architecture.md。
当前状态
已搭建目录骨架与程序入口 main.go，各内部目录的职责与依赖约束记录在 AGENTS.md 中。
internal/api/response.go 定义公共响应结构；仅含 AGENTS.md 的目录暂不构成 Go 包。
业务逻辑、数据库访问、HTTP API 与迁移文件均未实现；架构文档中标注示例的
文件（links 等）尚未创建。当前运行程序后直接退出——不连接数据库，
也不启动 HTTP 服务。
目录职责
| 路径 | 职责 |
|---|---|
cmd/lyra/ |
程序入口：启动、依赖组装、退出清理（待实现） |
internal/api/ |
HTTP 请求/响应 DTO，按资源分文件 |
internal/config/ |
配置定义与加载 |
internal/postgres/ |
PostgreSQL 连接（pgx stdlib） |
internal/router/ |
路由注册、项目路径前缀 |
internal/handler/ |
参数绑定、DTO 转换、响应输出 |
internal/service/ |
业务规则、事务协调 |
internal/model/ |
数据结构定义与数据访问（SQL） |
internal/httpx/ |
公共响应辅助，按需实现 |
migrations/ |
Goose SQL 迁移文件（暂无） |
docs/ |
架构与计划文档 |
运行
Go 命令在本目录（module 根）下执行：
go run ./cmd/lyra # 当前直接退出，不连接数据库、不启动 HTTP
go test ./... # 当前无测试文件，仅验证各包可编译
技术栈
已引入 Gin 与 Viper（读取 TOML 配置），go.sum 已生成； PostgreSQL、Squirrel + sqlx（pgx stdlib 驱动）与 Goose 为目标选型，随后续功能引入。