# josejesusguzman/acordeon-az900-innovaccion architecture

> Architecture diagram of the GitHub repository josejesusguzman/acordeon-az900-innovaccion, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-04-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/josejesusguzman/acordeon-az900-innovaccion
- Repository: https://github.com/josejesusguzman/acordeon-az900-innovaccion

## Overview

1. **Repository role**
   - This is not an application codebase; it is a **static study/content repository** for the AZ-900 Microsoft Fundamentals certification, curated for Innovacción Virtual.
   - The repository’s main output is documentation and learning materials rather than a runtime service.

2. **Publishing model**
   - The presence of **`_config.yml`** strongly suggests the content is intended for **GitHub Pages / Jekyll-style static publishing**.
   - The README acts as the landing page and learning hub, while the markdown and media files under `res/` provide the supporting pages/assets.

3. **Top-level structure**
   - **`README.md`**: primary entry point; describes the study method, weekly learning path, links, and contributor info.
   - **`res/`**: the main content library.
   - **`.gitignore`**: standard repository hygiene.
   - **`_config.yml`**: site configuration for static site generation/publishing.

4. **Learning-path subsystem**
   - The README is organized into **weeks and modules**:
     - Week 1: Azure fundamentals and core concepts
     - Week 2: compute, networking, storage, databases
     - Week 3: administration, AI/ML, IoT, serverless, monitoring
     - Week 4: security, identity, governance, privacy, compliance
     - Week 4 also includes SLA and cost management
   - This structure is the core navigation model of the repo.

5. **Reference-content subsystem**
   - Under `res/`, the repo contains many **self-contained markdown guides/comparisons**:
     - Azure terminology and glossary files
     - Service comparisons such as compute, networking, security, Azure AD, Cognitive Services, Sentinel/Sphere, Advisor/Monitor/Log Analytics/Service Health
     - Governance and compliance notes
     - Cloud adoption framework steps
   - These files act as the “knowledge base” behind the study path.

6. **Hands-on lab subsystem**
   - Several resources point to **practical exercises**, such as:
     - SQL queries for Azure SQL Database
     - ARM template creation
     - SLA calculations
     - Machine Learning Studio exercise
     - Kubernetes / WordPress tutorials
   - Some labs are embedded in this repo as markdown; others link out to external GitHub repositories or videos.

7. **Media and asset subsystem**
   - `res/images/` contains visual learning assets, including concept diagrams and tutorial-specific images.
   - `res/docs/` contains downloadable office/PDF assets such as:
     - glossary PDFs
     - a business outcome template spreadsheet
     - a Cloud Adoption Framework strategy template
   - These assets support the textual study materials and are part of the static content boundary.

8. **External service boundary**
   - The repo heavily depends on **external learning and tooling platforms** rather than internal services:
     - Microsoft Learn challenge modules
     - Azure pricing calculator and TCO calculator
     - Azure SLA pages
     - Spotify playlists/podcasts
     - Miro boards
     - Microsoft Stream recordings
     - GitHub-hosted companion labs
     - Azure sponsorship portal and mobile Azure apps
   - The repository is therefore a **curated navigation layer** over external content.

9. **Azure domain coverage**
   - The content maps directly to AZ-900 domains:
     - cloud concepts
     - core Azure services
     - solutions/management tools
     - security and networking
     - identity/governance/privacy/compliance
     - cost management and SLAs
   - This makes the repo a certification-focused knowledge graph rather than a general documentation site.

10. **Contribution workflow**
   - The README explicitly invites users to contribute through **pull requests** and **issues** for content additions or corrections.
   - A concrete example is the playlist contribution flow via `res/adiciones-playlist.md`.
   - This indicates a community-maintained content repository with editorial review, not an automated software pipeline.

11. **Important architectural boundary**
   - There is **no application backend, database, or API layer** in this repository.
   - The main system boundary is between:
     - **static curated content in the repo**
     - and **external interactive resources/labs/platforms** the learners use alongside it.

12. **How to diagram it**
   - A correct architecture diagram would show:
     - one static content repository/site at the center
     - grouped content domains under it: weeks/modules, glossary, comparisons, labs, media/docs
     - multiple outbound links to Microsoft Learn and other external tools
     - contribution input from the community via PRs/issues
   - The repo’s purpose is to **organize and publish study assets**, not to execute application logic.

