v1.0.0

# SmokeyHub v1.0.0 — Initial Release

SmokeyHub is officially live.

This release introduces the complete first-generation Smokey State RP management ecosystem, bringing personnel management, recruitment, training, live server operations, AI-assisted tools, asset management, government systems, FiveM integration and Discord integration together under one platform.

SmokeyHub has been built around a single shared **SmokeyID**, meaning your account, department, rank, qualifications, service history and permissions follow you across the entire system.

---

# 🧑‍💼 Smokey State Operations

The new Operations system manages the complete member lifecycle across Smokey State RP.

### StaffOS

* Staff roster
* Staff profiles
* Promotions and demotions
* Staff transfers
* Staff status management
* LOA management
* Strikes and disciplinary actions
* Moderation cases
* Staff evaluations
* Staff activity
* Staff Quality Assurance
* Full audit history

### Recruitment & Interview Hub

* Department vacancies
* Custom application forms
* Application builder
* Application tracking
* Eligibility rules
* Application scoring
* Recruitment notes
* Interview scheduling
* Text interviews
* Voice interview support
* Video interview support
* Interview transcripts
* Recruitment panel cases
* Final recruitment decisions

### AI Recruitment Panels

SmokeyHub supports AI-assisted recruitment panels where the authorised human user acts as Panel Chair and the remaining panel members are independent AI advisers.

Panel roles can include:

* Recruitment Director
* Department Command Representative
* Standards & Professionalism
* Training & Development

Each AI member independently reviews the evidence, produces its own assessment and can disagree with other panel members.

The Chair can:

* Question the entire panel
* Speak directly to individual panel members
* Ask one panel member to challenge another
* Request clarification
* Ask for final votes

AI votes remain advisory. The human Chair makes the official decision.

### Training & Certification

* Course builder
* Training modules
* Lessons
* Quizzes
* Exams
* Practical assessments
* FTO sign-offs
* Training enrolment
* Qualification management
* Qualification expiry
* Renewals
* Revocations
* Digital certificates
* Public certificate verification

### Probation & FTO

* Probation profiles
* Assigned FTOs
* Probation requirements
* Ride-alongs
* Weekly reviews
* Midpoint reviews
* Final reviews
* Development actions
* Training requirements
* Pass decisions
* Probation extensions
* Fail decisions

### AI Probation Panels

Probation reviews can be considered by an AI-supported panel including:

* FTO Command
* Department Command
* Professional Standards
* Training & Development

The panel can review the member's recruitment history, training, ride-alongs, FTO reports, performance, development actions and other authorised evidence before giving independent recommendations.

### Promotion Centre

* Promotion vacancies
* Eligibility checks
* Promotion applications
* Exams
* Scenario assessments
* Interviews
* Panel review
* Promotion decisions
* Promotion history
* Automatic rank changes
* Permission recalculation
* Service history updates

### Member Development

* Mentoring
* Leadership Development Programme
* Development goals
* 360° Reviews
* Training recommendations
* Evaluation development actions
* Succession planning
* Leadership pipeline
* Staff Academy
* Coaching actions
* Development tracking

### Career & Service Management

* Department transfers
* Unit transfers
* Secondments
* Reserve / Auxiliary status
* Resignation
* Retirement
* Alumni records
* Return to Service
* Service history timeline
* Command handovers
* Internal vacancies
* Department objectives
* Quarterly reviews
* Succession planning

---

# 🎛️ Smokey State Command

Command is the live operations centre for SSRP.

### Smokey Control

The main operational dashboard provides real information from across SmokeyHub.

Includes:

* Current session
* Current AOP
* Department staffing
* Duty officers
* Session attendance
* Active incidents
* Events
* EOC status
* Resource requests
* Callouts
* Recruitment information
* Probation figures
* Training alerts
* Fleet availability
* Critical defects
* Equipment shortages
* Facility issues
* FiveM integration health
* Discord integration health
* System/API health

