From 3213d5f0fde9fdffd39602f5a7a7236d68ffec89 Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Wed, 12 Aug 2026 16:53:51 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E6=88=90=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#21=20=E5=BE=85=E9=AA=8C=E6=94=B6=E5=BD=92=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...n%E4%BA%A7%E5%93%81%E9%AA%A8%E6%9E%B6.-.md | 56 +++++++++++++------ 1 file changed, 39 insertions(+), 17 deletions(-) diff --git a/Task-21-Sense%E7%8B%AC%E7%AB%8BGoAdmin%E4%BA%A7%E5%93%81%E9%AA%A8%E6%9E%B6.-.md b/Task-21-Sense%E7%8B%AC%E7%AB%8BGoAdmin%E4%BA%A7%E5%93%81%E9%AA%A8%E6%9E%B6.-.md index 7b359c6..f2ff914 100644 --- a/Task-21-Sense%E7%8B%AC%E7%AB%8BGoAdmin%E4%BA%A7%E5%93%81%E9%AA%A8%E6%9E%B6.-.md +++ b/Task-21-Sense%E7%8B%AC%E7%AB%8BGoAdmin%E4%BA%A7%E5%93%81%E9%AA%A8%E6%9E%B6.-.md @@ -1,9 +1,9 @@ -# 21 Sense独立GoAdmin产品骨架 +# 21 Sense 独立 GoAdmin 产品骨架 -- 类型:需求 / 缺陷 / 重构 -- 所属 Epic:# -- 所属 MVP / 版本:# -- 状态:待验收 / 已完成 +- 类型:需求 +- 所属 Epic:#7 +- 所属 MVP / 版本:#8 +- 状态:待验收 - 日期:2026-08-12 - Gitea 工单:https://git.ilapage.cn/ila/yovision/issues/21 - Wiki 页面:Task-21-Sense独立GoAdmin产品骨架 @@ -11,32 +11,54 @@ ## 背景与目标 - +从已验收的冻结 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) \ No newline at end of file