xpcool/service.xpcool.com
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
4 Commits 2 Branches 0 Tags 85 MiB
GO 100%
82b1ad2b5c
Go to file
夏犀麟 82b1ad2b5c refactor(api): 公共接口改名 open 并重构契约层为 tools/<子功能>/index.go 
- api/common/v1 → api/open/v1，路由前缀 /api/common/v1 → /api/open/v1
- 契约层按子功能拆目录：api/open/v1/tools/{uuid,md5,random,time,ip}/index.go
- 控制器同步拆文件：internal/controller/open/{uuid,md5,random,time,ip}.go
- 命名规则（open 优于 common）与 tools 目录规则记入 AGENTS.md
- 冒烟测试：旧路由 404，新路由 5 端点全部通过
2026-08-24 18:03:30 +08:00
api refactor(api): 公共接口改名 open 并重构契约层为 tools/<子功能>/index.go 2026-08-24 18:03:30 +08:00
common feat(api): 新增公共接口 api/common/v1（tools 工具端点）并修复 gtime 格式化 2026-08-24 17:29:30 +08:00
docs/change-log refactor(api): 公共接口改名 open 并重构契约层为 tools/<子功能>/index.go 2026-08-24 18:03:30 +08:00
hack feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00
internal refactor(api): 公共接口改名 open 并重构契约层为 tools/<子功能>/index.go 2026-08-24 18:03:30 +08:00
manifest feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00
resource feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00
utility feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00
.gitattributes feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00
.gitignore feat(common): 新增公共模块 common/tools 及项目上下文记忆体系 2026-08-24 17:18:10 +08:00
AGENTS.md refactor(api): 公共接口改名 open 并重构契约层为 tools/<子功能>/index.go 2026-08-24 18:03:30 +08:00
go.mod feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00
go.sum feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00
main.go feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00
Makefile feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00
PROJECT_STRUCTURE.md refactor(api): 公共接口改名 open 并重构契约层为 tools/<子功能>/index.go 2026-08-24 18:03:30 +08:00
README.MD feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00

README.MD

Personal multi-client service

Layout

api → internal/controller → internal/service → internal/dao → internal/model(entity/do) is enforced. DTO and VO live in internal/model/dto and internal/model/vo; neither API types nor entities cross that boundary.

Database model generation

Run manifest/sql/001_core.sql on MySQL, set DB_DSN, then run:

gf gen dao -p internal -g default -gt -c

The command is intentionally the only source of internal/dao, internal/model/do, and internal/model/entity.

API isolation

  • /api/v1/*: user API, terminal header/body supports mini, h5, and app.
  • /admin/v1/*: admin API. Protected endpoints require both an admin access token and an X-Permission identifier.

Use GF_GCFG_FILE=config.dev.yaml (or config.test.yaml / config.prod.yaml) and set DB_DSN plus a strong JWT_SECRET before startup.