docs: archive task #21 for acceptance

This commit is contained in:
QiuSW
2026-08-12 16:55:45 +08:00
parent 2e22252feb
commit 2c0e37eff7
2 changed files with 76 additions and 0 deletions
@@ -0,0 +1,72 @@
<!-- gitea-wiki-mirror:start -->
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
<!-- gitea-wiki-mirror:end -->
# 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)
+4
View File
@@ -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"
}
]
}