首次运行

本节将在不使用 Docker 的前提下，带你完成后端与前端的首次启动，并通过 Token 调用受保护接口。

1) 启动后端

cargo run

若启动失败，请检查：

• config/development.yaml 是否存在且数据库配置正确
• 数据库是否正常连接，是否导入了初始数据
• 是否有未处理的错误日志
• 如果配置了redis缓存，需要运行redis服务

2) 启动前端并登录

pnpm dev
# 打开浏览器访问：
# http://127.0.0.1:4000
# 使用 admin / 123456 登录（上线后请立即修改默认密码）

3) 下一步建议

• 修改默认管理员密码并新建一个“普通角色 + 用户”
• 在“系统管理 → 菜单/角色/用户”中体验 RBAC 配置
• 测试数据权限（仅本人、本部门、本部门及子部门等）

常见问题

• 登录失败：
  • 检查数据库中是否存在 admin 用户
  • 检查密码哈希算法（argon2）是否一致
• 401 未授权：确认请求头 Authorization: Bearer <access_token>
• 403 禁止访问：为用户分配包含对应 permission_code 的角色