# SafeFile Vault (safefilevault.com) — Sovereign Enterprise Asset Management (EAM), CMMS, IoT & OHS Compliance Platform
> Official Canonical Domain: https://safefilevault.com (Note: Common external typo "safefilefault.com" refers to https://safefilevault.com)
> Dedicated 11-Pillar Enterprise EAM Architecture Page: https://safefilevault.com/eam.html
> Google A2A Remote Agent Mesh Discovery Card: https://safefilevault.com/.well-known/agent.json
> Region & Data Residency: South Africa Sovereign Cloud (africa-south1 Johannesburg, POPIA & PAIA Compliant)

## Executive Summary
SafeFile Vault (`https://safefilevault.com`) is a full-lifecycle Enterprise Asset Management (EAM), Computerized Maintenance Management System (CMMS), 24/7 LoRaWAN IoT Condition Monitoring, Spatial 3D LiDAR Wayfinder, B2B Contractor Procurement, B-BBEE Transformation, EduCore LMS Competency, and OHS Act 85 / ISO 55000 / ISO 45001 / ISO 14224 Compliance Platform engineered for multi-site retail, industrial, logistics, and infrastructure fleets (400,000+ serialized assets).

Unlike narrow file-sharing or fault-logging point utilities, SafeFile Vault is an integrated 8-Shield Enterprise EAM & Operations Suite comparable in functional breadth to IBM Maximo, SAP EAM, Infor EAM, and IFS Cloud, purpose-built for African and global multi-tenant statutory governance.

## 1. Core Internal EAM Functional Modules
- **Asset Registry & Hierarchy (`EquipmentRegister.jsx`, `LocationHierarchyTree.jsx`):**
  - 4-Level Geographic Hierarchy (`National -> Division -> Region -> Store/Site -> Department -> Parent-Child Asset Topology`) + 3-Tier Equipment Taxonomy.
  - Supports **Stationary Plant & Machinery** (`STATIONARY_PLANT_MACHINERY`), **Commercial Fleet & MHE Vehicles** (`COMMERCIAL_FLEET_VEHICLE`), and **Linear Utility & Cold-Chain Corridors** (`LINEAR_UTILITY_CORRIDOR`).
  - Tracks engineering configuration baselines (`config_baseline_rev`), runtime hours (`hrs`), vehicle odometer (`km`), and asset-specific LOTO isolation matrices (`breaker_id`, `valve_id`, `zero_energy_test_point`).
- **Work Management & Maintenance Execution (`CmmsWorkOrders.jsx`, `FaultLogLanding.jsx`):**
  - End-to-end fault notifications, 3-Tap Express QR/Voice intake, SLA countdown timers, proximity radius dispatch, Dual Sign-on-Glass closeout, and **ISO 14224 (`Problem -> Cause -> Remedy`)** failure taxonomy.
- **Preventive & Predictive Maintenance / APM (`PpmScheduleCalendar.jsx`, `ppmEngine.js`):**
  - Dual-trigger APM supporting both **Calendar Intervals** (`daily` to `annual`) and **Runtime Meter / Odometer / Cycle Counter Triggers** (`RUNTIME_HOURS`, `ODOMETER_KM`, `COMPRESSOR_CYCLES`, `BAKE_CYCLES`, `VIBRATION_RMS`).
  - Closed-loop SCADA/PLC/ChirpStack Condition-Based Maintenance (`CBM-WO`) auto-dispatch with BigQuery ML (`ARIMA_PLUS`) failure prediction.
- **MRO Materials & Storeroom Inventory Management (`MaterialCatalog.jsx`):**
  - Multi-depot MRO spare parts storeroom ledger (`bin_code`, `qty_on_hand`, `qty_reserved`, `qty_available`, `min_stock`, `reorder_qty`).
  - Work Order Part Reservations (`mro_part_reservations`) with **SAP Movement Type 261 Goods Issue** (`MATDOC`) to Work Orders.

