From 6209ce8c8fcef6f07602b4b5c231da7c39c0c9d9 Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Sat, 16 May 2026 17:29:46 +0000 Subject: [PATCH] docs(arch): autonomous evolution of architecture blueprints Co-authored-by: beginwebdev2002 <102213457+beginwebdev2002@users.noreply.github.com> --- architectures/backend-for-frontend/readme.md | 2 +- .../backend-for-frontend/trade-offs.md | 2 +- .../event-driven-architecture/readme.md | 2 +- architectures/feature-sliced-design/readme.md | 2 +- .../hexagonal-architecture/readme.md | 2 ++ .../micro-frontends/folder-structure.md | 2 +- architectures/microservices/readme.md | 27 +++++++++++++++---- .../monolithic-architecture/readme.md | 2 +- 8 files changed, 30 insertions(+), 11 deletions(-) diff --git a/architectures/backend-for-frontend/readme.md b/architectures/backend-for-frontend/readme.md index 490df6f..e3d5546 100644 --- a/architectures/backend-for-frontend/readme.md +++ b/architectures/backend-for-frontend/readme.md @@ -28,7 +28,7 @@ This engineering directive defines the **best practices** for the Backend-For-Fr -### Structural Comparison: Backend-for-Frontend (BFF) vs API Gateway +### ⚖️ Structural Comparison: Backend-for-Frontend (BFF) vs API Gateway | Feature | Backend-for-Frontend (BFF) | API Gateway | | :--- | :--- | :--- | diff --git a/architectures/backend-for-frontend/trade-offs.md b/architectures/backend-for-frontend/trade-offs.md index f6d4f1b..0d20772 100644 --- a/architectures/backend-for-frontend/trade-offs.md +++ b/architectures/backend-for-frontend/trade-offs.md @@ -29,7 +29,7 @@ last_updated: 2026-03-29 4. **Maintenance Burden:** Requires frontend teams to have backend development and DevOps skills to maintain the BFF. -### Structural Comparison: Pros vs Cons +### ⚖️ Structural Comparison: Pros vs Cons | Category | Factor | Description | | :--- | :--- | :--- | diff --git a/architectures/event-driven-architecture/readme.md b/architectures/event-driven-architecture/readme.md index cabcc7d..a33653c 100644 --- a/architectures/event-driven-architecture/readme.md +++ b/architectures/event-driven-architecture/readme.md @@ -33,7 +33,7 @@ To deeply understand the nuances of EDA, consult the following specialized modul - 🛠️ [**Implementation Guide:** Code patterns and Anti-patterns](./implementation-guide.md) --- -### Structural Comparison: Event-Driven vs Request-Response +### ⚖️ Structural Comparison: Event-Driven vs Request-Response | Feature | Event-Driven Architecture | Request-Response (REST/RPC) | | :--- | :--- | :--- | diff --git a/architectures/feature-sliced-design/readme.md b/architectures/feature-sliced-design/readme.md index bf6870f..678314e 100644 --- a/architectures/feature-sliced-design/readme.md +++ b/architectures/feature-sliced-design/readme.md @@ -19,7 +19,7 @@ last_updated: 2026-03-22 This engineering directive contains strict architectural guidelines and 20 practical patterns for using the Feature-Sliced Design methodology to build scalable and deterministic Frontend applications. -### Structural Comparison: Feature-Sliced Design vs Clean Architecture +### ⚖️ Structural Comparison: Feature-Sliced Design vs Clean Architecture | Feature | Feature-Sliced Design (FSD) | Clean Architecture | | :--- | :--- | :--- | diff --git a/architectures/hexagonal-architecture/readme.md b/architectures/hexagonal-architecture/readme.md index 236bbe3..c5d1491 100644 --- a/architectures/hexagonal-architecture/readme.md +++ b/architectures/hexagonal-architecture/readme.md @@ -36,7 +36,9 @@ flowchart TD C -->|Requires Port| D(Adapter) D -->|Talks to| E[Database/External API] + %% Added Design Token Styles for Mermaid Diagrams classDef default fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,color:#000; + classDef component fill:#e8f5e9,stroke:#4caf50,stroke-width:2px,color:#000; class A,B,C,D,E default; ``` diff --git a/architectures/micro-frontends/folder-structure.md b/architectures/micro-frontends/folder-structure.md index 2e5133a..845bfbb 100644 --- a/architectures/micro-frontends/folder-structure.md +++ b/architectures/micro-frontends/folder-structure.md @@ -46,7 +46,7 @@ workspace/ -### Structural Comparison: Monorepo vs Polyrepo for MFEs +### ⚖️ Structural Comparison: Monorepo vs Polyrepo for MFEs | Feature | Monorepo (Workspace) | Polyrepo (Independent Repos) | | :--- | :--- | :--- | diff --git a/architectures/microservices/readme.md b/architectures/microservices/readme.md index f7cad4d..9761a18 100644 --- a/architectures/microservices/readme.md +++ b/architectures/microservices/readme.md @@ -24,7 +24,7 @@ This engineering directive defines the **best practices** for the Microservices - ⚖️ [**Trade-offs:** Pros, Cons, and System Constraints](./trade-offs.md) - 🛠️ [**Implementation Guide:** Code patterns and Anti-patterns](./implementation-guide.md) -### Structural Comparison: Microservices vs SOA (Service-Oriented Architecture) +### ⚖️ Structural Comparison: Microservices vs SOA (Service-Oriented Architecture) | Feature | Microservices | SOA | | :--- | :--- | :--- | @@ -50,12 +50,29 @@ graph LR +## Architecture Diagram + ```mermaid -graph LR - A[Isolation & Testability] --> B[Strict Boundaries] - B --> C[Decoupling] +graph TD + API[API Gateway] --> S1[Order Service] + API --> S2[Inventory Service] + API --> S3[User Service] + S1 --> DB1[(Order DB)] + S2 --> DB2[(Inventory DB)] + S3 --> DB3[(User DB)] + + %% Added Design Token Styles for Mermaid Diagrams classDef default fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,color:#000; - class A,B,C default; + classDef component fill:#e8f5e9,stroke:#4caf50,stroke-width:2px,color:#000; + classDef layout fill:#f3e5f5,stroke:#9c27b0,stroke-width:2px,color:#000; + + class API layout; + class S1 component; + class S2 component; + class S3 component; + class DB1 default; + class DB2 default; + class DB3 default; ``` ## 1. Shared Database Across Services diff --git a/architectures/monolithic-architecture/readme.md b/architectures/monolithic-architecture/readme.md index f52bad6..0975493 100644 --- a/architectures/monolithic-architecture/readme.md +++ b/architectures/monolithic-architecture/readme.md @@ -24,7 +24,7 @@ last_updated: 2026-03-22 - ⚖️ [**Trade-offs:** Pros, Cons, and System Constraints](./trade-offs.md) - 🛠️ [**Implementation Guide:** Code patterns and Anti-patterns](./implementation-guide.md) -### Structural Comparison: Monolithic Architecture vs Microservices +### ⚖️ Structural Comparison: Monolithic Architecture vs Microservices | Feature | Monolithic Architecture | Microservices | | :--- | :--- | :--- |