Operator manual for command & control
This guide is for personnel operating CEICS above the school level: military and police C2 operators, Nigeria Safe School Initiative inspectors, regional FL coordinators, and national emergency dispatch staff. For school-level users (teachers, administrators, parents), see the School User Guide.
From device alert to national response
CEICS generates confirmed alerts at the school gateway level. Every alert then moves through a structured escalation chain before reaching national command. Understanding which level you are operating at — and what your specific decision authority is — determines your action.
Wearable device — anomaly detected
ESP32-C3 wearable · autonomousThe CNN-LSTM model on the badge detects a 2-window confirmed anomaly. A coded signal (not raw biometric data) is transmitted to the school gateway via LoRaWAN. The badge discards all raw sensor values immediately after inference — nothing identifiable leaves the device.
School gateway — confirmation and local dispatch
Jetson Nano gateway · Thread 1 · Thread 3The gateway confirms the alert, applies the hysteresis filter, and dispatches push notifications to the registered class teacher and school administrator. For C2 (Seizure) alerts, the re-alert cycle fires every 30 seconds until acknowledged.
School administrator — escalation decision
School admin dashboard · Tier 2The administrator receives all confirmed alerts with timestamps and teacher acknowledgement status. For unacknowledged alerts after 90 seconds, the system escalates automatically to the Zone Coordinator. For C3 alerts where the GPS location is outside a recognised exit point, the administrator initiates the school lock-down protocol.
Zone Security Coordinator — situation assessment
Local government / zone office · Tier 2/3 boundaryThe Zone Coordinator receives escalated alerts from multiple schools in the zone. They cross-reference alert patterns across schools — if multiple schools in a zone report C1/C3 co-occurrences within a short window, this pattern indicates a potential coordinated security incident requiring state-level activation.
State Command & Control — C2 operator activation
State military/police C2 centre · You are here if you hold this roleThe state C2 centre receives a structured alert package from the Zone Coordinator. Your role is to validate the alert against contextual intelligence, make the dispatch decision, and log your decision in the CEICS audit system before deploying any response unit.
2. Check co-occurrence pattern — C1+C3 together is higher priority than either alone.
3. Cross-reference with local intelligence: known active threat in area?
4. Verify gateway is online (not store-and-forward buffered alert from earlier outage).
5. Log dispatch decision in CEICS dashboard → Incidents → Log action.
6. Dispatch response unit with blockchain alert hash as incident reference.
Federal response coordination
NPA C&C · NEMA · UNICEF Nigeria Rapid ResponseFederal activation occurs when state C2 confirms a security incident or mass-casualty medical event. CEICS provides the blockchain audit log as the authoritative incident record. The alert token format is compatible with ITU-T X.1500 IODEF for inter-agency sharing.
How to read and act on every alert class
Each alert displays an anomaly class (C0–C4), a confidence percentage, and the gateway/device ID. This table tells C2 operators exactly what threshold warrants dispatch and what each class means in an operational context.
| Alert class | Operational meaning | Confidence threshold for dispatch | C2 action | Priority |
|---|---|---|---|---|
C0 Normal |
Child activity is normal — walking, sitting, running. No alert is sent for C0. | N/A — not dispatched | No action. | — |
C1 Fall/Assault |
Sudden violent impact detected by accelerometer. May be a fall, fight, or physical attack. Threshold τ=0.85 means 2 consecutive 5-second windows both flagged the event. | ≥85% → teacher responds. ≥92% + unacknowledged 90s → zone coordinator. | Monitor acknowledgement. Escalate if unacknowledged or C1+C3 co-occur. | MEDIUM |
C2 Seizure |
Convulsive shaking pattern detected. Recall 99.1% — the model misses fewer than 1 in 100 genuine seizures. Threshold τ=0.92 was selected against a clinical recall floor of ≥0.93 (Shoaib et al. 2021). | ≥92% → immediate teacher dispatch. ≥92% + unacknowledged 90s → medical emergency escalation. | Medical emergency. Verify teacher response. Dispatch medical team if no acknowledgement within 3 minutes. | URGENT |
C3 Zone Exit |
Child's GPS has been outside school boundary for >30 seconds. Threshold τ=0.80. Could indicate wandering, early departure, or in high-risk areas: abduction. | ≥80% → administrator confirms with gate security. Unknown location → immediate zone coordinator notification. | Verify location via dashboard GPS. If location is near a known exit and child is accounted for, close. If location unknown or in high-risk area, treat as security incident. | ELEVATED |
C4 Phys. Distress |
Abnormal heart rate, low oxygen (SpO₂), or high stress response (EDA). May indicate shock, extreme fear, acute illness, or cardiac event. Threshold τ=0.88. Note: C4 has highest inter-run variance (SD=0.71%) — treat with clinical context. | ≥88% → nurse/medical responder. ≥88% + teacher acknowledgement confirms distress → medical escalation. | Medical/welfare response. Notify school nurse and parents. Document confidence score in incident report. | MEDIUM |
Co-occurring alert patterns
When two alert classes fire simultaneously for the same device, the combined pattern carries higher operational significance than either class alone.
| Co-occurrence pattern | Operational interpretation | Recommended C2 action |
|---|---|---|
| C1 + C3 | Physical assault followed by or concurrent with zone exit. This is the highest-risk pattern — consistent with abduction in progress. Sambisa/Chibok incident pattern. | Immediate escalation. Activate security incident protocol. Notify Zone Coordinator and State C2 simultaneously. Log blockchain hash as incident reference. |
| C2 + C4 | Seizure with concurrent physiological distress. Indicates serious medical event — prolonged seizure or post-ictal complication. Requires urgent medical response, not security. | Medical emergency. Dispatch medical team. Notify parents. Document for NEMA health reporting. |
| Multiple C3 same zone | Multiple devices from different schools in the same zone triggering C3 within a 15-minute window. Indicates possible coordinated security incident. | Zone activation. Activate all school lock-down protocols in zone. Notify State C2. Cross-reference with intelligence reports. |
| C1 + C3 + store-and-forward flag | Alert was buffered during communications blackout. This means the incident occurred during a blackout — when attackers commonly cut communications first. | High priority. Buffered alert timestamp is the incident time, not delivery time. Communications blackout itself is an indicator. Treat as active security incident. |
Reading and exporting the tamper-proof audit trail
Every alert, every FL round, and every administrative action is recorded on the Proof-of-Authority blockchain. The log cannot be modified retroactively. Each block contains a cryptographic hash that proves the data has not been altered since it was written.
Reading a blockchain alert record
Navigate to Dashboard → Audit Log → Incidents. Each record contains the following fields:
block_number sequential block in the PoA chain
timestamp event time (not delivery time) · UTC · immutable
device_id anonymised badge token · not child name
alert_class C0–C4 · with confidence score
location_id school zone reference · not GPS coordinates
node_signaturegateway cryptographic signature · proves gateway authenticity
merkle_root hash of all transactions in this block · tamper-evidence
acknowledged_bystaff member who acknowledged · anonymised ID
response_time_mstime from alert to acknowledgement
Verifying a record has not been tampered with
To verify a specific alert record for use as legal evidence: navigate to Audit → Verify. Enter the block number and alert hash. The system recomputes the Merkle root from all transactions in that block and compares it to the stored root. A match proves the record is authentic.
Exporting the audit log for NSSI inspection
Navigate to Reports → Blockchain audit export. Select date range and school(s). Export as PDF or JSON. The PDF includes a cryptographic verification certificate. The JSON export is compatible with Oslo SSD Annex B incident reporting format.
Filing an SSD-compliant incident report
The CEICS blockchain log is designed to produce all fields required by Oslo SSD Annex B. The following shows how each CEICS record field maps to the SSD reporting schema.
Oslo SSD Annex B field mapping — CEICS export
What to watch and when to act
Zone coordinators and C2 operators have read-only access to the system health dashboard. These are the critical indicators and the thresholds that should trigger intervention.
NORMAL Gateway utilisation
Percentage of gateway capacity currently in use. Calculated as devices_connected / gateway_capacity.
NORMAL Alert latency
Mean time from sensor detection to teacher notification. Published baseline: 127 ms ±3.2 ms (5G). Expected variation by network state.
MONITOR Store-and-forward buffer count
Number of alerts currently queued locally because all network links are severed. Buffer flushes automatically when connectivity restores. Non-zero buffer means active communications blackout.
NORMAL FL model accuracy
Current running detection accuracy of the CNN-LSTM model deployed at each gateway. Should track within ±0.5% of published baseline (95.3%) once convergence is achieved.
NORMAL Packet loss rate
Percentage of telemetry packets lost in transit. Expected variation by environment: urban schools have lower loss than rural/forest deployments.
NORMAL Satellite relay usage
Proportion of alerts being routed via satellite fallback. Should be near zero in normal operations. Elevated satellite usage indicates terrestrial network degradation.
Managing the regional aggregation server
The FL Coordinator operates the Tier 4 regional aggregation server. This role does not receive child alerts — it manages model training, key security, and gateway software versions. It is a purely technical operational role.
Monitoring FL round convergence
Each 24-hour FL round should converge to within ±0.3% of the previous round's accuracy before the improved model is broadcast. The convergence criterion is |accuracy_val(t) − accuracy_val(t−10)| < 0.003.
Distributed key management (2-of-3)
The Paillier decryption key is split across 3 key holders: the FL Coordinator (you), the regional NSSI officer, and the school network administrator. Any decryption requires 2 of these 3 parties to be present. A single holder cannot decrypt alone.
Reviewing gradient updates for Byzantine anomalies
Before the aggregation server broadcasts an updated model, the FL Coordinator should review the gradient norms from each participating gateway. A gateway submitting a gradient vector with norm significantly higher than the median (typically >3× median) may indicate gradient poisoning.
Approving model broadcast to gateways
After convergence is confirmed and gradient review is complete, the FL Coordinator authorises the model broadcast. This requires a multi-signature approval: FL Coordinator + NSSI regional officer. The approval is logged on the PoA blockchain as an administrative transaction.
CEICS alert token format for NPA/NEMA systems
When a C2 operator decides to dispatch a response unit, CEICS generates a standardised alert token that can be passed to NPA Command and Control, NEMA dispatch, and UNICEF Rapid Response systems. The token is designed to be compatible with ITU-T X.1500 IODEF (Incident Object Description Exchange Format).
"incident_id": "CEICS-2025-BRN-0042", // state-corridor-sequence
"alert_class": "C1_C3_COOCCURRENCE",
"oslo_ssd_code": "PHYSICAL_ATTACK_ABDUCTION_RISK",
"confidence": 0.943,
"timestamp_utc": "2025-03-15T10:42:17Z", // event time, not delivery time
"zone_id": "BRN-NORTH-ZONE-04",
"school_id": "BRN-042", // anonymised school reference
"devices_affected": 3,
"network_state": "SATELLITE_FALLBACK", // blackout indicator
"blockchain_hash": "0x3f7a...c421", // tamper-evident audit reference
"dispatched_by": "C2-OPS-BRN-STATE-01", // C2 operator log
Operator quick reference — print and post at C2 workstation
🎖 C2 Operator — alert received
- C2 alone (>92%) → Verify teacher acknowledgement. Medical team if no ack within 3 min.
- C1+C3 together → Immediate security incident protocol. Call Zone Coordinator now.
- C3 unknown location → Do not wait for ack. Escalate immediately.
- Multiple C3 same zone (<15 min) → Zone activation. State C2 notification.
- Buffer flag on alert → Incident time ≠ delivery time. Comms blackout = security indicator.
- Before dispatch: Verify confidence, check co-occurrence, log decision with blockchain hash.
📋 NSSI Inspector — audit export
- Export log: Reports → Blockchain audit export → Date range → School → PDF or JSON.
- Verify tamper: Audit → Verify → Enter block number + alert hash → Check Merkle root.
- SSD Annex B: Export → GCPEA format → Pre-populated report segment ready.
- Key point: Log uses anonymised device IDs. Child name matching requires admin credentials on-site.
- Response time: response_time_ms field gives ms-precision teacher response data.
⚙ FL Coordinator — daily checks
- Round completed? Check convergence criterion: Δacc <0.3% over last 10 rounds.
- Gradient anomaly? Flag any gateway gradient norm >3× median. Exclude, investigate.
- Approve broadcast: FL Mgmt → Approve → Multi-sig with NSSI regional officer.
- Key rotation: Every 6 months. Immediate if key holder changes post.
- Never: Share key share. Store key digitally. Approve broadcast without gradient review.
📡 Dispatch — token handoff
- Token reference: blockchain_hash = incident ID for all reports.
- Network state: SATELLITE_FALLBACK = comms were cut before event.
- Oslo code: oslo_ssd_code maps directly to SSD Annex B incident type.
- Affected count: devices_affected gives minimum children involved.
- UNICEF Rapid Response: +234 9 461 8000 · For C3 + C1 co-occurrence.
- NEMA Emergency: 0800-EMERGENCY · For C2 mass-casualty events.