Main entry points: [`res`](https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res) (Content library), [`README.md`](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md) (Weekly path), [`_config.yml`](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/_config.yml) (Jekyll config), [`res/terminos_azure.md`](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/res/terminos_azure.md) (Glossary)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_root["Repository"]
  node_readme["README<br/>landing guide<br/>[README.md]"]
  node_config["Jekyll config<br/>site config<br/>[_config.yml]"]
  node_community(("Contrib workflow<br/>collaboration<br/>[README.md]"))
end

subgraph group_content["Study Content"]
  node_content_library["Content library<br/>markdown corpus"]
  node_learning_path["Weekly path<br/>curriculum<br/>[README.md]"]
  node_azure_basics["Azure basics<br/>[README.md]"]
  node_core_services["Core services<br/>[README.md]"]
  node_management_tools["Mgmt tools<br/>[README.md]"]
  node_security_governance["Security & gov<br/>[README.md]"]
  node_comparisons["Comparisons<br/>reference set"]
  node_glossary["Glossary<br/>reference guide<br/>[terminos_azure.md]"]
  node_labs["Hands-on labs<br/>exercise set"]
  node_sla_cost["SLA & cost<br/>study module"]
  node_governance_notes["Governance notes<br/>reference guide"]
end

subgraph group_assets["Assets"]
  node_media["Images<br/>asset library"]
  node_docs["Documents<br/>asset library"]
end

subgraph group_external["External Platforms"]
  node_microsoft_learn["MS Learn<br/>external learning"]
  node_azure_calculators["Calculators<br/>external tool"]
  node_azure_sla["Azure SLA<br/>external reference"]
  node_companion_labs["Companion labs<br/>external repo"]
  node_media_tools["Media tools<br/>external media"]
  node_azure_mobile["Azure apps<br/>external tool"]
end

node_config -->|"publishes"| node_content_library
node_readme -->|"organizes"| node_learning_path
node_learning_path -->|"week 1"| node_azure_basics
node_learning_path -->|"week 2"| node_core_services
node_learning_path -->|"week 3"| node_management_tools
node_learning_path -->|"week 4"| node_security_governance
node_content_library -->|"contains"| node_comparisons
node_content_library -->|"contains"| node_glossary
node_content_library -->|"contains"| node_labs
node_content_library -->|"contains"| node_sla_cost
node_content_library -->|"contains"| node_governance_notes
node_content_library -->|"supports"| node_media
node_content_library -->|"supports"| node_docs
node_comparisons -->|"covers"| node_azure_basics
node_comparisons -->|"covers"| node_core_services
node_labs -.->|"links to"| node_companion_labs
node_labs -.->|"references"| node_microsoft_learn
node_sla_cost -.->|"uses"| node_azure_calculators
node_sla_cost -.->|"uses"| node_azure_sla
node_governance_notes -.->|"references"| node_microsoft_learn
node_community -->|"updates"| node_content_library
node_readme -->|"invites"| node_community
node_readme -.->|"references"| node_media_tools
node_readme -.->|"references"| node_azure_mobile

