xpcool/service.xpcool.com

Go to file

xpcool-bot 364d9feeb1 Some checks failed Build and Deploy (service.xpcool.com) / build-and-deploy (push) Failing after 0s Details ci: trigger first deploy		2026-08-25 00:02:07 +08:00
.gitea/workflows	ci: trigger first deploy	2026-08-25 00:02:07 +08:00
api	feat(dev): 项目初始化。	2026-07-17 17:58:08 +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(dev): 项目初始化。	2026-07-17 17:58:08 +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(dev): 项目初始化。	2026-07-17 17:58:08 +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.