Live information is clearly separated between:

**Platform Data**
**Session Data**
**FiveM Live Data**

SmokeyHub will never fabricate FiveM player information when the server integration is unavailable.

### Session Operations

* Schedule sessions
* Configure AOP
* Session capacity
* Department targets
* Role reservations
* Session check-in
* Attendance tracking
* Session incentives
* Dynamic role balancing
* Session lifecycle management

### Dynamic Role Balancing

SmokeyHub analyses the actual session roster and identifies:

* Overstaffed departments
* Understaffed departments
* Critical staffing gaps
* Law Enforcement / Civilian imbalance
* Fire/EMS coverage
* Dispatch coverage

Recommendations remain advisory.

### Duty Management

* Duty Commander
* Watch Commander
* Department supervisors
* Fire command
* EMS command
* Dispatch supervision
* Specialist duty roles
* On-call rotas

### Pager & Callouts

* Specialist callouts
* SWAT
* Detectives
* Air Unit
* Fire specialist teams
* Command staff
* Custom units

Members can respond:

* Available
* Unavailable
* En Route

### Resource Request Board

Operational command can request:

* Personnel
* Vehicles
* Apparatus
* Specialist teams
* Tow
* DOT
* Air support
* Command resources
* Custom resources

### Mutual Aid

Departments can request and coordinate additional resources from other departments or future external agencies.

### Event Operations

Plan and manage:

* Major pursuits
* Wildfires
* Mass casualty incidents
* Search and rescue
* Government events
* Convoys
* Public events
* Training exercises
* Custom RP events

### Incident Management

* Active incidents
* Incident command
* Linked sessions
* Linked events
* Participating departments
* Resource requests
* Incident timelines
* Objectives
* Major incident status
* EOC links
* AAR links

### After Action Reviews

* Incident timelines
* Participating departments
* Objectives
* What went well
* Problems
* Lessons identified
* Training recommendations
* Follow-up actions

Training recommendations can automatically flow back into Operations.

### Shift Briefings & Debriefs

* AOP information
* Staffing
* Duty command
* Objectives
* Known issues
* Events
* Safety information
* Follow-up actions
* Command notes

### Emergency Operations Centre

The EOC includes:

* Activation level
* Incident commander
* Participating departments/agencies
* Situation reports
* Objectives
* Resource needs
* Unmet needs
* Decision logs
* Public information notes
* EOC staffing

---

# 🚓 Asset & Fleet Management

SmokeyHub now includes a complete asset-management ecosystem.

### Asset Registry

Manage:

* Vehicles
* Fire apparatus
* Aircraft
* Marine assets
* Equipment
* Radios
* Medical equipment
* Fire equipment
* Specialist equipment
* Uniforms
* Facilities
* Stations
* Buildings
* Custom asset types

Every asset maintains a complete history.

### Fleet Management

* Fleet numbers
* Vehicle classes
* Department ownership
* Liveries
* Callsigns
* Mileage
* Service intervals
* Inspections
* Qualification requirements
* Vehicle status
* Vehicle reservations
* Assignments

### Qualification-Based Vehicle Access

Vehicle eligibility can check:

* Department
* Rank
* Required qualifications
* Qualification expiry
* Asset status
* Reservations

This can also be queried by the FiveM integration.

### Vehicle Inspections

* Configurable inspection templates
* Pass / Fail / N/A
* Notes
* Evidence
* Critical inspection failures

Critical failures can automatically create defects and place a vehicle out of service.

### Defect Management

* Defect reporting
* Severity
* Assessment
* Assignment
* Repair
* Awaiting parts
* Inspection
* Return to service
* Full defect history

### Maintenance

* Scheduled maintenance
* Preventative maintenance
* Repairs
* Inspections
* Service history
* Maintenance due alerts

### Equipment Management

* Issue equipment
* Return equipment
* Equipment condition
* Individual serial numbers
* Assignment history
* Duplicate issue prevention

### Quartermaster

