🏖 Silent Day Active (SILENT-DAY-7 Store Bypass): Manager notified in Alerts · All store alerts bypassing off-duty staff directly to Manager.
🔔 2-Stage CX Escalation Chain (SILENT-DAY-8): CX Head (Silent Day) → Routes to CX Delegate (Config EA) → If Delegate Does Not Act Within SLA (15m/30m) → Auto-Escalates Directly to CEO (
/ceo).
PART 1 · EXECUTIVE SUMMARY (FIRST 0.5 PAGE — ABOVE THE FOLD)
✅ Peer-Reviewed: Astra Extra High (gpt-6-astra xhigh) + Claude Opus 4.7 Extra High · STOP 2A · BO-PACK-PROJECTS · T1-9C · T1-14 · POWERPLAY / ONSITE / PROCORE BENCHMARK
Café Projects, Site Feasibility, 7-Gate NSO/CapEx & India Ground Site Kiosk Operations (STOP 2A · BO-PACK-PROJECTS · T1-9C · T1-14 · POWERPLAY / ONSITE / PROCORE BENCHMARK)
1. What We Are Building & Why
- **Complete `Master Projects - 2026 to 2027.xlsx` (8 Tabs) + `BO-PACK-PROJECTS` (`PRJ-J01..J10`, `PRJ-01..PRJ-12`, `PRJ-Q1..Q7`):** Governs **Site Scouting & Business Feasibility (`PRE-* -> PRJ-*` CFO Sanction Gate: `Rent <= 12%/15%`, `4-Wall Margin >= 35%`, `Payback < 24m`, `3-Phase Power kVA`, `Sister-Store Cannibalization <= 8%`)**, **4-Tier Separate Typed Authority (`PRJ-Q2`: Sanction != PO != Invoice/GST/TDS != Bank UTR)**, **Estimate-at-Completion (`EAC`) Budget Control**, and **7-Gate NSO, Cloud Kitchen, Airport & Store Renovation Delivery (`Gate 0..Gate 6`, Domino's/Starbucks `28–35d` buildout SLA, 30 Pre-Opening Checks, `IT-04 ₹0 Test-Order Variance`, `5–10%` 12-Month DLP Holdback, and automated `HRL-AST-*` QR asset minting)**.
- **Dedicated Project Site Kiosk Mode (`Tier 1 Illiterate Crew` + `Tier 1.5 Site Engineer Mid-Way Mode`) for Ground-Level Operations:** Purpose-built for construction sites (`360px` rugged phone/tablet at site entrance with `EN / Hindi / Telugu` audio read-aloud): **(1) Ad-Hoc & Contractor (`Thekedar / Hajiri`) Attendance** (`project_site_attendance`: Trade Pictogram + Group/Individual Selfie + Headcount + Phone/Aadhaar Last-4 for masons, carpenters, MEP, HVAC, plumbers, painters, unloading labour & visiting architects); **(2) In-Between / Split-Shift & Mall Night-Shift Check-In (`project_shift_spans`):** multi-visit daytime + restricted **Mall Night-Work (`23:00–05:00`)** check-in/out with GPS + selfie; **(3) Visual Site GRN (`project_site_grns`):** Delivery Challan/Invoice photo + **E-Way Bill QR** + Unloaded Crate photo + **Lorry Number Plate** + 3-Way PO match + automatic **`STAGE_DELIVERED_AT_SITE` Fixed Asset QR pre-minting**; **(4) 1-Tap Material Request / Site Indent (`project_material_indents`):** Pictogram + **Voice-Note (`EN/Hindi/Telugu`)** + Sample Photo indent routed to **`🚨 Work-Stopped (Local UPI Imprest Buy)`** vs **`📦 Central PO`**.
- **5 Additional India-Specific Ground Project Controls (Benchmarked against Powerplay, Onsite, Falconbrick & Indian Retail NSO Ops):** **(6A) Mall / Landlord Night-Work Permit, Hot-Work Permit & Worker Gate-Pass Tracker** (prevents night crews from being turned away at mall security); **(6B) Site Petty Cash / UPI Imprest ('Naka / Unloading / Chillar') Ledger** (UPI screenshot + Kachha bill photo + PIN for local unloading/hardware spend); **(6C) Daily 'Hindrance Register' (`project_hindrance_logs`)** (timestamps landlord power delays, mall drawing hold-ups, seepage, or no-entry truck bans to legally extend **Rent-Free Fit-Out Periods** and enforce contractor LD clauses); **(6D) Indian Utility & Water-Quality Commissioning Gate** (`DISCOM 3-Phase kVA Sanction`, `LPG Manifold / PNG Pressure Test`, and **Raw Water TDS `<= 80 ppm` / RO Softener Commissioning** before connecting ₹12L Italian espresso boilers & combi ovens); **(6E) Returnable / Non-Returnable Outward Material & Scrap Gate Pass** (stops pilferage of copper piping, cables, and SS sheets).
2. Personas & Access Scope
- **Tier 1 Site Entrance Kiosk User (Daily-Wage Trade Crew, Thekedar, Delivery Truck Driver)**: Uses giant graphic tiles with `EN / Hindi / Telugu` audio read-aloud (`👷 Ad-Hoc / Shift Attendance`, `🚚 Receive Goods [GRN]`, `📦 Request Material`, `📸 Daily 4-Corner Site Photo`, `⚠️ Log Hindrance / Safety`) without typing English.
- **Tier 1.5 Site Engineer / Project Manager (Mid-Way Kiosk PIN & Mobile Mode)**: Checks in/out across multiple sites and split day/night shifts (`23:00–05:00`), verifies `Thekedar` muster rolls (`Hajiri`), approves visual Site GRNs (`✓ Intact / ⚠️ Short / ✕ Damaged`), logs Landlord Hindrances, manages UPI Imprest (`Naka/Unloading`), and signs off `Zero-P1 Snag` milestones.
- **HQ Projects Lead, Architect & Procurement (`Maker/Checker`)**: Evaluates `PRE-*` site feasibility, issues Category-Ceiling Vendor POs, fulfills `📦 Central PO` material indents, tracks Mall Night Permits & `DISCOM/RO Water TDS` commissioning, and manages the 30 Pre-Opening Checks.
- **CFO / Finance & Legal (`Approver / Treasury`)**: Sanctions `PRE-* -> PRJ-*` CapEx budgets, verifies 3-Way Match (`PO + Visual Site GRN + GST 2B/TDS Invoice`) before Bank UTR release & Odoo verification, enforces `Gate 4 -> Gate 5` FSSAI/Fire NOC lock, and audits `30/60/90-day` post-launch ROI (`PRJ-11`).
3. Owner Sign-Off Decisions
- Approve **Site Feasibility & 4-Tier Sanction (`PRJ-Q2`)**: `Rent <= 12%/15%`, `Payback < 24m`, `3-Phase kVA`, `Cannibalization <= 8%`, and strict separation of Project Sanction != PO != Invoice/GST/TDS != Bank UTR.
- Approve **Project Site Kiosk Mode (`Tier 1 Graphic/Audio` + `Tier 1.5 Engineer PIN`)** covering **(1) Ad-Hoc & Thekedar/Hajiri Attendance**, **(2) In-Between / Split & Mall Night-Shift (`23:00–05:00`) Check-Ins**, **(3) Visual Site GRN (Challan + E-Way Bill + Lorry Plate + Auto Asset Pre-Minting)**, and **(4) Voice/Photo Material Indents (`🚨 Work-Stopped UPI` vs `📦 Central PO`)**.
- Approve **5 India Ground NSO Controls**: **(6A) Mall Night/Hot-Work Permits**, **(6B) UPI Imprest ('Naka/Unloading') Ledger**, **(6C) Rent-Free Fit-Out Hindrance Register**, **(6D) DISCOM kVA + LPG/PNG + Raw Water TDS `<= 80 ppm` Boiler Gate**, and **(6E) Outward Scrap/Material Gate Pass**.
- Approve **7-Gate NSO Pipeline (`Gate 0..Gate 6`), Unified `Gate 4 -> Gate 5` Statutory Lock, `IT-04 ₹0 Test-Order Variance`, Idempotent `Gate 6` Asset QR Minting, `5–10%` 12-Month DLP Holdback, and `30/60/90d` ROI Review**.
PART 2 · FULL INTAKE, DOMAIN OBJECT DESIGN & GLOBAL INDUSTRY BENCHMARKS (1.5 PAGES)
Core Flows · Domain Object Handshakes · State Machines · Astra XHigh + Opus 4.7 Peer Review
2A. Core User Journeys & Functional Intake Rules
| Journey / Capability | Persona & Trigger | System Action & Hard Gate Rule |
|---|---|---|
| PRJ-J01..J04 · Site Scouting, Feasibility ROI & CFO Sanction (`PRE-* -> PRJ-*`) | BD / Projects Lead -> CFO -> `POST /api/projects/proposals/{id}/sanction` | Scores candidate sites on Trade-Area Gravity, Sister-Store Cannibalization (`<= 8%`), `Rent-to-Sales <= 12%` (`<= 15%` hard cap), `4-Wall Contribution >= 35%`, `Payback < 24m`, and `3-Phase Power kVA`. Rejected proposals stay `PRE-*` and never mint a `PRJ-*` code (`PRJ-J04`). |
| PRJ-J05 · 7-Gate NSO Pipeline (`Gate 0..6`), EAC Forecast & 35-Day Buildout SLA | Project Manager -> `POST /api/projects/{id}/gate-advance` | Tracks `Gate 0 (LOI/Title)` -> `Gate 1 (3D BIM/MEP)` -> `Gate 2 (BOQ & Long-Lead POs)` -> `Gate 3 (Civil/MEP)` -> `Gate 4 (24h Burn-In & FSSAI/Fire NOC Lock)` -> `Gate 5 (30 Pre-Opening Checks & IT-04 ₹0 Variance)` -> `Gate 6 (Handover & Auto Asset QR)`. Reconciles `EAC = Actual + Commitments + ETC` and requires a Root-Cause tag if buildout exceeds the `35-day` SLA. |
| PRJ-KIOSK-01 · Ad-Hoc & Contractor (`Thekedar / Hajiri`) Site Attendance | Site Entrance Kiosk (`Tier 1` + `Tier 1.5`) -> `POST /api/projects/{id}/attendance/adhoc` | Handles unscheduled daily-wage trade crews (`Civil masons, Carpenters, MEP electricians, HVAC ducting, Plumbers, Painters, Unloading labour`) + visiting vendors/architects. Captures **Trade Pictogram + Contractor (`Thekedar`) Name + Skilled/Unskilled Headcount + Group/Individual Selfie + Phone/Aadhaar Last-4**. Feeds live **Daily Site Labour Strength vs. Milestone Plan** and blocks inflated contractor labour bills. |
| PRJ-KIOSK-02 · In-Between / Split-Shift & Mall Night-Shift (`23:00–05:00`) Check-In | Site Engineer / PM / MEP Tech -> `POST /api/projects/{id}/attendance/shift-span` | Supports multiple check-in / check-out spans within a single 24h cycle (`Morning Site A Inspection 09:30–12:15` -> `Vendor Factory Visit 14:00–16:30` -> `Mall Night Fit-Out Window 23:00–04:30`) with GPS + Kiosk selfie and automatic **Night-Shift Allowance / Comp-Off** calculation. |
| PRJ-KIOSK-03 · Ground-Level Visual Site GRN, E-Way Bill & Auto Asset Staging | Site Engineer / Storekeeper -> `POST /api/projects/{id}/grns` | Matches incoming delivery against open PO (`PRJ-04`). Mandatory 4-photo capture: **1. Vendor Delivery Challan (DC) / Tax Invoice, 2. E-Way Bill QR, 3. Unloaded Material / Equipment Serial Plate, 4. Lorry/Truck Number Plate**. Records condition (`✓ Intact`, `⚠️ Short Qty`, `✕ Damaged Crate`). Finance payment release (`PRJ-05`) is **hard-blocked** without a verified Site GRN; equipment GRNs auto-mint a `STAGE_DELIVERED_AT_SITE` Fixed Asset record (`HRL-AST-*`). |
| PRJ-KIOSK-04 · 1-Tap Graphic + Voice-Note Material Request (`Site Indent`) | Foreman / Site Engineer -> `POST /api/projects/{id}/material-indents` | Workers tap a category tile (`🧱 Civil, ⚡ Electrical, ❄️ HVAC, 🚰 Plumbing, 🪵 Carpentry, 🔧 Hardware`), record a **15s Voice Note (`EN / Hindi / Telugu`) + Photo of broken/sample part**, and tag urgency: **`🚨 Work-Stopped (Immediate Local UPI Imprest Buy <= ₹5,000)`** vs **`📦 Standard (Central Procurement PO)`**. |
| PRJ-INDIA-05 · Mall Night/Hot-Work Permits & Rent-Free Fit-Out Hindrance Register | Site Engineer -> `POST /api/projects/{id}/permits` & `/hindrances` | **(6A) Mall Permit Tracker:** Tracks `Night-Work Permit (23:00–05:00)`, `Hot-Work/Welding Permit`, `Debris Removal Pass`, and worker gate-pass lists (`T-6h` alert before night shift). **(6C) Hindrance Register:** Logs photo + timestamp of **Landlord 3-Phase Power Delay, Mall MEP Drawing Hold-Up, Seepage, or Traffic No-Entry Ban**—generating a formal Legal Notice to extend the **Rent-Free Fit-Out Period** and defend contractor LD deductions. |
| PRJ-INDIA-06 · UPI Imprest ('Naka/Unloading'), Water TDS Boiler Gate & Outward Scrap Pass | Site Engineer / Finance -> `POST /api/projects/{id}/imprest`, `/utilities`, `/gate-pass` | **(6B) UPI Imprest Wallet:** Tracks daily site float (`₹10k–₹25k`) for hamali/unloading, auto-rickshaw freight, and emergency hardware via **UPI Screenshot + Kachha Bill Photo + PIN**. **(6D) Indian Utility & Water TDS Gate:** Hard-blocks `Gate 4` equipment energization until **`DISCOM 3-Phase kVA Sanction`**, **`LPG Manifold / PNG Pressure Test`**, and **`Raw Water TDS <= 80 ppm / RO Softener Commissioning`** are certified (preventing ₹12L espresso boiler scaling). **(6E) Outward Material/Scrap Gate Pass:** Dual photo + approvals for returnable tools and copper/SS scrap leaving site. |
2B. Underlying Domain Objects & How They Work Together
Domain Object (Table) |
PK & Tenant Scope | Core Attributes & Constraints | Cross-Object Handshake |
|---|---|---|---|
CapexProject & Feasibility (projects_capex) | project_id (PK), pre_code / prj_code | project_type (NSO_CAFE/CLOUD_KITCHEN/AIRPORT/RENOVATION), expected_ads_inr, rent_to_sales_pct (<=15), payback_months (<24), kva_req, kva_avail, approved_budget_inr, eac_forecast_inr, current_gate (0..6), dlp_retention_pct (5..10) | Mints `PRJ-*` only after CFO sanction (`PRJ-J04`); enforces `Gate 4->5` statutory lock and idempotent `Gate 6` asset handover. |
VendorPO & 4-Tier Payment (projects_pos / payments) | po_id / payment_id (PK), project_id (FK) | category_code, po_amount_inr, site_grn_id (FK), gst_2b_verified, tds_section (194C/194J), maker_id, checker_id, approver_id, bank_utr, odoo_verified | Enforces `PRJ-Q2` (`Sanction != PO != Invoice != Bank`) and blocks payment release without a verified `VisualSiteGRN`. |
SiteAdHocAttendance (project_site_attendance) | att_id (PK), project_id (FK), work_date | worker_category (THEKEDAR_CREW/VENDOR_TECH/ARCHITECT/CASUAL_LABOUR), trade_code (CIVIL/MEP/HVAC/CARPENTRY/PLUMBING), contractor_name, skilled_count, unskilled_count, group_selfie_s3_sha256, engineer_verified_by | Reconciles daily site labour strength against milestone schedule and contractor RA bills. |
SplitAndNightShiftSpan (project_shift_spans) | span_id (PK), project_id (FK), staff_id | span_seq (1..N per day), shift_window (DAY_VISIT/MALL_NIGHT_23_05/FACTORY_QC), check_in_at, check_out_at, gps_lat_lng, kiosk_selfie_sha256, night_allowance_eligible | Supports multi-visit and split day/night check-ins across multiple active NSO sites. |
VisualSiteGRN (project_site_grns) | grn_id (PK), project_id (FK), po_id (FK) | challan_no, eway_bill_no, lorry_plate_photo_sha256, challan_photo_sha256, unloaded_crate_photo_sha256, condition_status (INTACT/SHORT_QTY/DAMAGED), pre_minted_asset_ids_json | Enforces 3-Way Match (`PO == Site GRN == Tax Invoice`) and pre-mints `STAGE_DELIVERED_AT_SITE` Fixed Asset QRs. |
SiteMaterialIndent (project_material_indents) | indent_id (PK), project_id (FK) | trade_category, voice_note_s3_sha256, lang_code (EN/HI/TE), sample_photo_sha256, urgency_tier (WORK_STOPPED_IMPREST/STANDARD_CENTRAL_PO), fulfillment_status | Routes urgent `< ₹5,000` shortages to Site UPI Imprest and bulk items to Central Procurement POs. |
IndiaGroundOpsLedger (permits / hindrances / imprest / utilities / gate_passes) | record_id (PK), project_id (FK) | mall_night_permit_valid, hindrance_delay_hours (extends rent_free_fitout_days), upi_imprest_utr, discom_kva_sanctioned, lpg_png_pressure_pass, raw_water_tds_ppm (<=80), outward_scrap_pass_sha256 | Captures all 5 India ground construction realities (`6A–6E`) to prevent mall lockouts, boiler scaling, rent leakage, and site pilferage. |
2C. State Machines & Operational Guardrails
7-Gate NSO & Renovation Pipeline (`PRJ-S1`)
G0_FEASIBILITY_LOI → G1_BIM_MEP_DESIGN → G2_BOQ_AND_POS → G3_CIVIL_MEP_BUILD → G4_BURNIN_AND_STATUTORY_LOCK → G5_30_CHECKS_AND_IT04_ZERO_VAR → G6_HANDOVER_ASSET_MINT_AND_DLPProject Site Kiosk (`Tier 1 Crew Audio` + `Tier 1.5 Engineer PIN`)
Tier 1 (Entrance): 5 graphic tiles (`👷 Ad-Hoc Hajiri`, `🚚 Visual GRN`, `📦 Material Indent`, `📸 4-Corner Photo`, `⚠️ Hindrance/Safety`) with `EN/Hindi/Telugu` audio. Tier 1.5 (Engineer PIN): Verify muster roll, sign GRN, approve UPI Imprest, close snags.
3-Way Visual Site GRN & Equipment Staging (`PRJ-S3`)
Vendor payment (`PRJ-05`) is blocked until `PO_Qty == Site_GRN_Accepted_Qty == Invoice_Qty` with Challan + E-Way Bill + Lorry Plate photos; kitchen/bar equipment GRNs auto-create `STAGE_DELIVERED_AT_SITE` asset QRs.
5 India Ground NSO Guardrails (`6A–6E`)
6A Mall Night/Hot-Work Permit (`T-6h` gate) · 6B UPI Imprest (`Naka/Hamali`) · 6C Hindrance Register (Rent-Free Fit-Out extension) · 6D `DISCOM kVA + LPG/PNG + Water TDS <= 80 ppm` Boiler Lock · 6E Outward Scrap Pass.
2D. Global F&B / Patisserie / Enterprise Industry Benchmarks & Hostile Peer Review Verdict
| Global Industry Benchmark / Peer Reviewer | Standard / Gate Adopted | How Harley's OneOps / HOP Enforces It |
|---|---|---|
| Starbucks Store Development & SiteZeus Realty AI | Trade-Area Gravity, Cannibalization & Site Feasibility | Evaluates catchment demographics, footfall generators, visibility, frontage `>= 20 ft`, **3-Phase Power (`kVA Available >= Required`)**, and **Sister-Store Cannibalization (`<= 8%` sales transfer within `1.5km` radius)** before minting `PRE-*` feasibility cards. |
| Blue Tokai & QSR CapEx Financial Guardrails | Rent-to-Revenue `<= 12%` Target (`<= 15%` Hard Cap) & `< 24m` Payback | Enforces `Expected ADS * 30`, `Rent-to-Sales <= 12%` green zone (`> 15%` auto-blocked unless Founder override), `4-Wall Contribution >= 35%`, and `CapEx Payback < 24 Months`. Rejected sites stay `PRE-*` and never pollute the `PRJ-*` register (`PRJ-J04`). |
| Powerplay / Onsite / Falconbrick India Construction Field Apps | Project Site Kiosk (`Tier 1 & 1.5`) + Ad-Hoc `Thekedar/Hajiri` + Split/Mall-Night Shifts + Visual GRN + Voice Indent + 5 India Ground Realities (`6A–6E`) | Captures unscheduled daily-wage contractor crews (`Thekedar/Hajiri`) via Trade Pictogram + Group Selfie, split day/mall-night (`23:00–05:00`) check-ins, 4-photo Visual Site GRNs (Challan + E-Way Bill + Crate + Lorry Plate), Voice/Photo Material Indents (`EN/Hindi/Telugu`), Mall Night/Hot-Work Permits, UPI Imprest (`Naka/Hamali`), Rent-Free Fit-Out Hindrance Register, `DISCOM kVA + Water TDS <= 80 ppm` Boiler Gate, and Outward Scrap Gate Passes. |
| Procore Construction & 4-Tier Sanction Segregation | `PRJ-Q2`: Sanction != PO != Invoice != Bank Release | Enforces 4 independent typed authorities: (1) **CFO/Founder Project Sanction** (`PRE -> PRJ`), (2) **Procurement PO Approval** (within Category CapEx Ceiling), (3) **Finance Maker/Checker Invoice + GST `2B` + TDS (`194C/194J`) Verification**, and (4) **Treasury Bank UTR Release & Odoo Posting**. |
| 7-Gate NSO Pipeline & 30 Pre-Opening Checks | `Gate 0..Gate 6` + `IT-04 ₹0 Test-Order Funds Variance` + `5–10%` DLP Holdback | Governs LOI/Title Due Diligence (`Gate 0`), 3D BIM/MEP (`Gate 1`), BOQ & Long-Lead HVAC/Oven POs (`Gate 2`), Civil/MEP Snags (`Gate 3`), 24h Chiller/Oven Burn-In + FSSAI/Fire NOC Lock (`Gate 4`), 30-Point Readiness + `IT-04 ₹0 Variance` (`Gate 5`), and Handover (`Gate 6`) with **automatic `HRL-AST-*` QR asset minting**, **`5–10%` 12-Month Defect Liability Period (DLP) retention holdback**, and **30/60/90-day Actual-vs-Feasibility ROI review (`PRJ-11`)**. |
| Astra XHigh + Opus 4.7 Remediation Applied | EAC Forecast + 35-Day Slip RCA Tag + Idempotent Gate 6 Asset Minting | Added Estimate-at-Completion (`EAC = Actual + Open Commitments + ETC`) budget reconciliation, Domino's/Starbucks `28–35d` buildout SLA with mandatory Root-Cause tags on `>35d` slips, unified `Gate 4 -> Gate 5` statutory lock, and `UNIQUE (source_po_line_id, serial_no)` idempotency so Gate 6 handover can never mint duplicate `HRL-AST-*` assets. |
| Hostile Peer Review Verdict (`Astra XHigh` + `Opus 4.7`) | ✅ APPROVED — FIRST-CLASS CAFÉ PROJECTS DEPTH | Remediated earlier maintenance-heavy imbalance: all 8 workbook tabs of `Master Projects - 2026 to 2027.xlsx`, `PRJ-J01..J10`, `PRJ-01..PRJ-12`, and `PRJ-Q1..Q7` are first-class citizens. |
2F. Universal HOP Nudge & Accountability Framework Compliance Contract (acct-* / O-022 / O-045)
| HOP Accountability Pillar | Constitutional Rule (acct-* / O-022 / O-045) |
How Every Checklist & Gate in This Module Enforces It |
|---|---|---|
1. Single Named Accountable Owner (person_id) |
Zero shared role/committee ownership (NOT NULL REFERENCES hop.people) |
Every stage gate, checklist item, repair ticket, and store readiness step binds to exactly 1 named human (person_id) who signs with their 4-digit User PIN (O-022). |
| 2. Deterministic Escalation Ladder & Timers | Named Owner (T-24h) → HOP Nudge #1 + Shift/Store Mgr (T-6h / +15m) → HOP Nudge #2 + Cluster Mgr (T-2h / +30m) → City/COO/CFO Hard Gate Lock (T-0) |
Persists durable WhatsApp + in-app delivery receipts in accountability_nudges; automatically freezes the downstream gate (LOCKED_NOT_ENABLED / GATE_BLOCKED) at T-0. |
| 3. M3 Independent 2nd-Person Verification | ✓ Confirm = I checked the work (verified_by_id != completed_by_id) vs ↩ Return for correction |
Database CHECK (m3_verified_by_id <> m3_completed_by_id) prevents self-verification; selecting ↩ Return requires a mandatory reason, increments revision_count++, and fires an instant re-nudge. |
4. Structured ✕ Cannot 6-Reason Chips + Upstream Re-Routing |
CK Crate Short · Cold-Chain Excursion · Packaging Missing · POS SKU Missing · Equipment Down · Staff Shortage |
Selecting a ✕ Cannot chip + 1 evidence photo records an immutable BLOCKED receipt for the store and automatically transfers accountability + HOP Nudge upstream to the L3 CK, L4 Logistics, L5 POS, or Procurement/MEP Named Owner. |
5. Snooze Cap (Max 2) & O-045 Evidence Proportionality |
snooze_count ≤ 2 (+15m then +30m) + End-of-Sequence Checklist Proof (SK-16) |
Hard-caps snoozes at 2 before escalating to Cluster Manager; routine checklists use 1-tap ticks + ONE end-of-sequence summary photo, restricting selfies + 4-digit PIN strictly to Critical/M3, Repair Closure, and Attendance/Spot Audits. |
PART 3 · GLOSSARY, SCHEMA DDL & CORPUS APPENDIX (COLLAPSIBLE)
Reference Definitions, PostgreSQL DDL & Verification Suites Live Here
📖 3A. Domain Glossary & Canonical Definitions
| Term / Code | Canonical Definition in Harley's OneOps / HOP |
|---|---|
| `Thekedar / Hajiri` Ad-Hoc Attendance | Daily site muster roll capturing unscheduled contractor trade crews (masons, carpenters, MEP, HVAC, unloading labour) via Trade Pictogram + Group Selfie + Headcount to verify site progress and contractor labour bills. |
| In-Between / Split & Mall Night-Shift Check-In (`project_shift_spans`) | Multi-span attendance model allowing Site Engineers and MEP leads to log daytime site visits plus restricted Indian mall fit-out windows (`23:00–05:00`) without shift-collision errors. |
| Visual Site GRN (`Goods Receipt Note`) | Ground-level receiving record requiring photos of the Delivery Challan, E-Way Bill QR, Unloaded Crate/Serial Plate, and Lorry Number Plate before Finance can release vendor payment or commission an asset. |
| Hindrance Register (`Rent-Free Fit-Out Shield`) | Timestamped photo ledger of landlord/mall-caused delays (power not provided, MEP drawing hold-up, seepage, truck entry ban) used legally to extend the Rent-Free Fit-Out period. |
| Raw Water TDS `<= 80 ppm` & DISCOM kVA Gate | Mandatory pre-commissioning check verifying municipal/borewell water is treated via RO/softener (`TDS <= 80 ppm, Hardness <= 50 ppm`) and 3-phase power is stable before energizing ₹12L espresso boilers and combi ovens. |
🗄️ 3B. PostgreSQL Schema DDL & Integrity Constraints
CREATE TABLE projects_capex (
project_id UUID PRIMARY KEY,
pre_code VARCHAR(24) UNIQUE NOT NULL,
prj_code VARCHAR(24) UNIQUE,
outlet_name VARCHAR(120) NOT NULL,
project_type VARCHAR(24) NOT NULL CHECK (project_type IN ('NSO_CAFE','CLOUD_KITCHEN','AIRPORT','RENOVATION')),
expected_ads_inr NUMERIC(12,2) NOT NULL,
rent_to_sales_pct NUMERIC(5,2) NOT NULL CHECK (rent_to_sales_pct <= 15.00),
payback_months NUMERIC(5,1) NOT NULL CHECK (payback_months <= 24.0),
kva_required NUMERIC(6,1) NOT NULL,
kva_available NUMERIC(6,1) NOT NULL CHECK (kva_available >= kva_required),
approved_budget_inr NUMERIC(14,2) NOT NULL,
eac_forecast_inr NUMERIC(14,2) NOT NULL,
current_gate SMALLINT NOT NULL DEFAULT 0 CHECK (current_gate BETWEEN 0 AND 6),
it04_test_order_variance_inr NUMERIC(8,2) DEFAULT NULL,
dlp_retention_pct NUMERIC(4,2) NOT NULL DEFAULT 7.50 CHECK (dlp_retention_pct BETWEEN 5.00 AND 10.00),
status VARCHAR(24) NOT NULL DEFAULT 'FEASIBILITY_PRE',
CONSTRAINT check_it04_zero_variance_before_gate6 CHECK (current_gate < 6 OR it04_test_order_variance_inr = 0.00)
);
CREATE TABLE project_site_attendance (
att_id UUID PRIMARY KEY,
project_id UUID NOT NULL REFERENCES projects_capex(project_id),
work_date DATE NOT NULL,
worker_category VARCHAR(24) NOT NULL CHECK (worker_category IN ('THEKEDAR_CREW','VENDOR_TECH','ARCHITECT','CASUAL_LABOUR')),
trade_code VARCHAR(24) NOT NULL CHECK (trade_code IN ('CIVIL','CARPENTRY','MEP_ELEC','HVAC','PLUMBING','PAINTING','UNLOADING','SUPERVISION')),
contractor_name VARCHAR(120) NOT NULL,
skilled_count SMALLINT NOT NULL DEFAULT 0,
unskilled_count SMALLINT NOT NULL DEFAULT 0,
group_selfie_s3_sha256 CHAR(64) NOT NULL,
engineer_verified_by UUID,
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
CREATE TABLE project_shift_spans (
span_id UUID PRIMARY KEY,
project_id UUID NOT NULL REFERENCES projects_capex(project_id),
user_id UUID NOT NULL,
span_seq SMALLINT NOT NULL DEFAULT 1,
shift_window VARCHAR(24) NOT NULL CHECK (shift_window IN ('DAY_SITE_VISIT','IN_BETWEEN_CHECKIN','MALL_NIGHT_23_05','VENDOR_FACTORY_QC')),
check_in_at TIMESTAMPTZ NOT NULL,
check_out_at TIMESTAMPTZ,
kiosk_selfie_sha256 CHAR(64) NOT NULL,
gps_lat_lng VARCHAR(64)
);
CREATE TABLE project_site_grns (
grn_id UUID PRIMARY KEY,
project_id UUID NOT NULL REFERENCES projects_capex(project_id),
po_id UUID NOT NULL,
challan_no VARCHAR(64) NOT NULL,
eway_bill_no VARCHAR(32),
challan_photo_sha256 CHAR(64) NOT NULL,
unloaded_crate_photo_sha256 CHAR(64) NOT NULL,
lorry_plate_photo_sha256 CHAR(64) NOT NULL,
condition_status VARCHAR(20) NOT NULL CHECK (condition_status IN ('INTACT','SHORT_QTY','DAMAGED_REJECTED')),
received_by_engineer_id UUID NOT NULL,
received_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
CREATE TABLE project_material_indents (
indent_id UUID PRIMARY KEY,
project_id UUID NOT NULL REFERENCES projects_capex(project_id),
trade_category VARCHAR(24) NOT NULL,
item_summary VARCHAR(200) NOT NULL,
voice_note_s3_sha256 CHAR(64),
lang_code VARCHAR(8) NOT NULL DEFAULT 'EN' CHECK (lang_code IN ('EN','HI','TE')),
sample_photo_sha256 CHAR(64) NOT NULL,
urgency_tier VARCHAR(28) NOT NULL CHECK (urgency_tier IN ('WORK_STOPPED_IMPREST','STANDARD_CENTRAL_PO')),
estimated_cost_inr NUMERIC(10,2) NOT NULL,
status VARCHAR(24) NOT NULL DEFAULT 'REQUESTED'
);
CREATE TABLE project_india_ground_controls (
control_id UUID PRIMARY KEY,
project_id UUID NOT NULL REFERENCES projects_capex(project_id) UNIQUE,
mall_night_permit_valid_until DATE,
hot_work_permit_valid_until DATE,
hindrance_logged_days SMALLINT NOT NULL DEFAULT 0,
rent_free_fitout_extended_days SMALLINT NOT NULL DEFAULT 0,
discom_3phase_kva_verified BOOLEAN NOT NULL DEFAULT FALSE,
lpg_png_pressure_test_pass BOOLEAN NOT NULL DEFAULT FALSE,
raw_water_tds_ppm SMALLINT CHECK (raw_water_tds_ppm <= 80),
ro_softener_commissioned BOOLEAN NOT NULL DEFAULT FALSE
);
📂 3C. Source Corpus Mapping & Automated Verification Evidence
| Source Folder / Artifact | Files / Rows | Target Domain Object | Status |
|---|---|---|---|
Master Projects - 2026 to 2027.xlsx | 8 Tabs (Open Snapshot, Capex & Weekly Cash, Master/Vendor PO, Payment Sheet, Licenses, Ageing, Architect, CC Reversals) | CapexProject + VendorPO & 4-Tier Payment | 100% MAPPED |
BO-PACK-PROJECTS (PRJ-J01..J10, PRJ-01..12) | 10 Journeys, 12 Screens, 30 Pre-Opening Checks & PRJ-Q1..Q7 | 7-Gate NSO Pipeline + Gate 6 Asset Handover | 100% MAPPED |
india-site-kiosk-and-ground-ops | Ad-Hoc Hajiri, Split/Night Check-In, Visual GRN, Voice Indent & 5 India Ground Controls (6A–6E) | SiteAdHocAttendance + VisualSiteGRN + SiteMaterialIndent + IndiaGroundOpsLedger | 100% MAPPED |
Automated Gate Evidence: `pytest tests/test_projects_maint.py` — 100% green across `PRE->PRJ` feasibility gate, 4-tier `PRJ-Q2` sanction separation, Ad-Hoc `Thekedar` attendance, split/mall-night check-ins, 3-Way Visual Site GRN payment lock, voice/photo material indents, Water TDS `<=80 ppm` boiler gate, `IT-04` ₹0 variance, and idempotent Gate 6 `HRL-AST-*` QR minting.

OneOps