click node_readme "https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md"
click node_config "https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/_config.yml"
click node_content_library "https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res"
click node_learning_path "https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md"
click node_azure_basics "https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md"
click node_core_services "https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md"
click node_management_tools "https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md"
click node_security_governance "https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md"
click node_comparisons "https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res"
click node_glossary "https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/res/terminos_azure.md"
click node_labs "https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res"
click node_sla_cost "https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res"
click node_governance_notes "https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res"
click node_media "https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res/images"
click node_docs "https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res/docs"
click node_community "https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme,node_config,node_community toneBlue
class node_content_library,node_learning_path,node_azure_basics,node_core_services,node_management_tools,node_security_governance,node_comparisons,node_glossary,node_labs,node_sla_cost,node_governance_notes toneAmber
class node_media,node_docs toneMint
class node_microsoft_learn,node_azure_calculators,node_azure_sla,node_companion_labs,node_media_tools,node_azure_mobile toneRose
```

## Components

### Repository

Static publishing and entry points

- [README](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md): landing guide · Primary study hub and navigation for the certification path · `README.md`
- [Jekyll config](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/_config.yml): site config · Static publishing configuration for GitHub Pages/Jekyll · `_config.yml`
- [Contrib workflow](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md): collaboration · Issue and pull-request driven content updates · `README.md`

### Study Content

Learning path, guides, and exercises

- [Content library](https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res): markdown corpus · Main knowledge base of curated AZ-900 study materials · `res`
- [Weekly path](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md): curriculum · Week-by-week structure covering AZ-900 domains · `README.md`
- [Azure basics](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md): module · Cloud concepts and core Azure foundation topics · `README.md`
- [Core services](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md): module · Compute, networking, storage, and database coverage · `README.md`
- [Mgmt tools](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md): module · Administration, monitoring, AI/ML, IoT, and serverless topics · `README.md`
- [Security & gov](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/README.md): module · Identity, security, governance, privacy, compliance, cost, and SLA topics · `README.md`
- [Comparisons](https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res): reference set · Service comparison guides for Azure decision-making · `res`
- [Glossary](https://github.com/josejesusguzman/acordeon-az900-innovaccion/blob/main/res/terminos_azure.md): reference guide · Terminology and definitions for AZ-900 study · `res/terminos_azure.md`
- [Hands-on labs](https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res): exercise set · Practical exercises and tutorials embedded in markdown · `res`
- [SLA & cost](https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res): study module · Service level, pricing, and cost-management exercises · `res`
- [Governance notes](https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res): reference guide · Compliance and cloud adoption framework guidance · `res`

### Assets

Documents and images supporting study materials

- [Images](https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res/images): asset library · Concept diagrams and tutorial imagery · `res/images`
- [Documents](https://github.com/josejesusguzman/acordeon-az900-innovaccion/tree/main/res/docs): asset library · PDF, spreadsheet, and template resources · `res/docs`

### External Platforms

Outbound learning and tooling destinations

- **MS Learn**: external learning · Challenge modules and official learning content
- **Calculators**: external tool · Pricing and TCO calculators used in study material
- **Azure SLA**: external reference · Official SLA pages for service availability study
- **Companion labs**: external repo · GitHub-hosted lab repositories and exercises
- **Media tools**: external media · Playlists, podcasts, boards, and recordings supporting learning
- **Azure apps**: external tool · Azure portal and mobile app resources referenced by the repo

## Connections

- Jekyll config → Content library: publishes · Configures static site publishing for the study content
- README → Weekly path: organizes · README structures the week-by-week curriculum
- Weekly path → Azure basics: week 1 · Cloud fundamentals and Azure concepts
- Weekly path → Core services: week 2 · Core services and infrastructure topics
- Weekly path → Mgmt tools: week 3 · Management, AI/ML, IoT, and automation topics
- Weekly path → Security & gov: week 4 · Security, governance, compliance, and cost topics
- Content library → Comparisons: contains · Comparison guides across major Azure services
- Content library → Glossary: contains · Terminology and definition references
- Content library → Hands-on labs: contains · Practical exercises and tutorial markdown
- Content library → SLA & cost: contains · SLA and cost-management study resources
- Content library → Governance notes: contains · Compliance and adoption framework notes
- Content library → Images: supports · Visual learning assets for diagrams and tutorials
- Content library → Documents: supports · Downloadable PDFs, spreadsheets, and templates
- Comparisons → Azure basics: covers · Comparison guides reinforce core Azure concepts
- Comparisons → Core services: covers · Service comparisons for compute, networking, storage, and security
- Hands-on labs → Companion labs: links to · Some exercises point to external companion repositories
- Hands-on labs → MS Learn: references · Exercises and challenges use official learning modules
- SLA & cost → Calculators: uses · Pricing and TCO calculators support cost studies
- SLA & cost → Azure SLA: uses · Official SLA pages back availability exercises
- Governance notes → MS Learn: references · Governance and adoption content aligns to Microsoft guidance
- Contrib workflow → Content library: updates · Pull requests and issues contribute corrections and additions
- README → Contrib workflow: invites · README documents the contribution workflow
- README → Media tools: references · Curated playlists, boards, and recordings supplement study
- README → Azure apps: references · Mentions Azure portal and mobile app resources
