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

This commit is contained in:
夏犀麟 2026-08-26 19:04:11 +08:00
commit dfc7a354ad
3 changed files with 121 additions and 0 deletions

View File

@ -0,0 +1,16 @@
# 2026-08-26
- CFG | 工作空间迁移:从 C:\Users\ybtdevxxl\WorkBuddy\xpcool.com 迁至 E:\xxcool\project\workbuddy.xpcool.comgit 管理),索引改相对路径约定,布局为「项目与工作空间同级」。
- CHG | 建立 xpcool.com 工作空间统一规则与项目索引架构(见 MEMORY.md
- CHG | service.xpcool.com 全量规范化:遗留 /v1 URL 移除、全部接口改 POSTCRUD 改动作式路径、DB 权限映射同步、全项目英文注释转中文(含 CLI 生成模板);路由回归 29 条全 POST 一致。
- CHG | 统一 API 前缀 /api/service/admin/user/open 三端)+ 服务端口 10100dev/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.devDB_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/logpackage admin_system_log+ 新增 GET /admin/v1/system/log 查询;修复审计 JSON 列落库失败。

View File

@ -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 头部(最新 1015 条)了解近况。
3. 处理后于 CHANGELOG 顶部追加本次记录。
4. 新增项目时同步更新上方索引表。
## 日常同步习惯(建议)
- 每次工作结束:在各改动项目 `git add + commit + push`,本工作空间同样提交(规则/日志变化时)。
- 换设备开工前:先 `git pull` 各仓库,保证规则与记录最新。

61
README.md Normal file
View File

@ -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`