HWB-QMS-IT-015: Institutional Website Architecture Report

Document Control
Document Title	Institutional Website Architecture Report
Document ID	HWB-QMS-IT-015
Version	2.0.0
Status	APPROVED
Author	George (Systems Architect)
Approved By	Humberto Dominguez, CEO
Date	09/21/2026

1.0 Purpose

To formally document the finalized high-fidelity architecture of the HWB Cleaning Services LLC institutional website. This report serves as evidence of the successful migration to a cloud-native environment and the total decoupling from local OneDrive dependencies.

2.0 Architectural Standard (SigmaFidelity™)

2.1 Root-Level Synchronization

The repository has been restructured to follow the Azure-Root Standard. All primary entry points, dependency manifests, and operational logic now reside at the repository root to ensure seamless execution within the Azure App Service container.

2.2 OneDrive Decoupling

As of 2026-03-20, all hardcoded paths pointing to the local OneDrive mount (/mnt/c/Users/...) have been surgically removed. The application now utilizes dynamic BASE_DIR resolution to ensure 100% portability between development and production environments.

2.3 Database Sovereignty

All operational databases have been migrated from "Shadow IT" locations to the formal database/ directory within the Git-tracked repository: * sigma_leads.db: Institutional leads and AI analytics. * clients.db: Service schedules and Work Order management.

3.0 System Flow Diagram

graph TD subgraph GitHub_Official_Repo [GitHub: hwb-it-website/hwb-institutional-website] A[app.py: Entry Point] B[main_app.py: Logic Engine] C[database/ : Data Sovereign] D[static/ : Branding Assets] E[templates/ : HTML UI] end subgraph Azure_Cloud_Master [Azure App Service: hwb-institutional-website] F[Gunicorn: Production Server] G[Python 3.12 Runtime] H[Production Web Server] end I[CEO / Admin] -->|Git Push| GitHub_Official_Repo GitHub_Official_Repo -->|GitHub Actions| Azure_Cloud_Master Azure_Cloud_Master -->|Binds to PORT| H H -->|Public URL| J[www.hwbcleaning.com] subgraph Internal_Security K[.env: Managed Secrets] L[Azure App Settings: Injected Secrets] end K -.->|Sourced by| B L -.->|Injected into| G

4.0 Verification & Audit

OneDrive Search: Verified zero occurrences of OneDrive-specific path strings in main_app.py.
Azure Deployment: GitHub Actions confirmed successful build and deployment of the root-level architecture.
Access Control: New executive user hdominguez successfully registered in the cloud-deployed database.

5.0 Revision History

Version	Date	Author	Description
1.0	2026-03-20	George	Initial Release. Documentation of Cloud-Native Root Alignment.
2.0.0	09/21/2026	George (Systems Architect)	Modernized and upgraded to post-May 1st, 2026 baseline. Standardized under HWB-QMS-1.0 v2.0 (Everyday Words) and approved by Humberto Dominguez, CEO.

Produced by George under the SigmaFidelity™ Institutional Standard.

Document Structure