* Consumable stock
* Storage locations
* Stock transactions
* Equipment requests
* Stock transfers
* Minimum quantities
* Low-stock alerts
* Inventory health

### Facilities

* Facility directory
* Areas / rooms
* Access rules
* Department restrictions
* Rank requirements
* Qualification requirements
* Temporary access
* Visitor passes

Facility permissions are evaluated server-side and are ready for FiveM door-control integration.

### Asset Requests

Departments can submit requests for new equipment/assets.

Workflow:

Department Request
→ Command Approval
→ Government Procurement
→ Delivery
→ Asset fulfilment

---

# 🧠 Smokey State Intelligence

SmokeyHub includes a dedicated Intelligence layer powered only by configured external AI providers.

**SmokeyHub does not use Abacus AI inference for production AI features.**

Supported external AI architecture includes:

* OpenAI
* Grok / xAI
* Gemini / other configured gateway providers where supported

### AI Gateway

* Provider routing
* Model selection
* Fallback providers
* Retry handling
* Usage tracking
* Model pricing configuration
* Request logs
* Provider health
* Secure API-key storage

### AI Personas

Owners can configure:

* Persona name
* Role
* Personality
* Strictness
* Evaluation focus
* Rubric
* Allowed recommendations
* Panel assignment

Persona changes are versioned so historic panels retain the configuration used at the time.

### Prompt Management

* Prompt templates
* Prompt versioning
* Feature assignment
* Active/inactive versions
* Structured response schemas

### Malformed AI Response Recovery

AI responses pass through:

* Schema validation
* Local repair
* Provider repair request
* Revalidation
* Retry
* Graceful failure

SmokeyHub never fabricates missing AI scores or recommendations.

### Policy AI

Users can ask questions about authorised SSRP policies.

The system retrieves relevant approved documents and provides an answer using only permitted source material.

If the policy does not answer the question, SmokeyHub says so rather than inventing a rule.

### Knowledge Base AI

Search and ask questions across:

* SOPs
* Staff handbooks
* Training material
* Department documents
* Procedures
* Government documents where authorised

---

# 🎓 AI Training & Simulation

### Dispatch Training Simulator

Modes:

* Call Handler
* Dispatcher
* Combined

Features:

* Dynamic callers
* Changing information
* Resource decisions
* Priority decisions
* Communication assessment
* Final competency evaluation

### Fire / EMS Simulator

Modes:

* Fire
* EMS
* Combined

Scenarios can include:

* Cardiac arrest
* Trauma
* Stroke
* Structure fire
* Hazmat
* Wildland fire
* MCI
* Rescue
* Vehicle collisions

### Supervisor Simulator

Leadership scenarios covering:

* Staff conflict
* Inactivity
* Complaints
* Conduct
* Performance
* Policy issues
* FTO disputes
* Welfare
* Resource problems
* Critical incidents

Evaluation focuses on:

* Fairness
* Proportionality
* Evidence
* Judgement
* Communication
* Documentation
* Leadership

### Incident Command Simulator

Dynamic major-incident scenarios including:

* Wildfire
* MCI
* Active threat
* Flood
* Severe weather
* Search and rescue
* Transport incident
* Multi-agency incidents

### Tabletop Exercise Generator

Generate complete exercises with:

* Scenario
* Objectives
* Timeline
* Injects
* Resources
* Facilitator notes
* Evaluation criteria
* Debrief questions

### AI Event Generator

Command can generate complete event plans which enter the Command system as **Drafts** for human approval.

### Civilian Scenario Generator

Creates more varied civilian RP including:

* Everyday life
* Employment
* Business
* Transport
* Medical
* Property
* Social scenarios
* Public events
* Emergencies
* Government interaction
* Crime where appropriate

### Random Event Generator

Generate quick:

* Minor
* Moderate
* Major
* Server-wide events

All events require human approval before becoming active.

---

# 🧠 Smokey State Director

The Director analyses real SSRP platform information and provides operational recommendations.

