{"id":39802867,"url":"https://github.com/melodic-software/medley","last_synced_at":"2026-01-18T12:35:19.294Z","repository":{"id":331663690,"uuid":"1127410839","full_name":"melodic-software/medley","owner":"melodic-software","description":"A modular monolith application built with .NET 10, C# 14, Blazor, and Aspire","archived":false,"fork":false,"pushed_at":"2026-01-10T16:40:58.000Z","size":254,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T05:06:36.436Z","etag":null,"topics":["aspire","blazor","csharp","dotnet","modular-monolith"],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/melodic-software.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-03T20:37:08.000Z","updated_at":"2026-01-10T16:41:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/melodic-software/medley","commit_stats":null,"previous_names":["melodic-software/medley"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/melodic-software/medley","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melodic-software%2Fmedley","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melodic-software%2Fmedley/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melodic-software%2Fmedley/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melodic-software%2Fmedley/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/melodic-software","download_url":"https://codeload.github.com/melodic-software/medley/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melodic-software%2Fmedley/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28536002,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T10:13:46.436Z","status":"ssl_error","status_checked_at":"2026-01-18T10:13:11.045Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aspire","blazor","csharp","dotnet","modular-monolith"],"created_at":"2026-01-18T12:35:18.589Z","updated_at":"2026-01-18T12:35:19.253Z","avatar_url":"https://github.com/melodic-software.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Medley\n\n[![CI](https://github.com/melodic-software/medley/actions/workflows/ci.yml/badge.svg)](https://github.com/melodic-software/medley/actions/workflows/ci.yml)\n\nA modular monolith application built with modern .NET technologies.\n\n\u003e **Status**: Pre-MVP scaffolding phase. Build infrastructure, CI/CD, and architectural guidelines are in place. Source code implementation is next.\n\n## Tech Stack\n\n| Technology | Version | Purpose |\n|------------|---------|---------|\n| .NET | 10.0 (LTS) | Runtime \u0026 SDK |\n| C# | 14 | Language |\n| Blazor | Interactive Auto | UI Framework |\n| [Aspire](https://aspire.dev) | 13.1+ | Orchestration \u0026 Observability |\n| Duende IdentityServer | 7.4.x | Security Token Service |\n| Duende BFF | Latest | Backend for Frontend (Blazor) |\n\n\u003e **Historical Note** (November 2025): Aspire version numbering jumped from 9.x to 13.x in November 2025 to align with its rebranding as a polyglot platform. See the [Aspire 13 announcement](https://devblogs.microsoft.com/aspire/aspire13/) for historical context.\n\n## Architecture\n\n### Modular Monolith\n\nThis application follows a **modular monolith** architecture - combining the simplicity of a monolith deployment with the modularity of microservices.\n\n### Clean Architecture\n\nEach module follows **Clean Architecture** principles with clear separation:\n\n- **Domain** - Entities, value objects, domain events\n- **Application** - Use cases, commands, queries (CQS/CQRS)\n- **Infrastructure** - External concerns, persistence, integrations\n- **Presentation** - API endpoints, Blazor UI\n\n### Vertical Slices\n\nFeatures are organized as **vertical slices** across layers, keeping related code together.\n\n### CQRS Pattern\n\nCommands and Queries are separated following the **CQS/CQRS** pattern for clarity and scalability.\n\n### Gateway Architecture (Planned)\n\nExternal traffic routes through dual YARP gateways:\n- **App Gateway** (`apps.melodicsoftware.com`) - UI, BFF, IdentityServer\n- **API Gateway** (`api.melodicsoftware.com`) - Module APIs\n\nSee [BACKLOG.md](docs/BACKLOG.md#gateway-architecture-yarp-via-aspire) for implementation details.\n\n## Code Quality\n\n### Compile-Time Enforcement\n\n- **Custom Roslyn Analyzers** - Enforce architectural rules at compile time\n- **Built-in .NET Analyzers** - Code quality and security rules\n\n### Test-Time Enforcement\n\n- **Architecture Tests** - NetArchTest.Rules for structural validation\n- **Boundary Enforcement** - Verify layer dependencies and module isolation\n\n### When to Use Each\n\n| Tool | Timing | Best For |\n|------|--------|----------|\n| Roslyn Analyzers | Compile-time | Style, naming, API usage, immediate feedback |\n| Architecture Tests | Post-build | Layer dependencies, module boundaries, structural rules |\n\n## Security\n\n- **Duende IdentityServer 7.4** - OAuth 2.0 / OpenID Connect provider\n- **Duende BFF** - Secure token handling for Blazor UI\n- **Passkey Support** - .NET 10 native passkey integration\n\n## Project Structure\n\n\u003e **In Progress** - Core infrastructure is in place. Projects marked \"(planned)\" are next.\n\n```\nmedley/\n├── src/\n│   ├── Medley.AppHost/              # Aspire orchestrator\n│   ├── Medley.ServiceDefaults/      # Aspire shared defaults\n│   ├── Medley.Web/                  # Blazor UI + BFF (modular monolith host)\n│   ├── Medley.IdentityServer/       # Duende IdentityServer\n│   │\n│   ├── SharedKernel/                # Cross-cutting DDD building blocks\n│   │   ├── SharedKernel/            # Core: Entity, ValueObject, Result, DomainEvent (planned)\n│   │   ├── SharedKernel.Application/   # CQRS: Commands, Queries, Behaviors (planned)\n│   │   ├── SharedKernel.Infrastructure/  # EF interceptors, repositories (planned)\n│   │   ├── SharedKernel.Contracts/  # Integration events, shared DTOs (planned)\n│   │   ├── SharedKernel.Analyzers/  # Custom Roslyn analyzers (naming, architecture)\n│   │   └── SharedKernel.Analyzers.CodeFixes/  # Code fix providers\n│   │\n│   └── Modules/\n│       └── {ModuleName}/            # e.g., Users, Orders\n│           ├── {ModuleName}.Domain/\n│           ├── {ModuleName}.Application/\n│           ├── {ModuleName}.Infrastructure/\n│           └── {ModuleName}.Contracts/\n│\n├── tests/\n│   ├── SharedKernel/\n│   │   ├── SharedKernel.Analyzers.Tests/  # Analyzer unit tests\n│   │   └── ...                      # Additional test projects (planned)\n│   ├── Modules/\n│   │   └── {ModuleName}/            # Module test projects (planned)\n│   └── Architecture.Tests/          # NetArchTest boundary enforcement (planned)\n│\n├── docs/\n└── infrastructure/                  # IaC (Bicep/Terraform)\n```\n\nSee [docs/architecture/](docs/architecture/) for detailed structure documentation.\n\n### Solution File\n\nOpen `Medley.slnx` - the main solution containing all modules, tests, and infrastructure.\n\n## Getting Started\n\n### Prerequisites\n\n- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)\n\n### Development\n\nSource code scaffolding is in progress. See [CONTRIBUTING.md](CONTRIBUTING.md) for development workflow and conventions.\n\n## License\n\nProprietary - see [LICENSE](LICENSE) for details.\n\nCopyright 2026 Melodic Software. All rights reserved.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelodic-software%2Fmedley","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmelodic-software%2Fmedley","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelodic-software%2Fmedley/lists"}