Update docs: Mermaid diagrams, current verification state

- Replace ASCII art with Mermaid in architecture-design-company-inc.md - Rewrite architecture-hld.md with 3 Mermaid diagrams (infra, CI/CD, security) - Remove draw.io/Lucidchart references - Update verification-log.md with current passing state Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-19 19:45:47 +00:00
parent 2ee57f0093
commit d5b2bd2aa4
3 changed files with 129 additions and 120 deletions
@@ -58,23 +58,17 @@ This document outlines a robust, scalable, secure, and cost-effective infrastruc

 ### 3.3 Network Topology (High-Level)

-```
-Internet
-    |
-    v
-[Cloud Load Balancer] (HTTPS)
-    |
-    v
-[GKE Ingress Controller]
-    |
-    v
-[VPC Private Subnets]
-    |
-    +-- [GKE Cluster - API Pods]
-    +-- [GKE Cluster - Frontend Pods]
-    |
-    v
-[Private connectivity to MongoDB]
+```mermaid
+flowchart TD
+    Internet((Internet))
+    Internet --> LB[Cloud Load Balancer<br/>HTTPS termination]
+    LB --> Ingress[GKE Ingress Controller]
+
+    subgraph VPC["VPC — Private Subnets"]
+        Ingress --> API[API Pods<br/>Python / Flask]
+        Ingress --> SPA[Frontend Pods<br/>React SPA]
+        API --> DB[(MongoDB<br/>Private Endpoint)]
+    end
 ```

 ---
@@ -146,43 +140,31 @@ Internet

 ## 6. High-Level Architecture Diagram

-The following diagram illustrates the main components (implement in draw.io or Lucidchart):
+```mermaid
+flowchart TB
+    Users((Users))

-```
-+------------------------------------------------------------------+
-|                         COMPANY INC. INFRASTRUCTURE               |
-+------------------------------------------------------------------+
+    Users --> CDN[Cloud CDN<br/>Static Assets]
+    Users --> LB[Cloud Load Balancer<br/>HTTPS]

-    [Users]
-        |
-        v
-+-------------------+     +-------------------+
-|  Cloud CDN        |     |  Cloud LB (HTTPS) |
-|  (Static Assets) |     |  (API + SPA)      |
-+-------------------+     +-------------------+
-        |                         |
-        v                         v
-+------------------------------------------------------------------+
-|  GKE CLUSTER (Private)                                           |
-|  +------------------+  +------------------+  +-----------------+ |
-|  | Ingress          |  | Backend (Flask)  |  | Frontend (SPA)  | |
-|  | Controller       |  | - HPA            |  | - Nginx/React   | |
-|  +------------------+  +------------------+  +-----------------+ |
-|        |                       |                       |        |
-|        +-----------------------+-----------------------+        |
-|                                |                                |
-|  +------------------+  +------------------+                     |
-|  | Redis (cache)    |  | Observability    |                     |
-|  | (Memorystore)    |  | (Prometheus/Grafana)                    |
-|  +------------------+  +------------------+                     |
-+------------------------------------------------------------------+
-        |
-        v
-+------------------------------------------------------------------+
-|  MongoDB Atlas (GCP)  |  Secret Manager  |  Artifact Registry  |
-|  - Replica Set       |  - App secrets   |  - Container images |
-|  - Private endpoint  |  - DB credentials|                     |
-+------------------------------------------------------------------+
+    subgraph GKE["GKE Cluster — Private"]
+        LB --> Ingress[Ingress Controller]
+        Ingress --> API[Backend — Flask<br/>HPA 2–3 replicas]
+        Ingress --> SPA[Frontend — React SPA<br/>Nginx]
+        CDN --> SPA
+        API --> Redis[Redis<br/>Memorystore]
+        API --> Obs[Observability<br/>Prometheus / Grafana]
+    end
+
+    subgraph Data["Managed Services"]
+        Mongo[(MongoDB Atlas<br/>Replica Set · Private Endpoint)]
+        Secrets[Secret Manager<br/>App & DB credentials]
+        Registry[Artifact Registry<br/>Container images]
+    end
+
+    API --> Mongo
+    API --> Secrets
+    GKE --> Registry
 ```

 ---
@@ -200,4 +182,4 @@ The following diagram illustrates the main components (implement in draw.io or L

 ---

-*This document should be accompanied by an HLD diagram (draw.io or Lucidchart) reflecting the architecture above.*
+*See [architecture-hld.md](architecture-hld.md) for the standalone HLD diagram.*