It can consider:

* Department staffing
* Session balance
* Training
* Qualifications
* Probation
* Vacancies
* Leadership coverage
* AAR trends
* Asset availability
* Fleet defects
* Equipment shortages
* FiveM information when genuinely connected

Director recommendations may include:

* Staffing changes
* Training suggestions
* Event ideas
* Department objectives
* Operational warnings

All actions require human approval.

---

# 💬 Command Centre AI

Authorised Command users can ask questions such as:

* Which departments are understaffed?
* What qualifications expire soon?
* Who is approaching probation review?
* What issues keep appearing in AARs?
* Which vehicles are unavailable?
* Which department objectives are overdue?
* What needs command attention tonight?

Responses are permission filtered.

The AI cannot access information the requesting user is not allowed to see.

---

# 🏛️ Government

A complete Government platform is now included.

### Government Administration

* Government positions
* Officials
* Appointments
* Administration structure

### Elections

* Election creation
* Candidate registration
* Eligibility
* Voting windows
* Voting
* Duplicate vote prevention
* Results
* Certification

### Legislation

Lifecycle:
Draft
→ Introduced
→ Review
→ Debate
→ Vote
→ Passed / Rejected
→ Signed / Vetoed
→ Active / Repealed

Includes:

* Sponsors
* Amendments
* Voting
* Status history

### Petitions

* Citizen petitions
* Signatures
* Duplicate-signature prevention
* Government responses
* Outcomes

### Government Budgets

* State budget
* Department allocations
* Budget requests
* Spending
* Remaining allocation

### Procurement

* Department requests
* Command approval
* Budget review
* Government approval
* Procurement lifecycle
* Delivery
* Automatic Asset Request fulfilment

### Government Contracts

* Suppliers
* Contract values
* Start/end dates
* Contract status

### Citizen Services

Central request system for:

* Government services
* Permits
* Complaints
* Appeals
* Public records
* Custom requests

### Public Records & FOIA

* Public records
* Internal records
* Restricted records
* FOIA-style requests
* Partial release
* Denial
* Approval
* Record publication

### Statistics & Open Data

Authorised aggregated SSRP information can be published without exposing confidential personnel information.

### Appeals / Ombudsman

* Case submission
* Assignment
* Review
* Decisions
* Conflict-of-interest protections

---

# 📚 Records Centre

The new Records Centre provides permission-aware access to historical SSRP records.

Search across:

* Member service history
* Recruitment
* Interviews
* AI panels
* Probation
* FTO
* Training
* Qualifications
* Promotions
* Transfers
* Secondments
* Resignations
* Retirement
* Alumni
* Evaluations
* Moderation
* Sessions
* Incidents
* AARs
* Assets
* Fleet history
* Government records

Sensitive records remain restricted based on permissions.

---

# 📈 Development Hub

A unified Development area brings together:

* Mentoring
* Leadership development
* Evaluation goals
* Probation development actions
* 360° Review outcomes
* Training recommendations
* Staff QA coaching
* Succession-development gaps
* Simulator recommendations

Views include:

* My Development
* Department Development
* Leadership Pipeline

---

# 🎮 FiveM Integration

SmokeyHub has been designed specifically for **FiveM**.

### Secure Architecture

FiveM Client
→ FiveM Server Resource
→ HMAC-Signed SmokeyHub API
→ SSRP Core

The FiveM client never receives SmokeyHub integration secrets.

Security includes:

* HMAC authentication
* Timestamp verification
* Replay protection
* Single-use nonces
* Scope restrictions
* Timing-safe signature verification
* Credential rotation/revocation

### FiveM Features

* Server heartbeat
* Live server health
* Player telemetry
* Account linking
* Player verification
* Department/rank sync
* Permission checks
* Duty start/end
* Session integration
* Vehicle eligibility
* Vehicle usage
* Facility access
* Asset defect reporting

### Smokey Control + FiveM

When connected, Smokey Control can display:

