chore: 初始化 workbuddy.xpcool.com 工作空间仓库（统一规则+项目索引+日志，相对路径布局）

2026-08-26 19:04:11 +08:00 · 2026-08-26 19:04:11 +08:00 · dfc7a354ad
commit dfc7a354ad
3 changed files with 121 additions and 0 deletions
--- a/.workbuddy/memory/2026-08-26.md
+++ b/.workbuddy/memory/2026-08-26.md
@ -0,0 +1,16 @@
+# 2026-08-26
+
+- CFG | 工作空间迁移：从 C:\Users\ybtdevxxl\WorkBuddy\xpcool.com 迁至 E:\xxcool\project\workbuddy.xpcool.com（git 管理），索引改相对路径约定，布局为「项目与工作空间同级」。
+- CHG | 建立 xpcool.com 工作空间统一规则与项目索引架构（见 MEMORY.md）。
+- CHG | service.xpcool.com 全量规范化：遗留 /v1 URL 移除、全部接口改 POST（CRUD 改动作式路径）、DB 权限映射同步、全项目英文注释转中文（含 CLI 生成模板）；路由回归 29 条全 POST 一致。
+- CHG | 统一 API 前缀 /api/service/（admin/user/open 三端）+ 服务端口 10100（dev/prod/test 同步）；DB 权限映射与前端 vite 代理/api 文件同步适配；全链路 curl 回归通过。
+- CFG | 在 admin/service/tool.xpcool.com 的 .workbuddy/memory/ 下初始化 CHANGELOG.md，落实"变更在各自项目记录"。
+- 规则要点：中文注释、每次变更做记录、中文优先输出；记录倒序 + 类型标签，省 token 且快速命中。
+- CHG | 将三铁律同步进 admin/service/tool 三个项目的 AGENTS.md（新增「统一工作约定」小节，指向中央 MEMORY.md 与各项目 CHANGELOG.md）。
+- REQ/CHG | 设计并联调后台登录接口：核查 service(GoFrame) 与 admin(Vben) 登录链路，确认路由/响应/代理已对齐；补全 admin 端 Refresh/Logout 端点（service CHANGELOG 有记）；待用户提供 MySQL DSN+JWT_SECRET 后执行迁移+种子+起服务+curl 全链路联调。
+- CHG | service.xpcool.com 目录重构：API 层资源目录化 + service 层严格镜像 API 多级结构（internal/service/admin/system/auth/auth.go 式），路由回归一致；期间发现 api/hello、common/tools 意外处于 git 删除状态，已从 HEAD 恢复（非重构所致）。
+- CHG | 用户确认模板删除：api/hello、api/open、common/tools、controller/hello、controller/open 全删；API 目录去掉 v1 层（api/admin/system/auth/auth.go 式），URL 前缀保持 /admin/v1。
+- CFG | service.xpcool.com 新建 .env.dev（DB_DSN mysql:root:root123@.../service_xpcool_com + JWT_SECRET），.gitignore 加 .env*。
+- REQ | 后台登录接口联调完成：login→info→codes→menu/routes→RBAC→refresh(单次)→logout 全通；修复 admin refresh 单次使用漏洞（RowsAffected 校验）。
+- CHG | login 资源归位 admin/admin/login（包名 admin_admin_login 下划线拼接式）；恢复 api/open 并规范化（去 v1）；前端依赖由用户自行处理。
+- CHG | 区分系统日志与服务器日志：审计服务归位 admin/system/log（package admin_system_log）+ 新增 GET /admin/v1/system/log 查询；修复审计 JSON 列落库失败。
--- a/.workbuddy/memory/MEMORY.md
+++ b/.workbuddy/memory/MEMORY.md
@ -0,0 +1,44 @@
+# xpcool.com 工作空间 · 统一规则与项目索引
+
+> 本文件随会话自动加载。保持精简：只放规则与索引，详细历史在各项目 CHANGELOG。
+
+## 三条铁律（全项目通用）
+1. 中文注释：写/改代码时，在应有处（函数、复杂逻辑、配置项、非显然分支）加中文注释。
+2. 做记录：每次请求/变更/修复/文档动作，都在对应项目 CHANGELOG.md 顶部追加一条。
+3. 中文优先：与用户的思考、输出、交流，能中文尽量中文。
+
+## 工作空间说明（git 管理 · 跨设备同步）
+- 本工作空间仓库：`workbuddy.xpcool.com`（含本规则、每日日志、README），远程：`https://git.xpcool.com/xpcool/workbuddy.xpcool.com.git`
+- **布局约定（跨设备必须一致）**：所有项目与工作空间仓库位于同一父目录下：
+  ```
+  <父目录>/
+  ├── workbuddy.xpcool.com/   ← 本工作空间（规则+索引+日志）
+  ├── admin.xpcool.com/
+  ├── service.xpcool.com/
+  └── tool.xpcool.com/
+  ```
+  换设备时按此布局 clone，索引即全部生效，无需改任何路径。
+
+## 项目索引（变更记录在各项目 .workbuddy/memory/CHANGELOG.md）
+| 项目 | 类型 | 相对路径（相对本工作空间） | 远程仓库 |
+|------|------|--------------------------|---------|
+| admin.xpcool.com | Vue 管理后台前端 | ../admin.xpcool.com/.workbuddy/memory/CHANGELOG.md | https://git.xpcool.com/xpcool/admin.xpcool.com.git |
+| service.xpcool.com | Go 后端服务 | ../service.xpcool.com/.workbuddy/memory/CHANGELOG.md | https://git.xpcool.com/xpcool/service.xpcool.com.git |
+| tool.xpcool.com | 前端工具站 | ../tool.xpcool.com/.workbuddy/memory/CHANGELOG.md | https://git.xpcool.com/xpcool/tool.xpcool.com.git |
+（新增项目：在此加一行 + 在其 .workbuddy/memory/ 建 CHANGELOG.md + git.xpcool.com 建仓库）
+
+## 记录格式（省 token · 快速命中）
+- 倒序：最新在上，一行一条
+- 模板：`YYYY-MM-DD | 类型 | 一句话摘要`
+- 类型：REQ 请求 / CHG 变更 / FIX 修复 / DOC 文档 / CFG 配置 / DEP 依赖
+- 示例：`2026-08-26 | CHG | 新增用户列表分页接口并补中文注释`
+
+## 命中流程
+1. 判断是否涉及某项目（看项目名/路径）。
+2. 读该项目 CHANGELOG.md 头部（最新 10–15 条）了解近况。
+3. 处理后于 CHANGELOG 顶部追加本次记录。
+4. 新增项目时同步更新上方索引表。
+
+## 日常同步习惯（建议）
+- 每次工作结束：在各改动项目 `git add + commit + push`，本工作空间同样提交（规则/日志变化时）。
+- 换设备开工前：先 `git pull` 各仓库，保证规则与记录最新。
--- a/README.md
+++ b/README.md
@ -0,0 +1,61 @@
+# workbuddy.xpcool.com 工作空间仓库
+
+xpcool.com 系列项目的**中央工作空间**：统一规则、项目索引与每日日志，用 git 管理以便跨设备同步。
+
+## 这是什么
+
+本仓库不是业务代码，而是 WorkBuddy 工作空间的"大脑"——每次会话自动加载的规则与项目索引都在这：
+
+```
+workbuddy.xpcool.com/
+├── README.md                    ← 本文件
+└── .workbuddy/memory/
+    ├── MEMORY.md                ← 三条铁律 + 项目索引（相对路径）
+    └── YYYY-MM-DD.md            ← 中央每日日志（按天累积）
+```
+
+业务代码在各项目自己的仓库（admin / service / tool.xpcool.com），本仓库只负责**规则与记录**。
+
+## 布局约定（跨设备必须一致）
+
+所有项目与工作空间仓库位于**同一父目录**下：
+
+```
+<父目录>/
+├── workbuddy.xpcool.com/   ← 本仓库
+├── admin.xpcool.com/
+├── service.xpcool.com/
+└── tool.xpcool.com/
+```
+
+换设备 clone 时按此布局摆放，`MEMORY.md` 里的相对路径索引（`../admin.xpcool.com/...`）即可全部生效。
+
+## 跨设备使用流程
+
+**首次在新设备部署：**
+```bash
+# 1. 建父目录并 clone 各仓库（保持同级布局）
+mkdir xpcool && cd xpcool
+git clone https://git.xpcool.com/xpcool/workbuddy.xpcool.com.git
+git clone https://git.xpcool.com/xpcool/admin.xpcool.com.git
+git clone https://git.xpcool.com/xpcool/service.xpcool.com.git
+git clone https://git.xpcool.com/xpcool/tool.xpcool.com.git
+```
+
+**日常同步（每次工作结束）：**
+```bash
+# 各项目 + 本工作空间分别提交推送
+cd <项目> && git add -A && git commit -m "..." && git push
+cd ../workbuddy.xpcool.com && git add -A && git commit -m "..." && git push
+```
+
+**换设备开工前：**
+```bash
+cd xpcool && for d in */; do (cd "$d" && git pull); done
+```
+
+## 新增项目
+
+1. 在 `git.xpcool.com` 建仓库 `xxx.xpcool.com`
+2. 在 `MEMORY.md` 索引表加一行（相对路径 + 远程地址）
+3. 在其 `.workbuddy/memory/` 建 `CHANGELOG.md`