Appearance
Diagrams
Visual reference for the Microtec ERP platform architecture, data flows, and service relationships.
Tip: Mermaid diagrams in this documentation site render inline. Interactive HTML diagrams are hosted separately in the
/diagrams/folder of the docs site.
Interactive HTML Diagrams
These diagrams are generated as self-contained HTML files and hosted alongside the documentation site. Open them directly in a browser for the full interactive experience.
| Diagram | File | Description |
|---|---|---|
| Architecture Simulation | /diagrams/architecture-simulation.html | Full interactive node graph of all services with hover tooltips, clickable nodes, and live health status indicators |
| Architecture OS | /diagrams/architecture-os.html | Tab-based environment explorer — switch between dev / stage / preprod / uat / prod and see the actual resource names, SKUs, and costs |
| Architecture Docs | /diagrams/architecture-docs.html | Service documentation reference — click any service node to see its API contract, dependencies, and deployment config |
| Shared Services Analysis | /diagrams/shared-services.html | Deployment analysis report showing which services share infrastructure (SQL VM, Redis, Service Bus) across tenants |
How to open HTML diagrams
bash
# From the docs root — open in default browser
open /Users/mahmoudaraby/Projects/microtec/DevopsDocs/diagrams/architecture-simulation.html
# Or serve locally with Python
python3 -m http.server 8888 --directory /Users/mahmoudaraby/Projects/microtec/DevopsDocs
# Then open http://localhost:8888/diagrams/architecture-simulation.htmlMermaid Diagrams in Documentation
The following diagrams are embedded directly in documentation pages using Mermaid syntax.
| Diagram | Location | Type |
|---|---|---|
| Service Topology | This section | Graph — all 13 services with CAE placement and routing |
| Auth Flow | This section | Sequence — end-to-end authentication from browser to service |
| CI/CD Pipeline Flow | CI/CD section | Flowchart — branch to environment deployment logic |
| Networking Overview | Networking section | Graph — VNet topology, subnets, and peering |
| Data Flow | Data section | Flowchart — data ingress, processing, and storage paths |
Architecture Overview
Environment Topology (All Environments)
Naming Convention Quick Reference
Examples:
- Resource group:
mic-erp-be-dev-containers-rg - Container App:
mic-erp-be-dev-apps-portal - ACR (no dashes):
micerpbedevacr - Key Vault:
mic-erp-be-dev-skv
Related Sections
- Service Topology Diagram — detailed service graph with all connections
- Auth Flow Diagram — authentication sequence diagram
- Architecture Overview — written architecture documentation
- Networking — network topology details