Roles Definition - martinmendozadev/StateForce GitHub Wiki
🔐 Roles Definition
This page describes the different user roles available in StateForce and their responsibilities. Roles are designed to support a hierarchical structure commonly used in emergency operations centers, ensuring secure and efficient access to system functionality.
👥 Available Roles
1. Administrator
- Full System Access: Can access all features and settings across the platform.
- User Management: Add, remove, and update users, roles, and permissions.
- System Configuration: Manage global system settings, agency profiles, and integrations.
- Audit Logs: View activity logs and system metrics for compliance and maintenance.
- Reports: Generate detailed system-wide reports and statistics.
- Resource Management: Can oversee resource allocation and approve operator assignments.
2. Operator
- Incident Management: Create, update, and close emergency incidents.
- Resource Allocation: Assign resources such as ambulances, fire brigades, and rescue units.
- Real-time Operations: Track live resource locations and statuses on dashboards.
- Personnel Management: Manage on-duty personnel schedules and availability.
- Role Limitations: Cannot modify system configurations, manage users, or access sensitive audit logs.
3. Supervisor
- Operational Oversight: Monitor operator activity and ensure effective resource distribution.
- Incident Monitoring: Track live updates and statuses of emergency incidents.
- Reports & Statistics: Generate operational and historical reports for analysis.
- Resource Approval: Approve or reject resource reassignment requests made by operators.
- Role Limitations: Cannot modify user roles, system settings, or directly assign resources.
4. Guest
- Read-Only Access: View selected public dashboards and shared reports.
- External Collaboration: Intended for auditors, temporary users, or partner institutions.
- Role Limitations: Cannot interact with or modify operational data or configurations.
📊 Role Matrix Overview
Action/Permission | Administrator | Operator | Supervisor | Guest |
---|---|---|---|---|
Manage users and roles | ✓ | |||
Configure system settings | ✓ | |||
View incident reports | ✓ | ✓ | ✓ | ✓ |
Create or update incidents | ✓ | ✓ | ||
Assign emergency resources | ✓ | ✓ | ||
Monitor real-time operations | ✓ | ✓ | ✓ | ✓ |
Access live geospatial data | ✓ | ✓ | ✓ | ✓ |
Generate statistics/reports | ✓ | ✓ | ||
Approve resource assignments | ✓ | ✓ | ||
View activity logs | ✓ | ✓ | ||
Access read-only dashboards | ✓ | ✓ | ✓ | ✓ |
📌 Additional Notes
- Customizable Roles: Future versions of StateForce may allow agencies to create custom roles based on their operational needs.
- Principle of Least Privilege: Permissions are restricted to ensure users only access what is necessary for their role.
- Role Assignment: Always validate the clearance level and operational scope of the user before assigning roles.
- Feedback: For recommendations or modifications to role definitions, contact a system administrator or the project lead.
This detailed breakdown ensures clarity and structure in role-based access control, empowering agencies to operate efficiently and securely.