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.
POST /auth/login JWT · Role Claims 1h access · 7d refresh GPS starts on login Device ID bound
9:41
●●● 100%
🏢
HRM Panel
Field Operations Platform
v1.0 · CleanPro Services
Mobile Number
+91 98765 43210
4-digit PIN
Login →
Forgot PIN? Contact Admin
Login Screen
9:41
●●● 100%
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
Continue as Field Officer →
📍
GPS tracking session started automatically on login
Role Selection + JWT
2:15
●●● 72%
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.
Module 5 — FO Tracking WebSocket GPS Active GET /dashboard/summary KRA 1,2,3,7
9:00
●●● 91%
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%
Pass
Sunrise Township A
Due 10:00 AM · Inspection pending
Pending
!
City Hospital Wing C
Score 72% · Snag auto-created
Fail
Grand Hotel Lobby
Scheduled 2:00 PM
Later
Begin Visit · Sunrise Township →
🏠
Home
📋
Inspect
👥
Staff
📊
Reports
Main Dashboard
9:01
●●● 91%
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.
WebSocket breadcrumb stream POST /visit/start 30s GPS interval 5 min batch upload PATCH /visit/end/{id}
10:00
●●● 91%
Starting visit
Sunrise Township
Site A
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
10:45
●●● 85%
Visit In Progress
Sunrise A · 45 min active
● Live
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
11:30
●●● 85%
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.
GET /inspection/checklist/{siteId} POST /inspection/submit 80% pass threshold In-app camera only Offline-capable Photo → S3
10:10
●●● 91%
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
Photo!
Section B — Restrooms
Sanitiser dispensers full
Floors disinfected
Urinals deodorised
Will auto-create snag on submit
Snag
📷 Capture Photo
Next Section
Checklist — Common Areas
10:20
●●● 91%
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
10:25
●●● 91%
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.
score = passed/total × 100 POST /snag/create (auto) SLA timer starts PDF report → admin FCM → supervisor
10:45
●●● 88%
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
9:20
●●● 85%
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
11:00
●●● 85%
Inspection History
All sites · This month
TechPark T2 · INS-443
Today 8:30 AM · 88%
Pass
City Hospital C · INS-442
Today 9:20 AM · 72%
Fail
Sunrise Township · INS-441
Yesterday · 91%
Pass
Grand Hotel · INS-440
3 Jul · 84%
Pass
Office Park · INS-439
2 Jul · 76%
Fail
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.
POST /snag/create PATCH /snag/{id}/close SLA: 4h urgent / 6h standard Evidence photo required FCM on breach
11:00
●●● 85%
Snag Reports
All sites · Today
3 Open
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 ✓
Done
Open Snag List
11:05
●●● 85%
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
12:10
●●● 85%
Snag #SNK-101
Closure with evidence
Open
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.
GET /attendance/cross-check ANOMALY_GHOST · ANOMALY_GEO POST /staff-check/submit KRA 2 — Staff Mgmt
10:30
●●● 91%
Attendance Audit
Sunrise Township · Today
3 Flags
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
StaffExpectedActualFlag
Kavita P.8:008:03OK
Ramesh B.8:008:02Ghost
Priya S.8:00BlockedGeo
Sunita K.8:00DupDup
🚨 Escalate Flags
Submit Audit
Attendance Cross-Check
10:35
●●● 91%
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.
POST /task/assign PATCH /task/{id}/complete FCM push to supervisor Optional photo evidence
10:05
●●● 91%
Assign Tasks
Sunrise Township · Vikram Patel
tasks assigned this visit
1
Verify grooming compliance all staff
Assigned → Vikram Patel · SUP
Done
2
Attendance cross-check anomalies
Assigned → Vikram Patel · SUP
Active
3
Floor round L1–L3 with photo log
Pending · Not started
Pending
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
10:40
●●● 91%
Task Progress
FO view · Real-time
2/4
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.
GET /attendance/summary Absenteeism > 15% → FCM Daily 9AM digest KRA 7 — Absenteeism PDF/Excel export
9:05
●●● 91%
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
9:10
●●● 91%
Anomaly Detail
Ramesh B. · ANOMALY_GHOST
P1
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
🚨 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.
GET /compliance/training/{siteId}/{month} Cron alert on 20th POST /rnr/log KRA 5 — Training
11:00
●●● 85%
Training Compliance
All Sites · July 2025
1 Overdue
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 ✓
Done
🎓
Sunrise Township A
7 Jul · Chemical Safety · 14 attended
Done
🎓
City Hospital Wing C
8 Jul · Infection Control · 14 attended
Done
!
Grand Hotel Lobby
No session logged for July
Overdue
🎓
Office Park Block A
Scheduled 12 Jul · Not done yet
Upcoming
r&r events
🏆
TechPark T2 — Kavita P. (Best Attend.)
5 Jul · 15 attendees · Logged ✓
Done
!
Sunrise Township A — R&R Pending
Due by 31 Jul
Pending
Download Compliance Report
Training Compliance Calendar
11:05
●●● 85%
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.
POST /feedback/submit OTP / Digital Signature Monthly per site KRA 3 — Client Relations KRA 6 — Customer Review
11:30
●●● 85%
Client Feedback
Sunrise Township · July 2025
Due
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
11:35
●●● 85%
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
11:40
●●● 85%
Feedback History
Sunrise Township
💬
July 2025 · Rating: 5/5
Submitted today · OTP verified
Done
💬
June 2025 · Rating: 4/5
28 Jun · Ashok Verma ✓
Done
💬
May 2025 · Rating: 3/5
30 May · Negative: restroom freq.
Review
💬
April 2025 · Rating: 4/5
29 Apr · Good overall
Done
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.
POST /report/generate GET /reports Auto last day of month Email via SendGrid PDF + Excel export
12:00
●●● 80%
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
Ready
📄
Monthly Compliance July
Auto on 31 Jul · 23 days left
Pending
📄
Inspection Pass Rate June
Finalised · 94% overall
Done
📄
Attendance Summary June
Emailed via SendGrid · 30 Jun
Done
Generate Now
Download PDF
🏠
Home
📋
Inspect
👥
Staff
📊
Reports
Reports Overview
12:05
●●● 80%
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.
POST /incident/create P1 → Admin direct KRA 8 — Safety & Theft Module 12 — Gyroscope alerts
12:30
●●● 80%
Safety Overview
All Sites · This Month
1 Open
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
Review
😴
IDLE_DETECTED — Raju B.
2:15 PM · 32 min idle · Dismissed
Closed
safety compliance by site
TechPark Tower 2100%
City Hospital Wing C88%
Safety Dashboard
12:35
●●● 80%
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.
Firebase FCM P1 Immediate · P2 Digest P3 On-event · P4 Monthly Full audit log in DB
9:35
●●● 65%
Notifications
Field Officer · Today
6 New
🚨
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
9:36
●●● 65%
Alert Priority Guide
FO receives these events
P1 — Immediate FCM
• Geo-fence breach
• Inspection fail
• Safety incident
• SLA breach confirmed
P2 — Daily Digest 9AM
• Absenteeism > threshold
• Ghost punch anomaly
• Low stock alert
• SLA warning (<1h left)
P3 — On Event
• Training cron alert (20th)
• Training completed by trainer
• Requisition status update
P4 — Monthly
• Payslip available
• Monthly compliance report
All FCM notifications stored in DB with timestamp + recipient list for full audit trail
Notification Priority Guide