docs: Add local development setup guide and update deployment documentation

Author: VishalS-Microsoft

README.md

@@ -72,6 +72,9 @@ Follow the quick deploy steps on the deployment guide to deploy this solution to
 [Click here to launch the deployment guide](./docs/DeploymentGuide.md)
 <br/><br/>
 
+**For Local Development:**
+- [Local Development Setup Guide](docs/LocalDevelopmentSetup.md) - Comprehensive setup instructions for Windows, Linux, and macOS
+
 | [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/microsoft/document-generation-solution-accelerator) | [![Open in Dev Containers](https://img.shields.io/static/v1?style=for-the-badge&label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/microsoft/document-generation-solution-accelerator) | [![Open in Visual Studio Code Web](https://img.shields.io/static/v1?style=for-the-badge&label=Visual%20Studio%20Code%20(Web)&message=Open&color=blue&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/azure/?vscode-azure-exp=foundry&agentPayload=eyJiYXNlVXJsIjogImh0dHBzOi8vcmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbS9taWNyb3NvZnQvZG9jdW1lbnQtZ2VuZXJhdGlvbi1zb2x1dGlvbi1hY2NlbGVyYXRvci9yZWZzL2hlYWRzL21haW4vaW5mcmEvdnNjb2RlX3dlYiIsICJpbmRleFVybCI6ICIvaW5kZXguanNvbiIsICJ2YXJpYWJsZXMiOiB7ImFnZW50SWQiOiAiIiwgImNvbm5lY3Rpb25TdHJpbmciOiAiIiwgInRocmVhZElkIjogIiIsICJ1c2VyTWVzc2FnZSI6ICIiLCAicGxheWdyb3VuZE5hbWUiOiAiIiwgImxvY2F0aW9uIjogIiIsICJzdWJzY3JpcHRpb25JZCI6ICIiLCAicmVzb3VyY2VJZCI6ICIiLCAicHJvamVjdFJlc291cmNlSWQiOiAiIiwgImVuZHBvaW50IjogIiJ9LCAiY29kZVJvdXRlIjogWyJhaS1wcm9qZWN0cy1zZGsiLCAicHl0aG9uIiwgImRlZmF1bHQtYXp1cmUtYXV0aCIsICJlbmRwb2ludCJdfQ==) |
 |---|---|---|
 

docs/DeploymentGuide.md

@@ -244,6 +244,9 @@ Once you've opened the project in [Codespaces](#github-codespaces), [Dev Contain
 7. You can now delete the resources by running `azd down`, if you are done trying out the application.
    > **Note:** If you deployed with `enableRedundancy=true` and Log Analytics workspace replication is enabled, you must first disable replication before running `azd down` else resource group delete will fail. Follow the steps in [Handling Log Analytics Workspace Deletion with Replication Enabled](./LogAnalyticsReplicationDisable.md), wait until replication returns `false`, then run `azd down`.
 
+
+> **Note:** To set up and run the application locally for development, see the [Local Development Setup Guide](./LocalDevelopmentSetup.md).
+
 ### 🛠️ Troubleshooting
  If you encounter any issues during the deployment process, please refer [troubleshooting](../docs/TroubleShootingSteps.md) document for detailed steps and solutions
 

docs/LocalDebuggingSetup.md docs/LocalDevelopmentSetup.mddocs/LocalDebuggingSetup.md renamed to docs/LocalDevelopmentSetup.md

@@ -1,4 +1,4 @@
-# Local Debugging Setup
+# Local Development Setup Guide
 
 Follow the steps below to set up and run the **Document-Generation-Solution-Accelerator** locally.
 
@@ -42,10 +42,14 @@ Choose a location on your local machine where you want to store the project file
    code .
    ```
 
-## Local Setup/Debugging
+## Local Setup/Deplpoyment
 
 Follow these steps to set up and run the application locally:
 
+## Local Deployment:
+
+You can refer the local deployment guide here: [Local Deployment Guide](https://github.com/microsoft/document-generation-solution-accelerator/blob/main/docs/DeploymentGuide.md)
+
 ### 1. Open the App Folder
 Navigate to the `src` directory of the repository using Visual Studio Code.
 
@@ -58,6 +62,17 @@ Navigate to the `src` directory of the repository using Visual Studio Code.
 provisioned using `azd provision` or `azd up`, a `.env` file is automatically generated in the `.azure/<env-name>/.env`
 file. To get your `<env-name>` run `azd env list` to see which env is default.
 
+> **Note**: After adding all environment variables to the .env file, update the value of **'APP_ENV'** from:
+```
+APP_ENV="Prod"
+```
+**to:**
+```
+APP_ENV="Dev"
+```
+
+This change is required for running the application in local development mode.
+
 ### 3. Start the Application
 - Run `start.cmd` (Windows) or `start.sh` (Linux/Mac) to:
   - Install backend dependencies.
@@ -124,13 +139,112 @@ cd src/frontend
 npm install
 npm run build
 
-# Run the backend API
+# Run the backend API (Windows)
 cd src/
 
 start http://127.0.0.1:50505
 call python -m uvicorn app:app --port 50505 --reload 
+
+# Run the backend API (MacOs)
+cd src/
+
+open http://127.0.0.1:50505
+python -m uvicorn app:app --port 50505 --reload
+
+# Run the backend API (Linux)
+cd src/
+
+xdg-open http://127.0.0.1:50505
+python -m uvicorn app:app --port 50505 --reload
+
 ```
 
 > **Note**: Make sure your virtual environment is activated before running these commands. You should see `(.venv)` in your terminal prompt when the virtual environment is active.
 
-The App will run on `http://127.0.0.1:50505/#/` by default.
+The App will run on `http://127.0.0.1:50505/#/` by default.
+
+## Troubleshooting
+
+### Common Issues
+
+#### Python Version Issues
+
+```bash
+# Check available Python versions
+python3 --version
+python3.12 --version
+
+# If python3.12 not found, install it:
+# Ubuntu: sudo apt install python3.12
+# macOS: brew install [email protected]
+# Windows: winget install Python.Python.3.12
+```
+
+#### Virtual Environment Issues
+
+```bash
+# Recreate virtual environment
+rm -rf .venv  # Linux/macOS
+# or Remove-Item -Recurse .venv  # Windows PowerShell
+
+uv venv .venv
+# Activate and reinstall
+source .venv/bin/activate  # Linux/macOS
+# or .\.venv\Scripts\Activate.ps1  # Windows
+uv sync --python 3.12
+```
+
+#### Permission Issues (Linux/macOS)
+
+```bash
+# Fix ownership of files
+sudo chown -R $USER:$USER .
+
+# Fix uv permissions
+chmod +x ~/.local/bin/uv
+```
+
+#### Windows-Specific Issues
+
+```powershell
+# PowerShell execution policy
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+
+# Long path support (Windows 10 1607+, run as Administrator)
+New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
+
+# SSL certificate issues
+pip install --trusted-host pypi.org --trusted-host pypi.python.org --trusted-host files.pythonhosted.org uv
+```
+
+### Azure Authentication Issues
+
+```bash
+# Login to Azure CLI
+az login
+
+# Set subscription
+az account set --subscription "your-subscription-id"
+
+# Test authentication
+az account show
+```
+
+### Environment Variable Issues
+
+```bash
+# Check environment variables are loaded
+env | grep AZURE  # Linux/macOS
+Get-ChildItem Env:AZURE*  # Windows PowerShell
+
+# Validate .env file format
+cat .env | grep -v '^#' | grep '='  # Should show key=value pairs
+```
+
+## Related Documentation
+
+- [Deployment Guide](DeploymentGuide.md) - Instructions for production deployment.
+- [Delete Resource Group](DeleteResourceGroup.md) - Steps to safely delete the Azure resource group created for the solution.
+- [App Authentication Setup](AppAuthentication.md) - Guide to configure application authentication and add support for additional platforms.
+- [Powershell Setup](PowershellSetup.md) - Instructions for setting up PowerShell and required scripts.
+- [Quota Check](QuotaCheck.md) - Steps to verify Azure quotas and ensure required limits before deployment.