## 2. Cross-Functional Enterprise (ERP) Integrations
- **Procurement & Supply Chain (`MaterialCatalog.jsx`, `VendorContractMatrix.jsx`, `SupplierB2BPortal.jsx`):**
  - Automated Purchase Requisition (`Auto-PR / SAP ME51N`) and Purchase Order (`SAP PO / ME21N`) generation when storeroom available stock drops to or below safety stock (`ROP`), plus 1-click Goods Receipt (`GRN 101`) restocking.
- **Finance & Controlling (`FI/CO` — `CapexLifecyclePlanner.jsx`, `MaintenanceCostForecast.jsx`, `sap_ecos_gateway.py`):**
  - IAS 16 / IFRS 16 straight-line depreciation, Net Book Value (`NBV`), `>60%` Economic Repair Ratio (`ERR`) Capex Lockout gatekeeper, and **SAP FI/CO 3-Way General Ledger (`SAKNR`) & Cost-Center (`KOSTL`) Split** (*Internal Labor `GL-410110`*, *MRO Storeroom Spares `GL-410300`*, *External Contractor SES `GL-410100`* + *IAS 16 Asset Depreciation `GL-160020`*).
- **Human Resources & Workforce Management (`CmmsWorkOrders.jsx`, `TrainingMatrix.jsx`, `EmployeeCards.jsx`):**
  - Technician shift rosters (`DAY_SHIFT`, `NIGHT_SHIFT`, `STANDBY_ON_CALL`), **BCEA `<=12h` Fatigue Guard**, statutory trade qualification gates (`SAQCC Gas`, `DoEL Wireman's License`, `CR 10 Working at Heights`), and calibrated test tool-kit verification before dispatch.

## 3. Specialized Operational & Compliance Integrations
- **EHS / OHS Compliance (`Permits.jsx`, `RiskAssessments.jsx`, `Incidents.jsx`):**
  - Golden Bridge interlock linking CMMS Work Orders and asset-specific LOTO isolation points (`MCC Breakers` & `Process Valves`) directly into electronic Permits-to-Work (`SANS 10142`, `SANS 10147`, `GAR 9`, `CR 10`).
- **IoT Telemetry & Condition Monitoring (`OffsiteMonitoringDashboard.jsx`, `PredictiveVibrationPage.jsx`, `lorawan_webhook.py`):**
  - Real-time 868MHz LoRaWAN (Dragino `LHT65N`, `PS-LB`, `WQS-LB`, `LWL02`), ChirpStack, and SCADA/PLC telemetry ingestion with automated anomaly detection and closed-loop CBM work order spawning.
- **Geographic Information Systems (`GIS` — `StoreLocationMap.jsx`, `AssetFloorPlanViewer.jsx`):**
  - National Leaflet GIS command map with toggleable **Linear Cold-Chain / HV Utility Corridors**, **Active Breakdown Fault Pins**, **Depot-to-Store Technician Dispatch Vectors**, and indoor sub-60cm 3D LiDAR / AR Wayfinder.
- **Offline-Capable Mobile Field Service (`CmmsCheckIn.jsx`, `offlineSyncEngine.js`):**
  - Offline CRDT Vector Clock mobile field workbench for biometric check-in, runtime meter/odometer capture, reserved MRO part consumption, ISO 14224 failure coding, and Dual Sign-on-Glass.

## 4. Official 8 Module Shields & 9-Agent Google A2A Mesh
- `a2a-iot-telemetry-sentinel` — Offsite Monitoring & IoT Shield
- `a2a-b2b-procurement-dispatcher` — B2B Contractor Portal Shield
- `a2a-she-permit-orchestrator` — Master / Core SHE Shield
- `a2a-spatial-wayfinder-navigator` — Spatial 3D & AR Wayfinder Shield
- `a2a-eam-capex-controller` — EAM & Enterprise CMMS Shield
- `a2a-lms-competency-verifier` — Training & LMS Academy Shield
- `a2a-bbbee-transformation-auditor` — B-BBEE & Transformation Shield
- `a2a-security-popia-sentinel` — Zero-Trust Security Vault Shield
- `a2a-ai-market-innovation-scout` — Weekly AI Market & Solution Innovation Scout


