Kra

Kra 是基于 Kratos 生命周期与 Wire 依赖注入、使用 Gin 提供管理端 HTTP API 的前后端管理系统。

目录

cmd/                服务入口与 Wire
configs/            运行配置
internal/biz/       领域对象、用例和仓储接口（按 system/payment/integration/task 拆分）
internal/config/    Viper 配置模型、加载和热更新
internal/data/      数据库、缓存、对象存储及仓储实现
internal/initialize/ 首次安装、配置保存和重载编排
internal/server/    Gin 服务、路由、中间件和 Handler
internal/service/   按业务模块组织的 HTTP 输入输出与领域对象转换
internal/worker/    定时任务调度与后台工作进程
web/                Vue 管理端

启动后端

先按本地环境填写 configs/config.yaml，或通过 KRA_DATA_DATABASE_* / KRA_ADMIN_JWT_SIGNING_KEY 环境变量提供敏感配置。默认模板不包含数据库口令，首次启动时如果目标数据库不可用，服务会保留初始化接口；在管理端初始化页面完成建库、建表和种子数据写入后即可登录。

go run ./cmd -conf ./configs

默认 HTTP 地址为 http://127.0.0.1:8000。生产环境必须通过受控配置提供 JWT 签名密钥和数据库凭据；不要把真实密钥提交到 Git。

配置文件发生变化时会自动刷新内存配置；管理端“重载服务”会进一步重建数据库、Redis、对象存储连接并重新载入定时任务。路由前缀和 HTTP 监听地址需要重启进程后生效。

启动前端

cd web
pnpm install
pnpm dev

构建产物和依赖目录 web/dist/、web/node_modules/ 已加入 Git 忽略规则。

生成代码

修改 Wire Provider 或构造函数后执行：

go generate ./cmd

检查

go test ./...
go vet ./...
cd web && pnpm lint && pnpm build