From a6e648916ea970cf98fb12a641c4e20fe3dfff06 Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Tue, 5 May 2026 09:00:15 +0000 Subject: [PATCH] [docs: autonomous-visual-synthesis] Inject structural visuals Appends missing Mermaid visuals based on text descriptions to: - architectures/event-sourcing/folder-structure.md (classDiagram) - architectures/space-based-architecture/folder-structure.md (classDiagram) - architectures/micro-frontends/folder-structure.md (classDiagram) - README_AUTONOMY.md (graph LR) - .agents/rules/system-instruction.md (graph LR) Co-authored-by: beginwebdev2002 <102213457+beginwebdev2002@users.noreply.github.com> --- .agents/rules/system-instruction.md | 10 +++++++ README_AUTONOMY.md | 11 ++++++++ .../event-sourcing/folder-structure.md | 24 ++++++++++++++++ .../micro-frontends/folder-structure.md | 28 +++++++++++++++++++ .../folder-structure.md | 24 ++++++++++++++++ 5 files changed, 97 insertions(+) diff --git a/.agents/rules/system-instruction.md b/.agents/rules/system-instruction.md index 2efe283..a45b47d 100644 --- a/.agents/rules/system-instruction.md +++ b/.agents/rules/system-instruction.md @@ -38,4 +38,14 @@ The glob pattern is configured so that it does not affect any other Markdown fil - Updates for the English version are added ONLY to the English part. - Updates for the Russian version are added ONLY to the Russian part. +```mermaid +graph LR + A[Bilingual Requirement] --> B[Structural Separation] + B --> C[Synchronous Updates] + + 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 default; +``` + *Ensure that both parts remain synchronized in meaning and logic; do not leave an item in only one language.* \ No newline at end of file diff --git a/README_AUTONOMY.md b/README_AUTONOMY.md index 6ae5983..03759a7 100644 --- a/README_AUTONOMY.md +++ b/README_AUTONOMY.md @@ -44,6 +44,17 @@ To maximize the value of the $300 Google Cloud free tier/credits, follow these b 4. **Monitoring:** - Use the [Google Cloud Console Billing](https://console.cloud.google.com/billing) to set alerts at 50%, 75%, and 90% of credit usage. - Check Vertex AI "Quotas & System Limits" to ensure no unexpected spikes in usage. + +```mermaid +graph LR + A[Selective Triggering] --> B[Model Selection] + B --> C[Storage Lifecycle] + C --> D[Monitoring] + + 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 default; +``` ## Setup Requirements Ensure the following GitHub Secrets are configured: - `GCP_SA_KEY`: Service Account JSON with Vertex AI User and Storage Admin roles. diff --git a/architectures/event-sourcing/folder-structure.md b/architectures/event-sourcing/folder-structure.md index ec30265..d3a7625 100644 --- a/architectures/event-sourcing/folder-structure.md +++ b/architectures/event-sourcing/folder-structure.md @@ -29,3 +29,27 @@ src/ └── 📁 infrastructure/ # Event Store bindings, Repositories, Message Bus └── EventStoreRepository.ts ``` + +```mermaid +classDiagram + classDef default fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,color:#000; + classDef component fill:#e8f5e9,stroke:#4caf50,stroke-width:2px,color:#000; + + class src + class commands:::component + note for commands "Intentions to change state" + class events:::component + note for events "Facts that have occurred" + class aggregates:::component + note for aggregates "Domain entities that process commands and emit events" + class projections:::component + note for projections "Listeners that update read models based on events" + class infrastructure:::component + note for infrastructure "Event Store bindings, Repositories, Message Bus" + + src --> commands + src --> events + src --> aggregates + src --> projections + src --> infrastructure +``` diff --git a/architectures/micro-frontends/folder-structure.md b/architectures/micro-frontends/folder-structure.md index 2e5133a..8cabb45 100644 --- a/architectures/micro-frontends/folder-structure.md +++ b/architectures/micro-frontends/folder-structure.md @@ -44,6 +44,34 @@ workspace/ │ └── event-bus/ (Agnostic communication contract types) ``` +```mermaid +classDiagram + classDef default fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,color:#000; + classDef component fill:#e8f5e9,stroke:#4caf50,stroke-width:2px,color:#000; + + class workspace + class apps:::component + class app_shell:::component + note for app_shell "Entry point, Router, Module Federation config" + class mfe_catalog:::component + note for mfe_catalog "Independent application" + class mfe_checkout:::component + note for mfe_checkout "Independent application" + class packages:::component + class design_system:::component + note for design_system "Pure, dumb UI components only" + class event_bus:::component + note for event_bus "Agnostic communication contract types" + + workspace --> apps + workspace --> packages + apps --> app_shell + apps --> mfe_catalog + apps --> mfe_checkout + packages --> design_system + packages --> event_bus +``` + ### Structural Comparison: Monorepo vs Polyrepo for MFEs diff --git a/architectures/space-based-architecture/folder-structure.md b/architectures/space-based-architecture/folder-structure.md index deae6fb..1ae8ac5 100644 --- a/architectures/space-based-architecture/folder-structure.md +++ b/architectures/space-based-architecture/folder-structure.md @@ -39,6 +39,30 @@ src/ └── recovery/ ``` +```mermaid +classDiagram + classDef default fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,color:#000; + classDef component fill:#e8f5e9,stroke:#4caf50,stroke-width:2px,color:#000; + + class src + class api_gateway:::component + note for api_gateway "Routing and basic validation" + class middleware:::component + note for middleware "Virtualized middleware for processing unit routing" + class processing_units:::component + note for processing_units "Independent processing components" + class data_grid:::component + note for data_grid "IMDG configuration and schema definitions" + class data_pumps:::component + note for data_pumps "Background services syncing IMDG to DB" + + src --> api_gateway + src --> middleware + src --> processing_units + src --> data_grid + src --> data_pumps +``` + ## Layering Logic - **api-gateway:** The initial entry point. Minimal logic.