First Run

This section will guide you through starting the backend and frontend for the first time without Docker, and calling protected APIs using a Token.

1) Start Backend

cargo run

If startup fails, check:

• Whether config/development.yaml exists and database configuration is correct
• Whether the database is connected properly and initial data has been imported
• Whether there are any unhandled error logs
• If Redis cache is configured, ensure the Redis service is running

2) Start Frontend and Login

pnpm dev
# Open browser and visit:
# http://127.0.0.1:4000
# Login with admin / 123456 (change default password immediately after going live)

3) Next Steps

• Change the default admin password and create a "normal role + user"
• Experience RBAC configuration in "System Management → Menu/Role/User"
• Test data permissions (Self Only, This Department, This Department & Sub-departments, etc.)

Common Issues

• Login failure:
  • Check if the admin user exists in the database
  • Check if the password hash algorithm (argon2) is consistent
• 401 Unauthorized: Verify the request header Authorization: Bearer <access_token>
• 403 Forbidden: Assign the user a role containing the corresponding permission_code