# Armon TERRA v1.6 — Wireframe-to-Requirement Traceability Matrix

**Project:** Armon TERRA — Vendor-Owned Tote Inventory & Compliance Platform  
**Spec Version:** v1.6  
**Wireframe Version:** Board Approval Ready  
**Date:** March 3, 2026  

---

## 1. Screen-Level Traceability

| # | Screen | Wireframe File | Spec Sections | Role | Key Requirements Covered |
|---|--------|---------------|---------------|------|-------------------------|
| 1 | Vendor Login (OTP) | `vendor-login.html` | §6.1, §6.2 | Vendor | Email OTP, domain allowlist, short-lived JWT, liability acceptance (timestamp + terms version) |
| 2 | Enable Offline Mode | `vendor-offline-setup.html` | §7.1, §7.2 | Vendor | Online enrollment, OTP pre-req, 6-digit PIN, offline access package (signed/encrypted), 4-hour window |
| 3 | Vendor Home | `vendor-home.html` | §4.4, §5, §9 | Vendor | View own inventory, vendor isolation (TenantId + VendorId), recall flags (read-only), action launcher |
| 4 | Scan Location | `vendor-scan-location.html` | §4.2 | Vendor | QR code scanning for tote location context, signed QR codes |
| 5 | Scan In | `vendor-scan-in.html` | §9.1, §8.2 | Vendor | Surgery date (mandatory, default +48h), quantity, emergency flag, GTIN matching, contract status display |
| 6 | Use | `vendor-use.html` | §9.2, §8.3 | Vendor | Status transitions: Used/Damaged/Expired/Missing/Wasted. No manual "Recalled" option (system-driven) |
| 7 | Keep | `vendor-keep.html` | §9.3, §10 | Vendor | Update surgery date, reset SLA window, event logged |
| 8 | Check Out | `vendor-checkout.html` | §9.4 | Vendor | Mark returned to warehouse, event logged, quantity selection |
| 9 | Reconcile Tote | `vendor-reconcile.html` | §9.5 | Vendor | Full tote scan, physical vs expected comparison, explicit discrepancy resolution, quarterly reminder, non-blocking |
| 10 | Offline Status + Queue | `vendor-offline-status.html` | §7.2, §7.3, §7.4 | Vendor | Countdown timer, event queue with eventId, FIFO sync, device timestamps, de-duplication |
| 11 | Offline Expired | `vendor-offline-expired.html` | §7.2 | Vendor | Hard block scanning, pending event preservation, reconnect requirement, compliance note (server sync time) |
| 12 | Conflict Resolution | `vendor-conflict-resolution.html` | §7.4, §17 | Vendor | Single-screen resolution (no wizard), local vs server comparison, eventId display, sync summary |
| 12a | Vendor Notifications | `vendor-notifications.html` | §8.3, §9.5, §7.2, §10 | Vendor | Recall alerts (read-only), SLA approaching warnings, quarterly reconciliation reminders, sync completion, terms updates |
| 13 | Hospital Dashboard | `hospital-dashboard.html` | §15, §10, §11, §12 | Hospital Admin | 6 dashboard metrics: Inventory, Compliance, Aging, Recall, Contract Value, Activity |
| 13a | Hospital Notifications | `hospital-notifications.html` | §10, §12, §9.5, §11, §7.4, §13 | Hospital Admin | FDA recall alerts, SLA breach/approaching, reconciliation reminders, audit discrepancies, contract upload results, vendor sync events |
| 14 | Recall Exposure View | `hospital-recall-exposure.html` | §12, §8.3, §15 | Hospital Admin | FDA recall flags, system-generated (not vendor-set), affected item/location details |
| 15 | Facilities Management | `hospital-facilities.html` | §4.2 | Hospital Admin | Manage facilities, view tote location counts, vendor counts, facility status |
| 16 | Tote Location Mgmt + QR | `hospital-tote-locations.html` | §4.2 | Hospital Admin | Manage tote locations, auto-generated signed QR codes, QR preview/print/download |
| 17 | SLA Configuration | `hospital-sla-config.html` | §10.1, §10.2 | Hospital Admin | Configurable threshold, emergency exclusion, compliance computation rules, SLA history |
| 18 | Items Master Upload | `hospital-contract-upload.html` | §11.1, §11.2 | Hospital Admin | CSV/XLSX upload, required columns (VendorId, GTIN, ContractPrice), matching precedence |
| 19 | Contract Dataset Mgmt | `hospital-contract-management.html` | §11, §11.3 | Hospital Admin | Active datasets, contract coverage %, out-of-contract items/value, match rates |
| 20 | Audit Mode | `hospital-audit-mode.html` | §13 | Hospital Admin | Location scan, expected vs physical, audit record generation, NO inventory modification |
| 21 | Reports | `hospital-reports.html` | §16 | Hospital Admin/RO | 6 report types: Inventory Snapshot, Compliance, Recall, Contract Value, Audit, Reconciliation |
| 22 | Tenant Provisioning Wizard | `admin-tenant-wizard.html` | §3.2, §3.3 | Armon Admin | Create tenant, provision DB, configure TenantId/Key, SLA defaults, domain allowlist, initial admin, temp password |
| 23 | Tenant List & Status | `admin-tenant-list.html` | §3.2, §3.4 | Armon Admin | Tenant list, status management (Draft/Provisioning/Ready/Live/Suspended), deactivation rules |
| 24 | Tenant Configuration | `admin-tenant-config.html` | §3.2, §2.1, §3.4 | Armon Admin | Tenant identity, DB isolation, SLA config, domain allowlist, status management, audit trail |

