From f16f2956d3d0f260501a356b5fe1087abdc5eaf5 Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Wed, 12 Aug 2026 16:50:00 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=20Sense=20=E9=AA=A8?= =?UTF-8?q?=E6=9E=B6=E5=85=A5=E5=8F=A3=E4=B8=8E=E9=AA=8C=E8=AF=81=20(#21)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Architecture-and-Code-Map.-.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/Architecture-and-Code-Map.-.md b/Architecture-and-Code-Map.-.md index 7db6f15..1892e3a 100644 --- a/Architecture-and-Code-Map.-.md +++ b/Architecture-and-Code-Map.-.md @@ -71,3 +71,17 @@ Sense/Brain 生成事件 - 业务预警与运维告警分开。 - Area/设备/规则在各独立产品内有自己的业务投影，不以共享数据库同步。 - 单项目工单不得顺带修改其他项目；共享契约变更必须由协调工单统筹。 + + +## Sense 代码入口与模块边界 + +- `Sense/server/main.go`：后端进程入口，调用 `cmd/sense` 启动。 +- `Sense/server/cmd/sense/root.go`：配置、数据库、迁移、模块注册和优雅退出编排；后续功能通过独立 `modules_.go` 注册，不反复修改共享入口。 +- `Sense/server/internal/platform/`：PostgreSQL、迁移、HTTP/JSON、健康检查与静态资源宿主。 +- `Sense/ui/src/bootstrap/`：Vue、路由、Vuex、请求封装和功能模块自动发现。 +- `Sense/ui/src/layout/AppLayout.vue`：基于 go-admin-ui 交互约定的侧栏、顶部导航、标签栏和页面容器。 +- `Sense/config/`：无秘密配置模板；真实数据库 URL 和后续签名密钥只能由仓库外环境提供。 +- `Sense/scripts/bootstrap/`：精确工具链检查和无需 Brain/Bell 的内存模式 smoke。 + +默认只注册工作台、健康检查和系统信息；go-admin 演示与代码生成菜单、路由和后端接口均未注册。正式启动默认要求独立 PostgreSQL；`memory` 只用于自动化测试和本地 smoke。 +