快速开始
这篇指南帮助你运行仓库内的示例应用。先从维护者取得 0.7 开发基线源码，确认根目录包含 server、web、starter、go.work 和 pnpm-workspace.yaml。
| 工具 | 核心开发基线 |
|---|---|
| Go | 1.26.5，由 go.mod 的 toolchain 指定 |
| Node.js | 24 或更高版本 |
| pnpm | 10.30.3 |
| PostgreSQL / Redis | 使用核心仓库的 Docker Compose 配置 |
1. 启动基础服务
Section titled “1. 启动基础服务”在核心源码仓库根目录运行：
docker compose up -d检查本机数据库与 Redis 端口是否与仓库配置一致。
2. 初始化后端
Section titled “2. 初始化后端”cd starter/servercp .env.example .env按本机环境填写 .env 中的数据库与 Redis 连接，然后生成密钥、执行迁移和种子：
go run . artisan key:generatego run . artisan jwt:secretgo run . artisan migratego run . artisan db:seedgo run .后端默认监听 http://127.0.0.1:3000。队列与定时任务随主进程运行。
3. 启动前端
Section titled “3. 启动前端”另开终端，在核心仓库根目录运行：
pnpm install --frozen-lockfilepnpm --filter @modu/web buildpnpm dev打开 http://localhost:8000，使用本地种子账号登录：
- 邮箱：
admin@gorave.local - 密码：
Admin@123
这个账号用于本地开发。前端开发代理将 /api 请求转发到后端。
4. 确认运行结果
Section titled “4. 确认运行结果”登录后检查菜单与个人资料，打开商品管理并新增一条本地测试记录。修改前端核心后，重新运行 pnpm --filter @modu/web build。
若页面或目录与本指南不同，先检查源码版本，再检查环境配置与构建日志。