feat: this commit introduces a section about repository structure to README.md

Author: https-richardy

README.md

@@ -6,3 +6,29 @@ Comanda is a SaaS platform designed to manage online orders and digital payments
 Comanda is architected around explicit bounded contexts, each one representing an independent system with its own lifecycle and deployment pipeline. Every boundary is deployable on its own, evolving autonomously without leaking concerns across domains.
 
 Rather than a traditional layered monolith, Comanda is structured as a distributed domain model organized within a modular monorepo. Each bounded context fully owns its business rules, infrastructure, tests, and operational workflows, ensuring strict domain isolation and long-term architectural integrity.
+
+
+---
+
+#### Repository Structure
+
+The repository is intentionally structured to reflect Comanda’s architectural boundaries and operational model.
+
+
+##### Boundaries
+
+Contains all bounded contexts (e.g., Comanda.Stores, Comanda.Subscriptions).
+Each directory represents an independent system with its own solution, source code, tests, Docker configuration, and deployment pipeline. Every boundary is designed to build, evolve, and deploy autonomously.
+
+##### Artifacts
+
+Holds internal reusable packages distributed as versioned NuGet artifacts (e.g., shared kernel, internal contracts). These packages are consumed as dependencies rather than project references, reinforcing decoupling between contexts.
+
+##### .github
+
+Defines CI/CD workflows. Each bounded context has isolated validation and deployment pipelines, ensuring independent lifecycle management.
+
+
+##### Root Configuration
+
+Includes global configuration files such as .editorconfig and nuget.config, enforcing consistent code standards and centralized package management across all contexts.