---

## 2. Spec Section Coverage

| Spec Section | Title | Wireframes Covering | Coverage |
|-------------|-------|---------------------|----------|
| §1 | Product Overview | All screens (purpose demonstrated) | ✅ Full |
| §2 | Deployment & Isolation | #22, #23, #24 | ✅ Full |
| §3 | Armon Admin Portal | #22, #23, #24 | ✅ Full |
| §3.2 | Admin Responsibilities | #22, #23, #24 | ✅ Full |
| §3.3 | Initial Credential Handling | #22 (wizard step 3) | ✅ Full |
| §3.4 | Deactivation | #23, #24 | ✅ Full |
| §4.1 | Armon Internal Admin | #22, #23, #24 | ✅ Full |
| §4.2 | Hospital Admin | #13-#21 | ✅ Full |
| §4.3 | Hospital Read-Only | #13, #14, #21 (same views, export-only) | ✅ Full |
| §4.4 | Vendor User | #1-#12 | ✅ Full |
| §5 | Vendor Isolation | #3 (enforced in queries) | ✅ Noted |
| §6.1 | Online Authentication | #1 | ✅ Full |
| §6.2 | Vendor Liability | #1 (step 3) | ✅ Full |
| §7.1 | Offline Enrollment | #2 | ✅ Full |
| §7.2 | Offline Expiration | #2, #10, #11 | ✅ Full |
| §7.3 | Offline Event Rules | #10 | ✅ Full |
| §7.4 | Sync Behavior | #10, #12 | ✅ Full |
| §8.1 | Event-Based Model | Implicit in all vendor screens | ✅ Noted |
| §8.2 | Item Attributes | #5 | ✅ Full |
| §8.3 | Item States | #6 | ✅ Full |
| §9.1 | Scan In | #5 | ✅ Full |
| §9.2 | Use | #6 | ✅ Full |
| §9.3 | Keep | #7 | ✅ Full |
| §9.4 | Check Out | #8 | ✅ Full |
| §9.5 | Reconcile Tote | #9 | ✅ Full |
| §10.1 | Compliance Rule | #7, #13, #17 | ✅ Full |
| §10.2 | SLA Configuration | #17 | ✅ Full |
| §10.3 | Reporting Scope | #13, #21 | ✅ Full |
| §11.1 | Upload Requirements | #18 | ✅ Full |
| §11.2 | Matching Precedence | #18 | ✅ Full |
| §11.3 | Contract Reporting | #19, #13 | ✅ Full |
| §12 | FDA Service Integration | #14, #13 | ✅ Full |
| §13 | Hospital Audit Mode | #20 | ✅ Full |
| §14 | Vendor Intelligence (Future) | N/A (future hook, no UI) | ⬜ Deferred |
| §15 | Dashboards | #13 | ✅ Full |
| §16 | Reports | #21 | ✅ Full |
| §17 | UX & Wireframe Constraints | All screens | ✅ Full |
| §18 | Wireframe Screen List | All 24 screens | ✅ Full |

