{"id":48887600,"url":"https://github.com/markstanden/run-suggestion","last_synced_at":"2026-04-16T05:35:30.132Z","repository":{"id":286338608,"uuid":"961113859","full_name":"markstanden/run-suggestion","owner":"markstanden","description":"Azure Function App based running recommendation engine built with TDD practices, using a testable, decoupled layered architecture.","archived":false,"fork":false,"pushed_at":"2025-09-10T09:16:10.000Z","size":173,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-10T12:57:25.293Z","etag":null,"topics":["azure-functions","clean-architecture","csv-processing","dotnet8","recommendation-engine","tdd"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/markstanden.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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":"2025-04-05T19:29:41.000Z","updated_at":"2025-09-07T17:23:27.000Z","dependencies_parsed_at":"2025-07-05T09:19:36.254Z","dependency_job_id":"b2dd87d3-192a-431a-9930-9de57c827063","html_url":"https://github.com/markstanden/run-suggestion","commit_stats":null,"previous_names":["markstanden/run-suggestion"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/markstanden/run-suggestion","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markstanden%2Frun-suggestion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markstanden%2Frun-suggestion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markstanden%2Frun-suggestion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markstanden%2Frun-suggestion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/markstanden","download_url":"https://codeload.github.com/markstanden/run-suggestion/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markstanden%2Frun-suggestion/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31872673,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"online","status_checked_at":"2026-04-16T02:00:06.042Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["azure-functions","clean-architecture","csv-processing","dotnet8","recommendation-engine","tdd"],"created_at":"2026-04-16T05:35:30.068Z","updated_at":"2026-04-16T05:35:30.124Z","avatar_url":"https://github.com/markstanden.png","language":"C#","readme":"# Run Suggestion Engine\n\nA running recommendation engine built on Azure Functions, built using TDD practices, to an initial pre-designed UML\ndesign.\n\n## Project Structure\n\n```bash\n.\n├── docs/\n│   ├── examples/\n│   │   └── curl/\n│   └── sample-data/\n├── src/\n│   ├── Api/\n│   │   ├── Constants/\n│   │   ├── Extensions/\n│   │   ├── Functions/\n│   │   ├── Properties/\n│   │   └── Program.cs\n│   ├── Core/\n│   │   ├── Constants/\n│   │   ├── Interfaces/\n│   │   ├── Repositories/\n│   │   ├── Services/\n│   │   ├── Sql/\n│   │   ├── Transformers/\n│   │   └── Validators/\n│   ├── Shared/\n│   │   ├── Constants/\n│   │   ├── Extensions/\n│   │   └── Models/\n│   └── Web/\n│       ├── Authentication/\n│       ├── Constants/\n│       ├── Layout/\n│       ├── Pages/\n│       ├── Services/\n│       └── wwwroot/\n├── tests/\n│   ├── Api.Integration.Tests/\n│   ├── Api.Unit.Tests/\n│   ├── Core.Unit.Tests/\n│   ├── Shared.Unit.Tests/\n│   ├── TestHelpers/\n│   └── Web.Unit.Tests/\n├── swa-cli.config.json\n└── RunSuggestion.sln\n```\n\n## Technology Stack\n\n- **.NET 8**: Core framework\n- **Azure Functions**: Serverless compute\n- **Azure AD B2C**: Authentication\n- **Testing**: xUnit, Moq, Shouldly\n\n## Development\n\n### Prerequisites\n\n- [.NET 8 SDK](https://dotnet.microsoft.com/en-us/download)\n- [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli)\n- [Azure Functions Core](https://learn.microsoft.com/en-us/azure/azure-functions/functions-run-local)\n\n### Infrastructure Management\n\nThis project uses [terraform-tools](https://github.com/markstanden/terraform-tools) for managing Terraform commands.\nAlthough not required, it simplifies the creation of infrastructure by sourcing environment variables when working\nlocally.\n\nThis is a personal workaround for the\nfollowing [terraform issue](https://github.com/hashicorp/terraform-provider-azurerm/issues/27423)\n\n## Getting Started\n\n1. Clone the repository\n2. Copy the local settings template:\n\n```bash\ncp src/Api/local.settings.template.json src/Api/local.settings.json\n```\n\n3. Build the solution:\n\n```bash\ndotnet build\n```\n\n4. Run tests:\n\n```bash\ndotnet test\n```\n\n5. Run locally\n\n    - **Full stack via Static Web Apps CLI** (recommended):\n\n    ```bash\n    # prerequisite: install the SWA CLI\n    npm i -g @azure/static-web-apps-cli\n    ```\n\n    ```bash\n    # Local development (with hot reload)\n    swa start --config-name dev\n    # Shortcut (undocumented, may break in future versions):\n    swa start dev\n    \n    # Deploy to Azure Static Web Apps\n    swa deploy --config-name deploy\n    ```\n\n    - **Run separately**:\n\n        - API (Azure Functions):\n\n        ```bash\n        cd src/Api\n        func start\n        ```\n\n        - Web (Blazor):\n\n        ```bash\n        dotnet watch run --project src/Web/Web.csproj\n        ```\n\n## SWA CLI Configuration\n\nThis project uses Azure Static Web Apps CLI with two configurations:\n\n- **Default config**: Used for deployment (`swa deploy`/`swa deploy --config-name deploy`)\n    - builds and deploys Release versions\n- **`dev` config**: Used for local development (`swa start dev`/`swa start --config-name dev`)\n    - runs Debug builds with hot reload\n- **`test` config**: Used for api testing/automated tests (`swa start test`/\n  `swa start --config-name test`)\n    - Debug build, no browser, stable dev-server URL\n\nThe SWA CLI configuration is in `./swa-cli.config.json` and handles:\n\n- Frontend serving (Blazor WebAssembly)\n- API proxying (Azure Functions)\n- Build commands for both Web and API projects\n- Port configuration for local development\n\n## CI/CD Pipeline\n\nThis project uses GitHub Actions to automate basic quality checks, with the pipeline running on pushes or PRs to `main`.\n\nThe pipeline jobs are held in my [coding-standards repo](https://github.com/markstanden/coding-standards), allowing for\nusage across multiple projects.\n\n- **Format Check**: Enforces code formatting standards using `.editorconfig` and dotnet's built in code formatter:\n   ```bash\n   dotnet format --verify-no-changes\n   ```\n\n- **Build**: Compiles the solution and validates dependencies using dotnet's build command to flag errors.\n   ```bash\n   dotnet build\n   ```\n\n- **Unit Tests**: Runs all tests in all test projects with the suffix `Unit.Tests`\n   ```bash\n   dotnet test --filter 'FullyQualifiedName~Unit.Tests'\n   ```\n\n- **Integration Tests**: Runs all tests in all test projects with the suffix `Integration.Tests`\n   ```bash\n   dotnet test --filter 'FullyQualifiedName~Integration.Tests'\n   ```\n\n## Code Quality\n\n- Code quality is improved by static analysis during development using SonarQube with IDE integration.\n- SonarQube inclusion within the pipeline provides an enforced quality gate on PRs.\n- Force pushes to `main` are prohibited - requiring PRs and enabling review before merge.\n- Code Rabbit also provides LLM-assisted code reviews, helping to highlight development errors prior to merges.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkstanden%2Frun-suggestion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarkstanden%2Frun-suggestion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkstanden%2Frun-suggestion/lists"}