* Server status
* Player count
* Linked players
* Duty staffing
* Department distribution
* Last heartbeat
* Integration health

No live data is fabricated when the FiveM server is offline.

---

# 💬 Discord Integration

SmokeyHub includes a Discord integration system with:

* Secure bot configuration
* Discord server verification
* Identity linking
* Role mappings
* Channel mappings
* SSRP-managed role syncing
* Role reconciliation
* Session announcements
* Callout notifications
* Recruitment notifications
* Training notifications
* Promotion updates
* Government announcements
* Durable job queue
* Retry handling
* Dead-letter queue
* Connection health

The integration only manages Discord roles explicitly mapped to SmokeyHub and leaves unrelated Discord roles untouched.

---

# 🔄 Integration Centre

Owner administration includes:

* FiveM
* Discord
* AI providers
* Identity links
* Role mappings
* Channel mappings
* API credentials
* Job queue
* Failures
* Logs
* Documentation

---

# 🔐 Security & Permissions

SmokeyHub uses server-side permission enforcement throughout the platform.

Features include:

* Role-based access control
* Department-scoped permissions
* Owner global access
* Permission-protected APIs
* Secure secret storage
* Encrypted provider credentials
* Cross-department access protection
* Audit trails
* Integration scopes
* HMAC verification
* Replay prevention
* XSS/input protection
* Database constraint enforcement

Changing an ID in an API request does not grant access to another department's restricted records.

---

# 📝 Audit System

Important actions across SmokeyHub generate immutable audit entries.

Examples:

* Promotions
* Transfers
* Staff actions
* Probation decisions
* Qualifications
* Asset changes
* Government approvals
* Permission changes
* Integration credentials

Audit records cannot be edited or deleted through normal application interfaces.

---

# 🔔 Notifications

The shared notification system supports:

* In-app notifications
* Discord-ready notifications
* Email-ready architecture
* Notification preferences

Examples:

* Application updates
* Training assignments
* Probation reviews
* Qualification expiry
* Promotions
* Transfers
* Sessions
* Callouts
* Asset alerts
* Government requests

---

# 🔎 Global Search

Permission-aware search across SmokeyHub including:

* Members
* Departments
* Applications
* Training
* Qualifications
* Probation
* Promotions
* Sessions
* Assets
* Government records

Users only receive results they are authorised to view.

---

# 📱 Responsive Interface

SmokeyHub is designed for:

* Desktop
* Tablet
* Mobile

Tables and dashboards adapt into mobile-friendly layouts with permission controls preserved across screen sizes.

---

# 🧩 Shared SmokeyID

One account powers the entire platform.

Your SmokeyID connects:

* Profile
* Departments
* Ranks
* Staff roles
* Permissions
* Qualifications
* Training
* Probation
* Promotions
* Service history
* FiveM identity
* Discord identity

No separate accounts are required for each SmokeyHub module.

---

# ✅ Testing & Readiness

The complete 10-phase development roadmap has been completed.

Final testing covered **32/32 system areas** with:

* 0 outstanding in-scope failures
* Cross-department permission testing
* Event-bus testing
* Audit integrity
* Recruitment workflows
* Training
* Probation
* Promotions
* Command
* Assets
* Government
* FiveM integration contracts
* Discord integration logic
* Security
* Data integrity
* Concurrency
* Mobile responsiveness
* Cross-system workflows

The platform is currently considered:

## 🟡 READY WITH LIVE INTEGRATIONS

Core SmokeyHub functionality is operational.

Live functionality requiring external services becomes available once the relevant integration is configured, including:

* External AI providers
* Live FiveM server connection
* Live Discord connection

---

# 🎉 Welcome to SmokeyHub

SmokeyHub is no longer just a management dashboard.

It is now the central operating platform for **Smokey State RP** — managing the journey from application and training through live operations, leadership, assets, government, FiveM and community integrations.

**SmokeyHub v1.0.0 is here.**