john
0da7f04878
将管理后台公网域名从 gadm 更正为 md.tkmind.cn，补充 105 nginx 反代 103 的部署说明， 默认 VITE_BASE_PATH=/ 以支持 /analytics/seo-geo 根路径访问。 Co-authored-by: Cursor <cursoragent@cursor.com>
2.5 KiB
2.5 KiB
Agent 协作说明（Codex / Cloud / Cursor / Claude / 其它 AI 工具通用）
本文件供所有在仓库内工作的 AI 编码助手阅读。仓库级开发、测试、发布规范以 ENGINEERING_WORKFLOW_RULES.md 为准；生产发布规范以 PRODUCTION_RELEASE_RULES.md 为准。
必读：分支与发布闸门
- 新建分支前必须先同步远端主线，推荐执行
bash scripts/new-branch.sh feature/xxx。 - 发布前必须重新检查当前分支是否落后
origin/main。 - 发布来源必须是干净、可追溯的 Git commit。
- 禁止从脏工作区、detached HEAD、落后主线的分支发布。
- 发布前必须执行：
bash scripts/check-release-ready.sh
仓库边界
memind_adm可以独立开发，但共享用户、权限、策略、技能、计费体系必须继续复用Memind主实现。- 发版须 Git commit，禁止本机直
rsync到103/105。 - 共享用户、计费、空间额度、策略同步相关改动必须保留业务验收记录。
必读：本仓库是唯一合法的管理后台 UI（5174）
所有平台管理后台的前端功能只能在本仓库（memind_adm）开发，本地端口 5174，生产 md.tkmind.cn。禁止在 Memind 仓库的 ops/（约 3002）新增任何管理页面、导航或 API 客户端。
| 组件 | 端口 | 职责 |
|---|---|---|
memind_adm 前端（本仓库 src/） |
5174 | 管理后台 UI：用户、计费、图片额度、策略、模型中心等 |
memind_adm API（server/） |
8085 | 挂载 /admin-api/*，复用 Memind 共享模块 |
Memind ops/ |
~3002 | Plaza 运营 + 遗留 admin；只读维护，禁止扩展 |
| Memind 后端 | 8081 / 8082 | 业务逻辑与 Portal；UI 不在此仓库 |
新增管理功能时：在本仓库添加 src/admin/pages/*、更新 AdminNav.tsx 与 App.tsx；若需新 API，在 server/app.mjs 挂载并复用 Memind 模块。Memind 侧仅实现共享业务，不在 ops/ 做 UI。
Analytics / SEO·GEO 看板
- 页面：
src/admin/pages/AnalyticsConfigPage.tsx、SeoGeoAnalyticsPage.tsx - API：
server/umami-analytics.mjs→ 105 Umamimemind-pages - 部署与环境变量：docs/analytics-deploy.md
- 跨仓库发布顺序：Memind
docs/analytics-release-runbook.md（105 Umami → 103 Portal → md.tkmind.cn） - Rybbit 已退役，勿恢复相关配置