diff --git a/docs/task/21-Sense独立GoAdmin产品骨架.md b/docs/task/21-Sense独立GoAdmin产品骨架.md new file mode 100644 index 0000000..2eeb646 --- /dev/null +++ b/docs/task/21-Sense独立GoAdmin产品骨架.md @@ -0,0 +1,72 @@ + +generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件) +wiki_page: Task-21-Sense独立GoAdmin产品骨架 +wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Task-21-Sense%E7%8B%AC%E7%AB%8BGoAdmin%E4%BA%A7%E5%93%81%E9%AA%A8%E6%9E%B6.- +wiki_revision: 3213d5f0fde9fdffd39602f5a7a7236d68ffec89 +synchronized_at: 2026-08-12T08:55:33Z + + +# 21 Sense 独立 GoAdmin 产品骨架 + +- 类型:需求 +- 所属 Epic:#7 +- 所属 MVP / 版本:#8 +- 状态:待验收 +- 日期:2026-08-12 +- Gitea 工单:https://git.ilapage.cn/ila/yovision/issues/21 +- Wiki 页面:Task-21-Sense独立GoAdmin产品骨架 +- Wiki revision:见本地镜像头 + +## 背景与目标 + +从已验收的冻结 GoAdmin 基线初始化 Sense 自有 Go 后端、Vue 管理端、PostgreSQL 配置和模块注册边界,使产品在 Brain、Bell 未启动时独立构建、运行和测试。 + +## 最终方案 + +1. 后端使用 Go 1.26.5、`net/http` 与 pgx PostgreSQL 驱动,提供配置校验、迁移注册、健康/就绪检查、模块扩展点和优雅退出。 +2. 正式/default 模式必须提供仓库外 `SENSE_DATABASE_URL`;`memory` 仅供自动测试和 smoke。 +3. 前端使用冻结的 Vue 3、Element Plus、Vue Router、Vuex 和 Vue CLI,复用 go-admin-ui 的侧栏、顶部导航、标签栏、页面容器与反馈模式。 +4. UI 只显示 Sense 工作台;go-admin 演示、代码生成和无关管理菜单/路由/API 均未注册。 +5. 后续业务功能通过独立后端注册文件及前端自动发现的 route/store module 接入,避免反复修改共享入口。 +6. 保留 go-admin、go-admin-ui MIT 许可证与完整来源 commit;本机参考仓库保持未修改。 + +实施期间增加 `Sense/ui/.gitignore` 精确 write path,用于排除 pnpm/Vue CLI 构建产物;不改变功能和验收结果。 + +## 修改文件 + +- `Sense/server/`:进程入口、配置、PostgreSQL、迁移、HTTP 平台和测试。 +- `Sense/ui/`:Vue/Element Plus 应用外壳、模块发现、请求封装和锁文件。 +- `Sense/config/`:无秘密配置模板。 +- `Sense/scripts/bootstrap/`:工具链检查与独立 smoke。 +- `Sense/LICENSES/`:上游许可证及来源记录。 +- `Sense/README.md`:构建、启动和验证入口。 +- Wiki `Project-Profile`、`Architecture-and-Code-Map`、`Local-Development-and-Verification` 及镜像。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 冻结版本、许可证和来源可追溯且未修改参考仓库 | 通过 | +| Go 后端与 Vue 管理端可构建 | 通过 | +| 默认 UI/后端无演示和无关模块入口 | 通过 | +| 配置与仓库无默认密码、签名密钥或摄像头凭据 | 通过 | +| Brain、Bell 未启动时独立 smoke | 通过 | +| 独立 PostgreSQL 实例连接 | 待部署环境验证 | + +## 测试 + +- Go 1.26.5 `go test ./...`:通过。 +- Go 1.26.5 `go build ./...`:通过。 +- `corepack pnpm@9.15.1 install --frozen-lockfile`:通过。 +- `corepack pnpm@9.15.1 lint --quiet`:通过。 +- `corepack pnpm@9.15.1 build`:通过;仅有 Element Plus vendor bundle 体积建议警告。 +- `Sense/scripts/bootstrap/check-toolchain.ps1`:通过。 +- `Sense/scripts/bootstrap/smoke.ps1`:通过,含健康、就绪和禁用 demo 路由检查。 +- `python dev_scripts/check_harness.py --strict`:通过。 +- `git diff --check`:通过。 +- **未验证部分**:当前机器没有 PostgreSQL 客户端、Docker 或获准测试实例,未执行真实 PostgreSQL 连接;真实部署时必须验证。浏览器人工视觉验收留给用户,自动化构建已通过。 + +## 相关提交 + +- `d216999` feat: initialize independent Sense product skeleton (#21) +- `2e22252` docs: document Sense product skeleton (#21) diff --git a/wiki-docs.json b/wiki-docs.json index b62855a..78aea2c 100644 --- a/wiki-docs.json +++ b/wiki-docs.json @@ -83,6 +83,10 @@ { "page": "Task-5-冻结Sense与Bell-GoAdmin技术基线", "path": "docs/task/5-冻结Sense与Bell-GoAdmin技术基线.md" + }, + { + "page": "Task-21-Sense独立GoAdmin产品骨架", + "path": "docs/task/21-Sense独立GoAdmin产品骨架.md" } ] }