fix: merging dev to main

[Priyanka-Microsoft]

Purpose

• ...
  This pull request significantly updates the LocalDevelopmentSetup.md documentation to clarify and streamline the local development process for the solution accelerator. The changes provide more robust instructions for setting up the required Azure resources, configuring environment files, running backend services, and troubleshooting common issues. The documentation now better supports both Visual Studio and dotnet CLI workflows, emphasizes the importance of correct Azure deployment, and helps prevent common configuration errors.

Azure Deployment and Prerequisites:

• Added a new section requiring that an Azure environment be deployed before local development, with clear guidance for different scenarios (existing, new, or deleted deployments). Includes instructions for verifying the presence and reachability of the Azure App Configuration resource. [1] [2]
• Updated instructions for installing prerequisites, specifying that .NET SDK 8 or higher is needed, and clarified verification steps for tool installations. [1] [2]

Azure Authentication and Permissions:

• Expanded Azure authentication setup with detailed instructions for retrieving the App Configuration URL via CLI or Portal, and added steps to validate DNS resolution. [1] [2]
• Clarified required Azure RBAC roles, emphasized that all listed roles are mandatory, and added a verification step to ensure roles are correctly assigned using the CLI. [1] [2]

Backend Services Setup and Execution:

• Reorganized backend setup steps, now supporting both Visual Studio and dotnet CLI workflows. Added explicit instructions for handling solution build issues, running services in separate terminals, and ensuring the correct environment variables are set. [1] [2] [3]
• Improved guidance for creating and verifying appsettings.Development.json files, including warnings about stale or incorrect App Configuration URLs and the need to use the full template files.
• Added instructions for updating the Kernel Memory endpoint in Azure App Configuration for local development, with both CLI and portal options, and included a reminder to revert this change for production.

Frontend Setup:

• Updated frontend setup to align with new backend port defaults (now http://localhost:5000), clarified .env configuration, and improved documentation for environment variables and dependency installation. [1] [2]

Troubleshooting and Common Issues:

• Added a comprehensive troubleshooting section covering common startup errors, build failures, DNS issues, and misconfigurations, with clear diagnostic steps and solutions.

These updates make the local development guide more robust, user-friendly, and resilient to common pitfalls, especially for new contributors or those unfamiliar with Azure-based development workflows.

Does this introduce a breaking change?

• Yes
• [ X] No

Golden Path Validation

• I have tested the primary workflows (the "golden path") to ensure they function correctly without errors.

Deployment Validation

• I have validated the deployment process successfully and all services are running as expected with this change.

What to Check

Verify that the following are valid

• ...

Other Information

[github-actions]

🎉 This PR is included in version 1.4.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