google-adk-python

| I am a... | Start Here | Learn More |

| ----------------- | ---------------------------------------------- | ------------------------------------------------- |

| New Developer | [Getting Started](docs/getting-started.md) | [Learning Paths](docs/learning-paths.md) |

| Backend Dev | [Backend Quickref](docs/backend-quickref.md) | [CLAUDE.md Patterns](CLAUDE.md#backend-patterns) |

| Frontend Dev | [Frontend Quickref](docs/frontend-quickref.md) | [CLAUDE.md Patterns](CLAUDE.md#frontend-patterns) |

| AI Agent | [CLAUDE.md](CLAUDE.md) | [docs/claude/](docs/claude/) |

---

Easy.Platform provides a complete foundation for enterprise application development:

• Clean Architecture: Four-layer architecture (Domain, Application, Infrastructure, Presentation) ensuring separation of concerns and testability
• CQRS Pattern: Command Query Responsibility Segregation with fluent validation and event-driven side effects
• Event-Driven Architecture: Domain events and RabbitMQ message bus for cross-service communication
• Multi-Database Support: MongoDB, SQL Server, PostgreSQL with unified repository patterns
• Angular Integration: PlatformVmStore state management, base components, and reactive forms

The framework is battle-tested in production enterprise applications and provides patterns for common challenges like background jobs, data migrations, authorization, and multi-tenancy.

---

```bash

# Backend

dotnet run --project src/Backend/PlatformExampleApp.TextSnippet.Api

# Frontend

cd src/Frontend && npm install && nx serve playground-text-snippet

# Infrastructure

docker-compose -f src/platform-example-app.docker-compose.yml up -d

```

> Detailed setup: [Getting Started Guide](docs/getting-started.md)

---

| Doc | Purpose |

| ------------------------------------------------------ | ----------------------------------------------- |

| [Getting Started](docs/getting-started.md) | Prerequisites, setup, commands, troubleshooting |

| [Architecture Overview](docs/architecture-overview.md) | System design, project structure, diagrams |

| [Backend Quickref](docs/backend-quickref.md) | Backend decision tree and key patterns |

| [Frontend Quickref](docs/frontend-quickref.md) | Frontend decision tree and key patterns |

| [Learning Paths](docs/learning-paths.md) | Developer onboarding by role |

| [CLAUDE.md](CLAUDE.md) | Complete code patterns, AI agent instructions |

| [Business Features](docs/BUSINESS-FEATURES.md) | Module documentation, features, APIs |

> Business Documentation: For detailed business module documentation (requirements, workflows, APIs, test specs), see [docs/business-features/](docs/business-features/) with [docs/BUSINESS-FEATURES.md](docs/BUSINESS-FEATURES.md) as the master index.

---

This project includes a complete team collaboration system for AI agents, supporting agile workflows from idea capture to release.

Team Roles & Commands

| Role | Commands | Purpose |

| -------------------- | -------------------------------------- | -------------------------------------------- |

| Product Owner | /team-idea, /team-prioritize | Capture ideas, backlog prioritization |

| Business Analyst | /team-refine, /team-story | PBI refinement, user story creation |

| QA Engineer | /team-test-spec, /team-test-cases | Test specification, test case generation |

| UX Designer | /team-design-spec, /team-figma-extract | UI specs, Figma design extraction |

| QC Specialist | /team-quality-gate | Pre-dev/QA/release quality gates |

| Project Manager | /team-status, /team-dependency, /team-team-sync | Status reports, dependency mapping, meetings |

Artifact Management

```

team-artifacts/

├── ideas/ # Raw ideas (IDEA-YYMMDD-NNN)

├── pbis/ # Product Backlog Items (PBI-YYMMDD-NNN)

├── test-specs/ # Test specifications (TS-MOD-NNN)

├── design-specs/ # UI/UX specifications

├── qc-reports/ # Quality gate reports

└── templates/ # Artifact templates

```

> Full guide: [Team Collaboration Guide](docs/claude/team-collaboration-guide.md)

---

```mermaid

graph TB

subgraph "Frontend - Nx Workspace"

subgraph "Apps"

PLAYGROUND["playground-text-snippet"]

end

subgraph "Libraries"

PLATFORM_CORE["platform-core"]

PLATFORM_COMP["platform-components"]

APPS_DOMAINS["apps-domains"]

end

PLAYGROUND --> PLATFORM_CORE

PLAYGROUND --> APPS_DOMAINS

end

subgraph "Backend - .NET 9"

API["TextSnippet.Api"]

APP["TextSnippet.Application"]

DOMAIN["TextSnippet.Domain"]

PERSIST["TextSnippet.Persistence"]

end

subgraph "Infrastructure"

RABBIT["RabbitMQ"]

REDIS["Redis"]

DB["MongoDB/SQL/Postgres"]

end

PLAYGROUND --> API

API --> APP

APP --> DOMAIN

APP --> PERSIST

PERSIST --> DB

APP --> RABBIT

APP --> REDIS

```

Technology Stack

| Layer | Technologies |

| ------------- | --------------------------------------------- |

| Backend | .NET 9, ASP.NET Core, CQRS |

| Frontend | Angular 19, TypeScript, RxJS, PlatformVmStore |

| Data | MongoDB, SQL Server, PostgreSQL |

| Messaging | RabbitMQ |

| Caching | Redis |

| Jobs | Hangfire |

> Full architecture details: [Architecture Overview](docs/architecture-overview.md)

---

Backend

```

src/Platform/ # Easy.Platform framework

├── Easy.Platform/ # Core (CQRS, validation, repositories)

├── Easy.Platform.AspNetCore/ # ASP.NET Core integration

├── Easy.Platform.MongoDB/ # MongoDB patterns

├── Easy.Platform.RabbitMQ/ # Message bus

└── Easy.Platform.*/ # Other modules

src/Backend/ # Example microservice

├── *.Api/ # Web API layer

├── *.Application/ # CQRS handlers, jobs, events

├── *.Domain/ # Entities, domain events

├── *.Infrastructure/ # External concerns (storage, external APIs)

└── .Persistence/ # Database implementations

```

Frontend

```

src/Frontend/ # Angular 19 Nx workspace

├── apps/

│ └── playground-text-snippet/ # Example app

└── li