---

## 3. UX Constraint Verification (§17)

| Constraint | Status | Evidence |
|-----------|--------|----------|
| Follow IRIS UX principles | ✅ | Consistent layout, color palette, component library from IRIS wireframes |
| Adhere to Microsoft Fluent design | ✅ | Segoe UI typography, Azure-inspired colors, Fluent component patterns |
| Vendor: Large primary actions | ✅ | vendor-action-btn class, 120px min-height touch targets |
| Vendor: Camera-first | ✅ | camera-area component on scan screens (#4, #5, #6, #7, #8, #9) |
| Vendor: Offline banner with countdown | ✅ | offline-banner class with countdown timer (#10, #11) |
| Vendor: Queue indicator | ✅ | queue-count badge on offline banner (#10, #11) |
| Vendor: Single-screen conflict resolution | ✅ | conflict-card with inline resolution (#12), no wizard |
| Hospital: Card-based metrics | ✅ | kpi-card components on dashboard (#13) |
| Hospital: Clear filters | ✅ | Filter bars on recall, locations, reports pages |
| Hospital: Strong recall/compliance indicators | ✅ | recall-item components (#14), compliance-meter (#13, #17) |
| Hospital: Contract value visibility | ✅ | Contract KPIs (#13), dedicated contract pages (#18, #19) |

---

## 4. Role-Permission Verification

### Hospital Admin (§4.2)

| Permission | Wireframe | Status |
|-----------|-----------|--------|
| Configure hospital + vendor domains | #24 (admin view) | ✅ |
| Manage facilities | #15 | ✅ |
| Manage tote locations | #16 | ✅ |
| Signed QR codes autogenerated | #16 | ✅ |
| Configure SLA thresholds | #17 | ✅ |
| Upload/manage Items Master Contract | #18, #19 | ✅ |
| View dashboards | #13 | ✅ |
| Export reports | #21 | ✅ |
| Perform audit scans | #20 | ✅ |
| View reconcile history | #13 (activity feed) | ✅ |
| Cannot perform vendor scanning | N/A (vendor screens separate) | ✅ |
| Cannot modify vendor event records | N/A (no edit actions on events) | ✅ |

### Hospital Read-Only (§4.3)

| Permission | Wireframe | Status |
|-----------|-----------|--------|
| View dashboards | #13 | ✅ |
| View compliance and recall | #14 | ✅ |
| Export reports | #21 | ✅ |

### Vendor User (§4.4)

| Permission | Wireframe | Status |
|-----------|-----------|--------|
| Login via OTP | #1 | ✅ |
| Enable offline mode (PIN) | #2 | ✅ |
| Scan In | #5 | ✅ |
| Use | #6 | ✅ |
| Keep | #7 | ✅ |
| Check Out | #8 | ✅ |
| Reconcile Tote (optional) | #9 | ✅ |
| View own vendor inventory | #3 | ✅ |
| View recall flags (read-only) | #3 | ✅ |
| Cannot view other vendors' data | N/A (vendor isolation §5) | ✅ |
| Cannot view hospital dashboards | N/A (separate nav) | ✅ |
| Cannot modify historical events | N/A (append-only model §8.1) | ✅ |

---

## 5. Items NOT in v1 Scope (Correctly Excluded)

| Item | Spec Reference | Status |
|------|---------------|--------|
| EMR/ERP Integration | §1.1 "TERRA does NOT integrate with EMR/ERP (v1)" | ✅ Not shown |
| Invoice Generation | §1.1 "TERRA does NOT generate invoices" | ✅ Not shown |
| PHI Storage | §1.1 "TERRA does NOT store PHI" | ✅ Not shown |
| Vendor SLA Analytics | §10.3 "Future release" | ✅ Not shown |
| Vendor Intelligence Platform | §14 "Future Hook" | ✅ Not shown |
| Vendor Dashboard | §15 "Vendor dashboard removed" | ✅ Not shown |

---

## 6. Notification Event Traceability

Notifications are surfaced via dedicated notification centers for each role. Each notification type maps to a specific spec requirement and links to the relevant operational wireframe.

### Hospital Notifications (`hospital-notifications.html`)

| Notification Type | Severity | Spec Reference | Links To | Description |
|-------------------|----------|---------------|----------|-------------|
| FDA Recall Alert | Critical | §12 FDA Service Integration | `hospital-recall-exposure.html` | System-generated recall flag from FDA data. Shows affected items, GTIN, vendor, locations. |
| SLA Breach | Critical | §10.1 Compliance Rule, §10.2 SLA Config | `hospital-sla-config.html` | Vendor items exceeding configured SLA threshold past surgery date. |
| SLA Approaching | Urgent | §10.1, §10.2 | `hospital-dashboard.html` | Items within warning window of SLA threshold. Recommends vendor Keep or Check Out. |
| Reconciliation Overdue | Urgent | §9.5 Reconcile Tote | `hospital-tote-locations.html` | Quarterly soft reminder for totes not reconciled in 90+ days. Non-blocking. |
| Audit Discrepancies | Urgent | §13 Hospital Audit Mode | `hospital-audit-mode.html` | Physical vs expected mismatches found during hospital audit scan. |
| Vendor Sync Complete | Info | §7.4 Sync Behavior | — | Offline event sync results including conflict resolution outcomes. |
| Contract Upload Result | Info | §11.1 Upload Requirements | `hospital-contract-management.html` | CSV/XLSX processing results: match rate, unmatched items. |
| Vendor Scan Activity | Info | §8.1 Event-Based Model | — | Daily summary of vendor scanning activity across tote locations. |
| Compliance Report Ready | Info | §10.3, §16 Reports | `hospital-reports.html` | Automated compliance report generation notification. |
| QR Code Generated | Info | §4.2 Tote Locations | `hospital-tote-locations.html` | Signed QR code auto-generated for new tote location. |

### Vendor Notifications (`vendor-notifications.html`)

| Notification Type | Severity | Spec Reference | Links To | Description |
|-------------------|----------|---------------|----------|-------------|
| Recall Flag | Critical | §8.3 (recall is system-generated), §12 | `vendor-home.html` | FDA recall flag on item in vendor's tote. Read-only — vendor cannot modify. |
| SLA Approaching | Warning | §10.1, §10.2 | `vendor-keep.html`, `vendor-checkout.html` | Items approaching SLA threshold. Vendor should Keep (update date) or Check Out. |
| Reconciliation Due | Warning | §9.5 Reconcile Tote | `vendor-reconcile.html` | Quarterly soft reminder. Non-blocking — can be snoozed. |
| Offline Sync Complete | Info | §7.4 Sync Behavior | — | Confirmation of FIFO sync with conflict resolution summary. |
| Terms Updated | Info | §6.2 Vendor Liability | — | New terms version available; re-acceptance required on next login. |

---

## 7. Email Template Traceability

All transactional email templates are previewed in `email-templates.html` with SendGrid template metadata.

| # | Template | Template ID | Spec Sections | Trigger | Recipients |
|---|----------|------------|---------------|---------|------------|
| E1 | OTP Verification | `terra-otp-v1.6` | §6.1 | User requests OTP login | Requesting user |
| E2 | Recall Alert | `terra-recall-alert-v1.6` | §12, §8.3 | FDA recall matches tote inventory via GTIN | Hospital Admin + affected vendors |
| E3 | SLA Breach Alert | `terra-sla-breach-v1.6` | §10.1, §10.2 | Items exceed SLA threshold | Hospital Admin |
| E4 | Session Summary | `terra-session-summary-v1.6` | §9.1–§9.4 | Vendor completes scan session | Vendor Rep + Hospital Admin |
| E5 | Offline Sync Report | `terra-offline-sync-v1.6` | §7.4, §7.3 | Vendor reconnects and syncs offline events | Vendor Rep + Hospital Admin |
| E6 | Contract Upload | `terra-contract-upload-v1.6` | §11.1, §11.2 | Hospital Admin uploads contract CSV/XLSX | Uploading Hospital Admin |
| E7 | Welcome/Onboarding | `terra-welcome-v1.6` | §3.3, §6.1, §6.2 | User added to tenant domain allowlist | New user |

---

*This traceability matrix confirms 100% coverage of all 24 wireframe screens specified in §18, supplemental notification centers (screens 12a and 13a), and 7 email notification templates against the Armon TERRA v1.6 Production & Wireframe Ready Specification.*