SCREEN 01 · AUTHENTICATION
Login & Role Selection
Field Officer authenticates with mobile number + 4-digit PIN. JWT token issued with role claims embedded. GPS tracking session begins automatically on login. Token expires in 1h; refresh token valid 7 days with rotation.
🏢
HRM Panel
Field Operations Platform
v1.0 · CleanPro Services
Mobile Number
+91 98765 43210
4-digit PIN
Login →
Forgot PIN? Contact Admin
Login Screen
→
Welcome back
Rajiv Kumar
Select Role
👷
Field Officer
Zone 3 · 7 sites assigned
✓
🎯
Site In-charge
Not assigned to this account
// JWT Token Issued
role: "field_officer"
site_ids: ["SITE-001","SITE-002"...]
exp: +1h | refresh: 7d
site_ids: ["SITE-001","SITE-002"...]
exp: +1h | refresh: 7d
Continue as Field Officer →
📍
GPS tracking session started automatically on login
Role Selection + JWT
→
⏱
Session Expired
1-hour access token expired. Re-enter PIN to continue — your work is saved.
1
2
3
4
5
6
7
8
9
0
⌫
POST /auth/refresh · rotate token
Session Expired (1h token)
SCREEN 02 · KRA 1–8 OVERVIEW
Field Officer Dashboard
Central command view. All 7 assigned sites, inspection scores, anomaly flags, training compliance, and absenteeism — visible at a glance. GPS tracking session active throughout. Three key stat panels reflect real-time data from all modules.
Good morning
Rajiv Kumar
Field Officer · Zone 3
RK
GPS Active
7
Sites
2
Due
94%
Pass
3
Alerts
today's site visits
Live · 30s stream
✓
TechPark Tower 2
Completed 8:30 AM · Score 91%
⏱
Sunrise Township A
Due 10:00 AM · Inspection pending
!
City Hospital Wing C
Score 72% · Snag auto-created
○
Grand Hotel Lobby
Scheduled 2:00 PM
Begin Visit · Sunrise Township →
🏠
Home
📋
Inspect
👥
Staff
📊
Reports
Main Dashboard
Quick Actions
All KRA access
📋
Inspection
KRA 1
👥
Staff Audit
KRA 2
🎓
Training
KRA 5
💬
Feedback
KRA 6
📈
Reports
KRA 3,7
🚨
Safety
KRA 8
active alerts today
✗
Inspection Fail — Hospital C
Score 72% · 2 snags created
9:15
⚑
Ghost Punch — Ramesh B.
No GPS trail after punch-in
8:45
⏱
SLA Warning — Snag #1042
1h to breach · Not closed yet
8:10
KRA Quick Access
SCREEN 03 · MODULE 5 · KRA 1
Site Visit Start & GPS Tracking
Field Officer initiates a site visit — GPS breadcrumb session begins, WebSocket stream opens to server every 30 seconds. Visit record created. All subsequent actions (inspection, staff check, tasks) are linked to this visit ID. Batch upload every 5 minutes.
Starting visit
Sunrise Township
GPS lock · 142m from site
SiteSunrise Township A
Site TypeTownship
Geo-fence✓ 142m / 300m OK
GPS StreamWebSocket / 30s
Visit IDVISIT-20250708-009
📍
GPS session started. Breadcrumbs recording every 30 seconds.
Begin Visit · Record Start Time
🏠
Home
📍
Visit
📋
Inspect
👥
Staff
Visit Initiation
Visit In Progress
Sunrise A · 45 min active
90 breadcrumbs · 45 min
visit checklist
✓
Inspection checklist completed
Score 88% · INS-443
✓
Staff attendance cross-check
1 anomaly flagged
✓
Uniform compliance check
Photo taken
→
Training compliance check
In progress
Client feedback collection
Monthly R&R verification
End Visit & Save Breadcrumbs
Visit In Progress
✅
Visit Complete
Sunrise Township A · 1h 30m
Started10:00 AM
Ended11:30 AM
Breadcrumbs180 points
Inspection88% · Pass
Staff flags1 anomaly
Tasks done3/3 complete
APIPATCH /visit/end/009
☁
GPS trail uploaded to server. Breadcrumbs saved to visit record.
Next Site →
View Report
Visit Summary
SCREEN 04 · MODULE 6 · KRA 1,4
Site Inspection Checklist
Site-type configurable checklist (township template shown). In-app camera only — gallery upload blocked. Each section requires mandatory photo. Score auto-calculated. Threshold 80% — below triggers automatic snag + push notification to supervisor.
Inspection · Sunrise A
Township · Deep Clean
78%
12/15
Score — Below 80% thresholdNeeds attention
✓ 10 Pass✗ 2 Fail○ 3 Pending
Section A — Common Areas
✓
Lobby floor swept and mopped
Photo ✓ · 10:05 AM
✓
Entrance mats cleaned & placed
Photo ✓
✓
5S boards updated
✗
Glass surfaces streak-free
Photo required to close snag
Section B — Restrooms
✓
Sanitiser dispensers full
✓
Floors disinfected
✗
Urinals deodorised
Will auto-create snag on submit
📷 Capture Photo
Next Section
Checklist — Common Areas
Inspection · Sunrise A
Section C — Equipment
Section C — Equipment & Safety
✓
Scrubber serviced & stored correctly
Photo ✓
Vacuum bag replaced
Chemical inventory checked
PPE available for all staff
Section D — Uniforms & Grooming
✓
All staff in full uniform
Photo taken · 1 violation noted
✓
ID badges visible on all staff
📷
In-app camera only. Gallery upload is blocked to prevent fraud. EXIF GPS + time is embedded.
📴
Offline mode: checklist cached in SQLite. Photos queued for S3 on reconnect.
Complete & Calculate Score
Checklist — Equipment
Safety Flag
Optional — during inspection
🚨 Report Safety Incident
Any safety incident triggers an immediate push to Admin (not just Supervisor). This bypasses normal SLA flow.
Chemical Spill▾
Wing C · Corridor Level 2
Staff spilled disinfectant near ICU entry...
⚡
Safety flag → FCM immediate to Admin + FO. Logged in incident register. Separate from snag flow.
PriorityP1 · Immediate
RecipientsAdmin + Field Officer
APIPOST /alert/safety
📷 Report Incident
Skip
Safety Incident Flag
SCREEN 05 · MODULE 6 · AUTO-FLOW
Inspection Result & Auto-Snag
Score auto-calculated server-side. Pass (≥80%) generates PDF and notifies admin. Fail creates snag for each failed item, assigns to supervisor, starts SLA timer, sends FCM push. Both paths generate a full inspection report pushed to admin panel.
✅
Inspection PASSED
Score: 88% · Threshold: 80%
SiteTechPark Tower 2
Total Items15
Passed13
Failed2
Score88% ✓
Photos6 → S3
PDF ReportGenerated + pushed
Inspection IDINS-443
📄
PDF report sent to admin panel. Supervisor notified via FCM.
Done
View PDF
Inspection PASS
✗
Inspection FAILED
Score: 72% (below 80% threshold)
⚡
2 snags auto-created · Supervisor FCM sent immediately
SiteCity Hospital Wing C
Score72% ✗
Failed Items4
Snags Created2 auto
auto-created snags
Urinal deodorising not done
Wing C · Restroom L2 · Assigned: Supervisor
⏱ SLA: 4h · Timer started
Glass streaks — ICU corridor
Wing C · ICU Level 3 · Assigned: Supervisor
⏱ SLA: 6h · Timer started
View All Snags →
Inspection FAIL + Auto-Snag
Inspection History
All sites · This month
✓
TechPark T2 · INS-443
Today 8:30 AM · 88%
✗
City Hospital C · INS-442
Today 9:20 AM · 72%
✓
Sunrise Township · INS-441
Yesterday · 91%
✓
Grand Hotel · INS-440
3 Jul · 84%
✗
Office Park · INS-439
2 Jul · 76%
monthly pass rate
7 Inspections this month5 Pass · 2 Fail
Overall Pass Rate94%
Export Report PDF
Inspection History
SCREEN 06 · MODULE 6 · KRA 8
Snag Reports & SLA Tracking
Snags auto-created on inspection fail, or manually raised. SLA timer starts at creation. Closure requires evidence photo. Breach escalates to FO + Admin via FCM. FO reviews, escalates, or approves closure from here.
Snag Reports
All sites · Today
SLA BREACHED — Washroom leak L2
Breach!
TechPark T2 · Raised 6:30 AM · SLA: 4h
⚠ OVERDUE by 30 min — Escalate now
✓ Close
🚨 Escalate
Urinal deodorising — Hospital C
2h 50m left
Wing C · Restroom L2 · Auto-created 9:20 AM
⏱ SLA expires 1:20 PM
✓ Close
📷 Evidence
Glass streaks — ICU Corridor
5h 50m
Wing C · ICU Level 3 · SLA: 6h
On track
✓ Close
View
resolved today
✓
Dustbin overflow · TechPark Lobby
Closed 7:30 AM · 1h 20m · Evidence ✓
Open Snag List
Raise New Snag
Manual report
Sunrise Township A▾
Level 1 · Common Area▾
Sanitation Issue▾
Urgent (4h SLA)▾
Supervisor — Vikram Patel▾
Mop water bucket overflowed near L1 washroom. Floor slippery — safety risk...
📷
Add Evidence Photo
In-app camera only · GPS tagged
ℹ
POST /snag/create · FCM push to Supervisor immediately on submit
📷 Capture & Submit Snag
Raise New Snag
Snag #SNK-101
Closure with evidence
IssueUrinal deodorising
SiteCity Hospital C · L2
Raised9:20 AM (auto)
SLA1:20 PM (1h 50m left)
AssignedVikram Patel · SUP
StatusIn Progress
supervisor activity log
✓
Snag received by Supervisor
9:21 AM · FCM push opened
→
Assigned to Sunita K.
9:35 AM · Staff notified
⏳
Awaiting closure + evidence
12:10 PM · Staff working on it
✓ Mark Resolved
Escalate to FO
ℹ
PATCH /snag/{id}/close · Evidence photo + timestamp required
Snag Detail & Closure
SCREEN 07 · MODULE 9 · KRA 2
Staff Cross-Check & Anomaly Audit
FO performs random attendance verification against roster. System highlights suspicious patterns — ghost punches (no GPS trail), geo-mismatch, device duplication, double punches. Uniform and grooming photo capture during visit. Embezzlement flags escalated immediately.
Attendance Audit
Sunrise Township · Today
⚑
ANOMALY_GHOST — Ramesh B. punch-in at 8:02 but zero GPS trail for entire shift. Possible embezzlement.
🗺
ANOMALY_GEO — Priya S. punch was 524m outside geo-fence. Punch was blocked.
📱
ANOMALY_DUP — Sunita K. two punch records within 4 minutes.
attendance table
| Staff | Expected | Actual | Flag |
|---|---|---|---|
| Kavita P. | 8:00 | 8:03 | OK |
| Ramesh B. | 8:00 | 8:02 | Ghost |
| Priya S. | 8:00 | Blocked | Geo |
| Sunita K. | 8:00 | Dup | Dup |
🚨 Escalate Flags
Submit Audit
Attendance Cross-Check
Grooming Check
Uniform compliance · KRA 2
KP
Kavita P.
Level 1
Pass ✓
MR
Mohan R.
Level 2
No badge
RB
Raju B.
Backup
Pass ✓
PD
Priya D.
Level 3
Absent
grooming items checked
✓
Uniform worn correctly — all staff
1 violation: Mohan R. — no ID badge
✓
Group photo taken
Tagged as 'uniform_compliance'
✓
Personal hygiene acceptable
⚑
Violation flagged: Mohan R. — no ID badge. Supervisor notified. Corrective action required.
Submit Grooming Check
Uniform & Grooming Check
SCREEN 08 · MODULE 5 · KRA 2
Task Assignment to Supervisors
FO assigns tasks to supervisors during site visit. Supervisor receives FCM push. Completion tracked in real-time — supervisor marks done with optional photo. Incomplete tasks flagged to FO at visit end. Enables real-time coordination without phone calls.
Assign Tasks
Sunrise Township · Vikram Patel
tasks assigned this visit
1
Verify grooming compliance all staff
Assigned → Vikram Patel · SUP
2
Attendance cross-check anomalies
Assigned → Vikram Patel · SUP
3
Floor round L1–L3 with photo log
Pending · Not started
new task
Verify July training compliance status...
Vikram Patel (Supervisor)▾
Normal▾
ℹ
POST /task/assign · FCM push to supervisor device on submit
Assign Task → Supervisor
Task Assignment
Task Progress
FO view · Real-time
Tasks Completed2 of 4
✓
Grooming check · Vikram P.
Completed 10:10 AM · Photo uploaded
✓
Attendance anomalies reviewed
Completed 10:25 AM
→
Floor round L1–L3
In progress · Started 10:35
Training compliance verify
🔄
Task status syncs in real-time via API. Supervisor updates reflected immediately on FO screen.
api flow
AssignPOST /task/assign
CompletePATCH /task/{id}/complete
PhotoOptional · PUT /task/{id}/photo
Incomplete flagAt visit end → FO + Admin
Task Progress Tracker
SCREEN 09 · MODULE 9 · KRA 7
Attendance Reports & Absenteeism
FO reviews attendance data across all sites. Absenteeism rate per site tracked against threshold (default 15%). Daily digest at 9AM flags high-absenteeism sites. Auto-deduction flag sent to payroll when absent days exceed configured limit. Reports exported as PDF or Excel.
Absenteeism
All Sites · This Week
⚠
Grand Hotel above 15% threshold. FCM sent to FO + Admin (9AM digest).
TechPark Tower 24.1%
Sunrise Township A11.2%
City Hospital Wing C6.0%
Grand Hotel Lobby18.5% !
Office Park Block A7.3%
auto deduction trigger
Threshold15% (configurable)
Auto-deduct flagSent to payroll engine
Digest timeDaily 9:00 AM
Export Absenteeism Report
Absenteeism Dashboard
Anomaly Detail
Ramesh B. · ANOMALY_GHOST
Ghost Punch Detected
EmployeeRamesh B. · EMP-4430
Punch-in8:02 AM (recorded)
GPS TrailZero breadcrumbs!
Shift Duration8h (no movement)
Face match0.62 (borderline)
Flag TypeANOMALY_GHOST
⚠
Possible salary fraud — punch-in without actually working. Review + escalate to HR.
detection query
SELECT employees
WHERE punch_in = TRUE
AND gps_trail_count = 0
AND shift_date = TODAY
WHERE punch_in = TRUE
AND gps_trail_count = 0
AND shift_date = TODAY
🚨 Escalate to HR
Dismiss
Anomaly Detail — Ghost Punch
SCREEN 10 · MODULE 7 · KRA 5
Training & R&R Compliance
FO verifies monthly training compliance across all sites. System auto-alerts on 20th if any site has pending training. R&R event must be logged separately per site per month. FO receives FCM when trainer completes and uploads evidence.
Training Compliance
All Sites · July 2025
⏰
Cron alert sent on 20th: Grand Hotel has no training logged. 6 days remaining.
site compliance status
🎓
TechPark Tower 2
3 Jul · Neha T. · 12 attended · Evidence ✓
🎓
Sunrise Township A
7 Jul · Chemical Safety · 14 attended
🎓
City Hospital Wing C
8 Jul · Infection Control · 14 attended
!
Grand Hotel Lobby
No session logged for July
🎓
Office Park Block A
Scheduled 12 Jul · Not done yet
r&r events
🏆
TechPark T2 — Kavita P. (Best Attend.)
5 Jul · 15 attendees · Logged ✓
!
Sunrise Township A — R&R Pending
Due by 31 Jul
Download Compliance Report
Training Compliance Calendar
Training Completion
FCM received from Trainer
✓
FCM received: Training complete — City Hospital Wing C · Infection Control · 14 attended
TrainerNeha T. (Trainer)
TopicInfection Control Protocols
Date8 Jul · 11:00–13:00
Attendees14 / 16
EvidencePhotos + sign-in sheet ✓
CompliancePATCH /compliance/.../complete ✓
grand hotel — escalate
Training Overdue · Grand Hotel
No training session logged for July 2025. 6 days remaining before month end. Auto-alert already sent on 20th.
GET /compliance/training/SITE-006/2025-07
Send Reminder to Trainer
View Details
Training Completion + Escalation
SCREEN 11 · KRA 3 & 6
Client Feedback Collection
FO collects monthly digital feedback from RWA members or Building Manager. Form includes rating, service checklist, and comments. OTP-verified or digital signature prevents fake entries. Submitted to admin panel with timestamp. Negative feedback auto-escalates.
Client Feedback
Sunrise Township · July 2025
Client / RWASunrise Residents Assoc.
ContactMr. Ashok Verma
MonthJuly 2025
overall rating
1
Poor
2
3
4
5 ✓
Best
✓
Staff behaviour satisfactory
✓
Complaints resolved on time
Equipment condition acceptable
✓
No safety incidents reported
Overall happy with cleanliness. Request more frequent restroom checks...
✍
Digital Signature / OTP
Tap to verify identity before submit
Submit to Admin Panel
Client Feedback Form
OTP Verification
Anti-fraud · Client identity
📲
OTP sent to Client
Sent to Mr. Ashok Verma · +91 98765 00001
4
2
1
8
PurposePrevent fake feedback
OTP valid5 minutes
FallbackDigital signature capture
TimestampEmbedded in submission
ℹ
POST /feedback/submit includes OTP token + client_id for audit trail in admin panel
✓ Verify & Submit Feedback
OTP Verification
Feedback History
Sunrise Township
💬
July 2025 · Rating: 5/5
Submitted today · OTP verified
💬
June 2025 · Rating: 4/5
28 Jun · Ashok Verma ✓
💬
May 2025 · Rating: 3/5
30 May · Negative: restroom freq.
💬
April 2025 · Rating: 4/5
29 Apr · Good overall
trend
Average Rating (6 months)4.2 / 5
📈
Positive trend. May complaint about restroom frequency was actioned — rating improved.
View in Admin Panel
Feedback History & Trend
SCREEN 12 · MODULE 9 · KRA 3,7
Reports & Analytics
Weekly and monthly site performance reports auto-compiled from inspection, attendance, feedback, and snag data. Auto-generated on last working day and emailed via SendGrid/SES. FO can generate on-demand reports in PDF or Excel format.
Reports
All Sites · July 2025
6/7
Training done
1
Training pending
5/7
R&R logged
8.3%
Avg absenteeism
available reports
📄
Weekly Site Performance
7 Jul – 13 Jul · Auto-generated
📄
Monthly Compliance July
Auto on 31 Jul · 23 days left
📄
Inspection Pass Rate June
Finalised · 94% overall
📄
Attendance Summary June
Emailed via SendGrid · 30 Jun
Generate Now
Download PDF
🏠
Home
📋
Inspect
👥
Staff
📊
Reports
Reports Overview
Weekly Report
7–13 Jul · All Sites
inspection pass rate
TechPark Tower 291%
Sunrise Township A88%
City Hospital Wing C72%
Grand Hotel Lobby85%
absenteeism this week
TechPark Tower 24.1%
Grand Hotel Lobby18.5% !
snag closure rate
8 raised · 6 closed · 2 open75% closure
Export as Excel
Weekly Report Detail
SCREEN 13 · MODULE 6,12 · KRA 8
Safety Incidents & Compliance
FO raises safety incident tickets with description and photo. Safety flags within inspection bypass supervisor and go directly to admin (P1). Zero theft policy tracked. Gyroscope alerts from Module 12 visible here. Safety compliance score shown per site.
Safety Overview
All Sites · This Month
0
Theft incidents
1
Safety incidents
97%
Safety compliance
2
Gyro alerts
open incidents
Chemical Spill — Hospital C
P1 Open
Disinfectant spill near ICU entry. Slip hazard. Raised by Supervisor 9:28 AM.
POST /alert/safety → Admin immediate
✓ Mark Resolved
View Details
gyroscope alerts (module 12)
⚠
UNUSUAL_MOVEMENT — Meena S.
11:42 AM · Possible fall · Admin alerted
😴
IDLE_DETECTED — Raju B.
2:15 PM · 32 min idle · Dismissed
safety compliance by site
TechPark Tower 2100%
City Hospital Wing C88%
Safety Dashboard
Raise Safety Incident
KRA 8 · P1 Alert
🚨
Safety incidents bypass normal flow — FCM goes directly to Admin. Not just supervisor.
City Hospital Wing C▾
Chemical Hazard▾
ICU Corridor · Level 2
Large disinfectant spill at ICU entry. Floor wet and slippery. Staff did not place wet floor signs...
📷
Evidence Photo Required
In-app camera · GPS tagged
PriorityP1 · Immediate
FCM toAdmin + Field Officer
APIPOST /incident/create
Incident RegisterAuto-logged
📷 Capture & Submit Incident
Raise Safety Incident
SCREEN 14 · MODULE 11 · ALL KRA
Notifications & Push Alerts
All FCM push notifications received by Field Officer across all 8 KRAs. P1 alerts (safety, breach, inspection fail, SLA) arrive instantly. P2 (absenteeism, stock) daily digest. P3 (training, task) triggered on events. P4 (payslip) monthly. All logged for audit.
Notifications
Field Officer · Today
🚨
Safety Incident — Hospital C
Chemical spill near ICU. Action needed.
P1 · 9:32
✗
Inspection FAIL — Hospital C
Score 72%. 2 snags created.
P1 · 9:15
🚫
Geo-fence Breach — Priya S.
Punch blocked at 524m. Logged.
P1 · 8:02
⚑
Ghost Punch — Ramesh B.
Punch-in but zero GPS trail.
P2 · 8:45
⏱
SLA Warning — Snag #1042
1h to breach. Not closed yet.
P2 · 8:10
🎓
Training Reminder — Grand Hotel
Monthly training not logged. 6 days left.
P3 · Yest.
✓
Training Done — TechPark T2
Neha T. submitted evidence. Complete.
P3 · Yest.
Notification Center
Alert Priority Guide
FO receives these events
P1 — Immediate FCM
• Geo-fence breach
• Inspection fail
• Safety incident
• SLA breach confirmed
• Inspection fail
• Safety incident
• SLA breach confirmed
P2 — Daily Digest 9AM
• Absenteeism > threshold
• Ghost punch anomaly
• Low stock alert
• SLA warning (<1h left)
• Ghost punch anomaly
• Low stock alert
• SLA warning (<1h left)
P3 — On Event
• Training cron alert (20th)
• Training completed by trainer
• Requisition status update
• Training completed by trainer
• Requisition status update
P4 — Monthly
• Payslip available
• Monthly compliance report
• Monthly compliance report
ℹ
All FCM notifications stored in DB with timestamp + recipient list for full audit trail
Notification Priority Guide