feat(lyra): 接入 PostgreSQL 与 Goose 迁移

- 使用 pgx/sqlx 建立连接，从环境变量读取数据库密码
- 添加本地 PostgreSQL Compose 配置与初始迁移
- 补充 Goose 操作手册和连接串排错说明

go/projects/lyra/docs/architecture.md

@@ -7,7 +7,7 @@
 ## 已确认技术栈
 
 - 已引入：Gin v1.12.0（HTTP 路由）、Viper v1.21.0（配置读取，TOML）。`go.sum` 已由 Go 工具生成。
-- 目标选型（选型已确认，尚未作为代码依赖引入）：PostgreSQL、Squirrel + sqlx（pgx stdlib 驱动）、Goose（数据库迁移）。
+- 目标选型（选型已确认，尚未作为代码依赖引入）：PostgreSQL、Squirrel + sqlx（pgx stdlib 驱动）、Goose（数据库迁移；迁移 SQL 已就位，以独立 goose CLI v3.29.0 执行，Go 依赖未引入）。
 
 ## 当前进度
 
@@ -16,7 +16,8 @@
 - 已注册 `GET /hello`：`internal/router/router.go` 的 `RegisterRoutes` 将其指向 `handler.Hello`，经 `httpx.OK` 输出 `api.Response`；路由注册配有 httptest 回归测试，不监听实际端口、不连接数据库。
 - 已定义公共响应契约：`api.Response`（success/data/error）、`api.ErrorInfo`（code/message/debug）与错误码类型 `api.ErrorCode` 及其默认文案 `Message()`。
 - 已实现响应输出辅助 `httpx.OK`、`httpx.Fail`。
-- 尚未实现：真实业务逻辑（`/hello` 只是 HTTP 通路示例）、数据库访问与迁移 SQL；配置校验、环境变量覆盖与默认值；`ErrorInfo.Debug` 的填充与按环境开关。日志方案未定。
+- 数据库迁移已就位：`migrations/00001_init.sql`（`set_updated_at()` 函数、users/categories/links 三张表、约束、注释、索引与触发器，建库内容与 [demo.sql](demo.sql) 一致），由手工 goose CLI（v3.29.0）执行，见 [../migrations/README.md](../migrations/README.md)。
+- 尚未实现：真实业务逻辑（`/hello` 只是 HTTP 通路示例）、Go 应用侧数据库访问与 Goose Go 依赖；配置校验、环境变量覆盖与默认值；`ErrorInfo.Debug` 的填充与按环境开关。日志方案未定。
 
 ## 目录结构
 
@@ -52,7 +53,7 @@ lyra/
 │       └── response.go               # 公共响应输出辅助（OK/Fail）
 ├── etc/
 │   └── lyra.toml                     # 运行配置（App/HTTP）
-├── migrations/                       # Goose SQL 迁移文件（暂无迁移，仅 README）
+├── migrations/                       # Goose SQL 迁移文件（00001_init.sql 初始迁移 + README）
 ├── docs/
 │   ├── plans/
 │   └── architecture.md               # 本文
@@ -62,7 +63,7 @@ lyra/
 ```
 
 - 标注“待新增”的文件只是职责分布示例，随实现按需新增，不预建空文件或空目录；`internal/` 各目录均以 `AGENTS.md` 记录职责与依赖约束。
-- model 下的 `link*.go` 展示一个资源在各层的文件分布；分类、设置等资源按同样方式在 api/handler/service/model 新增对应文件。具体迁移文件名随首个迁移确定。
+- model 下的 `link*.go` 展示一个资源在各层的文件分布；分类、设置等资源按同样方式在 api/handler/service/model 新增对应文件。首个迁移已落地为 `migrations/00001_init.sql`。
 - `handler/polaris/`、`service/polaris/` 仅示意业务分包的形态：实际分包与否随业务边界明确时决定，路由、api、model 不照搬同样的分包。
 
 ## 组织原则
@@ -92,6 +93,6 @@ lyra/
 - 配置校验、环境变量覆盖与默认值：尚未实现（当前无任何校验、覆盖或默认值）。
 - `ErrorInfo.Debug` 的填充与按环境（dev）开关：尚未实现，目前仅有字段。
 - 分页响应约定（如 data/meta 结构）与统一错误处理中间件：尚未引入，仅为历史讨论。
-- Goose 的部署执行入口与并发控制（串行执行或数据库锁）方案。
+- Goose 迁移的部署执行入口已确定为手工 CLI（见 [../migrations/README.md](../migrations/README.md)），并发控制以“单操作者串行执行”为约定，数据库锁未引入，服务启动不自动迁移。
 - PostgreSQL 按项目划分 schema 的做法（组织边界，不等于权限隔离）。
 - 日志方案（候选标准库 slog）与中间件集成方式。