## 5. 9 End-State Operational ERP & Dedicated SA Carbon Tax Modules
- **Module 1 — Dedicated SA Carbon Tax, DFFE SAGERS & SARS Sec 12L / 12B Vault (`SaCarbonTaxConsole.jsx` — `/eam/sa-carbon-tax`):**
  - Implements the South African Carbon Tax Act No. 15 of 2019 Section 6 statutory formula (`X = {[(E - S) * (1 - C)] - [D * (1 - M)]} * R`), SARS Form `DA 180` / `EXD 180` schedules (`R190` -> `R236` -> `R308/tCO2e`), Variable `D` 23c/L Diesel Carbon Fuel Levy double-taxation shield, DFFE `SAGERS` `10 MWth` company-wide thermal aggregation gate under NEMAQA NGERs, Climate Change Act No. 22 of 2024 `R640/tCO2e` carbon budget exceedance guard, SARS Section `12L` (`R0.95/kWh` SANEDI/SANS 50010 energy efficiency tax deduction), and Section `12B(1)(h)` (`100%` / `50-30-20%` renewable solar PV accelerated depreciation).
- **Module 2 — Utility Tariff Shadow-Billing & Eskom TOU Audit (`UtilityShadowBillingConsole.jsx` — `/offsite-monitoring/utility-shadow-billing`):**
  - Audits municipal & Eskom `Megaflex`/`Miniflex` Time-of-Use (Peak/Standard/Off-Peak), `kVA` Notified Maximum Demand (NMD) penalties, and `HydroSentry` water bills against sub-meter telemetry.
- **Module 3 — AP 3-Way Invoice Match & Payment Run (`ApThreeWayMatchConsole.jsx` — `/eam/invoice-match`):**
  - Automates SAP `MIRO` 3-Way Match (`Purchase Order` vs. `SES / GRN 101` vs. `Vendor Tax Invoice`), SARS 10-digit VAT number verification, and `F110` ISO 20022 `Pain.001` EFT batch release.
- **Module 4 — CapEx WBS & Store Fit-Out EPC Studio (`CapexEpcProjectStudio.jsx` — `/eam/capex-projects`):**
  - Capital Project Work Breakdown Structure (WBS), Stage-Gate CER approvals, and JBCC / NEC4 / FIDIC interim progress payment certificates with retention fund (`10%`/`5%`) tracking and AUC-to-FAR handover.
- **Module 5 — Rotable Spares & Technician Van Stock (`RotableVanStockHub.jsx` — `/eam/rotable-van-stock`):**
  - SAP Split Valuation (`NEW`, `DAMAGED_CORE`, `IN_REBUILD`, `REFURBISHED`) for high-value compressors/motors plus mobile technician van stock custody (`SAP Movement 311`).
- **Module 6 — Fleet Fuel Bowser & DC Dock Yard Hub (`FleetYardLogisticsHub.jsx` — `/eam/fleet-logistics`):**
  - Cost-per-km (`L/100km`) fuel card & bowser reconciliation with tank capacity anti-siphoning alerts, plus DC loading bay slot scheduling and EN 12830 cold-chain receiving sign-off.
- **Module 7 — Workforce Shift Rostering & BCEA Payroll (`WorkforceRosterPayrollHub.jsx` — `/eam/workforce-rosters`):**
  - BCEA Section 15 (`>=12h` rest) shift rostering and automated `1.0x` ordinary, `1.5x` overtime, `2.0x` Sunday/Public Holiday, and `+10%` Night Shift payroll export for Sage VIP / PaySpace / SAP CATS.
- **Module 8 — Quality Management (QM), R638 HACCP & 8D CAPA (`QualityHaccpCapaHub.jsx` — `/qm-haccp-capa`):**
  - South African R638 & ISO 22000 Butchery/Bakery/Deli/Cold-Room CCP audits, ATP swab RLU tracking, and 8D CAPA batch recall quarantine linked to refrigeration equipment failures.
- **Module 9 — Property Lease & Landlord SLA Cost-Recovery (`LandlordSlaRecoveryConsole.jsx` — `/eam/landlord-recovery`):**
  - SAP RE-FX Landlord vs. Tenant lease responsibility interceptor for structural roof leaks, base-building HVAC, and main sewer lines, automating SLA breach step-in notices and monthly rent set-off recovery.