Go to file
夏犀麟 8d5f2c65ae feat(common): 新增公共模块 common/tools 及项目上下文记忆体系
- common/tools 工具模块,10 个子功能:md5/cryptox/uuid/random/timex/convertx/strx/slicex/ip/filex(薄封装 GoFrame 内置组件)
- AGENTS.md 项目智能体说明书(架构、规范、命令、记忆体系索引)
- docs/change-log/2026-08-24.md 本次请求与变更记录
- .gitignore 排除 .workbuddy/;PROJECT_STRUCTURE.md 补充目录树
2026-08-24 17:18:10 +08:00
api feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00
common feat(common): 新增公共模块 common/tools 及项目上下文记忆体系 2026-08-24 17:18:10 +08:00
docs/change-log feat(common): 新增公共模块 common/tools 及项目上下文记忆体系 2026-08-24 17:18:10 +08:00
hack feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00
internal feat(dev): 项目初始化。 2026-07-17 17:58:08 +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 feat(common): 新增公共模块 common/tools 及项目上下文记忆体系 2026-08-24 17:18:10 +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 feat(common): 新增公共模块 common/tools 及项目上下文记忆体系 2026-08-24 17:18:10 +08:00
README.MD feat(dev): 项目初始化。 2026-07-17 17:58:08 +08:00

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.