Fa 1157 track organization resource consuption

.env.template

@@ -1,5 +1,6 @@
 # orchestrator's endpoint: use http://localhost:7071/api/orc when running everything locally.
 ORCHESTRATOR_ENDPOINT="http://localhost:7071/api/orc"
+
 AZURE_KEY_VAULT_NAME="key_vault_name"
 
 # Speech sythesis and recognition
@@ -9,4 +10,10 @@ SPEECH_SYNTHESIS_LANGUAGE="UPDATE_WITH_TTS_LANGUAGE._Example:_es-MX"
 SPEECH_SYNTHESIS_VOICE_NAME="UPDATE_WITH_TTS_NEURAL_LANGUAGE._Example:_es-MX-BeatrizNeural"
 
 # document storage (to show sources in browser)
-STORAGE_ACCOUNT="UPDATE_WITH_STORAGE_ACCOUNT_NAME"
+STORAGE_ACCOUNT="UPDATE_WITH_STORAGE_ACCOUNT_NAME"
+
+############## EMAIL CONFIGURATION ##############
+EMAIL_SMTP_SERVER="smtp.gmail.com"
+EMAIL_SMTP_PORT=587
+EMAIL_USER_NAME="your-email@gmail.com"
+EMAIL_USER_PASSWORD="your-app-specific-password"  # Gmail App Password, not your regular Gmail password

.github/copilot-instructions.md

@@ -0,0 +1,15 @@
+## Backend preferences (Python)
+- Use Quart (or Flask) as the backend web framework.
+- For Quart, prefer `async` route handlers and use `await` for I/O operations.
+- Follow PEP8 style conventions in Python code.
+
+## Frontend preferences
+- The React frontend uses TypeScript.
+- Built with Vite.
+- Always write functional components.
+- Use React Hooks.
+- Code formatting should follow Prettier conventions: (e.g., 2 spaces for indentation, single quotes).
+
+## General project notes / API Design
+- Our REST API follows RESTful naming conventions (/api/v1/...).
+- When giving examples, assume our app is served from /.

.github/pull_request_template.md

@@ -0,0 +1,10 @@
+## JIRA Ticket
+[PROJ-XXX](link-to-ticket)
+
+## Description
+[Describe your changes here]
+
+## Checklist
+- [ ] Code review requested
+- [ ] Tests completed
+- [ ] Documentation updated

.github/workflows/azure-dev.yml

@@ -0,0 +1,88 @@
+# .github/workflows/deploy.yml
+name: Build and Deploy to Azure
+
+on:
+  push:
+    branches:
+      - develop
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      # 1. Checkout Code
+      - name: Checkout Code
+        uses: actions/checkout@v3
+
+      # 2. Install System Dependencies
+      - name: Install System Dependencies
+        run: |
+          sudo apt-get update && sudo apt-get install -y \
+          zip \
+          libpango-1.0-0 \
+          libharfbuzz0b \
+          libpangoft2-1.0-0 \
+          libharfbuzz-subset0 \
+          libffi-dev \
+          libjpeg-dev \
+          libopenjp2-7-dev \
+          libglib2.0-0 \
+          libglib2.0-dev \
+          libcairo2 \
+          libcairo2-dev \
+          libpangocairo-1.0-0 \
+          pkg-config \
+          python3-dev \
+          python3-cffi \
+          libgobject-2.0-0
+
+      # 3. Azure Login
+      - name: Azure Login
+        uses: azure/login@v2
+        with:
+          creds: ${{ secrets.AZURE_CREDENTIALS }}
+
+      # 4. Set up Node.js
+      - name: Set up Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: "18"
+
+      # 5. Build Frontend
+      - name: Build Frontend
+        working-directory: frontend
+        run: |
+          npm install
+          npm run build
+
+      # 6. Package Backend
+      - name: Package Backend
+        working-directory: backend
+        run: |
+          rm -rf backend_env
+          zip -r ../deploy.zip *
+      - name: Debug Secrets
+        run: |
+          echo "Subscription ID: ${{ secrets.AZURE_PROD_SUBSCRIPTION_ID }}"
+          echo "Resource Group: ${{ secrets.AZURE_PROD_RESOURCE_GROUP }}"
+          echo "Web App Name: ${{ secrets.AZURE_PROD_WEBAPP_NAME }}"
+
+      # 7. Deploy to Azure
+      - name: Deploy to Azure
+        uses: azure/cli@v2
+        with:
+          azcliversion: latest
+          inlineScript: |
+            set -e
+            if [ ! -f deploy.zip ]; then
+              echo "deploy.zip not found"
+              exit 1
+            fi
+            az webapp deploy \
+              --subscription ${{ secrets.AZURE_SUBSCRIPTION_ID }} \
+              --resource-group ${{ secrets.AZURE_RESOURCE_GROUP }} \
+              --name ${{ secrets.AZURE_WEBAPP_NAME }} \
+              --src-path deploy.zip \
+              --type zip \
+              --async true

.github/workflows/azure-prod.yml

@@ -0,0 +1,64 @@
+# .github/workflows/deploy.yml
+name: Build and Deploy to Azure
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v3
+
+      - name: Install zip
+        run: sudo apt-get update && sudo apt-get install -y zip
+
+      - name: Azure Login
+        uses: azure/login@v2
+        with:
+          creds: ${{ secrets.AZURE_PROD_CREDENTIALS }}
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: "18"
+
+      - name: Build Frontend
+        working-directory: frontend
+        run: |
+          npm install
+          npm run build
+
+      - name: Package Backend
+        working-directory: backend
+        run: |
+          rm -rf backend_env
+          zip -r ../deploy.zip *
+
+      - name: Debug Secrets
+        run: |
+          echo "Subscription ID: ${{ vars.AZURE_PROD_SUBSCRIPTION_ID }}"
+          echo "Resource Group: ${{ vars.AZURE_PROD_RESOURCE_GROUP }}"
+          echo "Web App Name: ${{ vars.AZURE_PROD_WEBAPP_NAME }}"
+
+      - name: Deploy to Azure
+        uses: azure/cli@v2
+        with:
+          azcliversion: latest
+          inlineScript: |
+            set -e
+            if [ ! -f deploy.zip ]; then
+              echo "deploy.zip not found"
+              exit 1
+            fi
+            az webapp deploy \
+              --subscription ${{ vars.AZURE_PROD_SUBSCRIPTION_ID }} \
+              --resource-group ${{ vars.AZURE_PROD_RESOURCE_GROUP }} \
+              --name ${{ vars.AZURE_PROD_WEBAPP_NAME }} \
+              --src-path deploy.zip \
+              --type zip \
+              --async true

.github/workflows/cypress-test.yml

@@ -0,0 +1,56 @@
+# .github/workflows/cypress-test.yml
+name: Cypress Tests
+
+on:
+  pull_request:
+    branches:
+      - develop
+      - main
+
+jobs:
+  cypress-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      # 1. Checkout Code
+      - name: Checkout Code
+        uses: actions/checkout@v3
+
+      # 2. Set up Node.js
+      - name: Set up Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: "18"
+
+      # 3. Install Dependencies
+      - name: Install Dependencies
+        working-directory: frontend
+        run: |
+          npm install
+
+      # 4. Install wait-on Globally
+      - name: Install wait-on Globally
+        run: |
+          npm install -g wait-on
+
+      # 5. Start Frontend Server
+      - name: Start Frontend Server
+        working-directory: frontend
+        run: |
+          npm run dev &
+        env:
+          HOST: "localhost"
+          PORT: 5173
+
+      # Debug Server State
+      - name: Debug Server State
+        run: |
+          curl -I http://localhost:5173
+
+      # 7. Run Cypress Tests
+      - name: Run Cypress Tests
+        working-directory: frontend
+        env:
+          WEB_APP_URL: "http://localhost:5173"
+        run: |
+          npx cypress run

.gitignore

@@ -1,11 +1,14 @@
+.DS_Store
+CLAUDE.md
+AGENTS.md
 # Azure az webapp deployment details
 .azure
 *_env
 local/
 notes.txt
 deploy.zip
 .vscode/
-
+.DS_Store
 
 # Byte-compiled / optimized / DLL files
 __pycache__/
@@ -150,4 +153,14 @@ cython_debug/
 # NPM
 npm-debug.log*
 node_modules
-static/
+static/
+
+settings.json
+
+flask_session/
+
+# locking some dependencies
+pyproject.toml
+poetry.lock
+
+cypress.env.json

CONTRIBUTING.md

@@ -0,0 +1,41 @@
+## Documentation & Team Onboarding
+GitHub Copilot automatically reviews pull requests using custom instructions tailored to our project's tools, coding styles, and workflows, ensuring consistent and relevant feedback across backend and frontend codebases. To help you get the most out of our GitHub Copilot PR review automation, please follow the steps below.
+
+## How to Edit `.github/copilot-instructions.md`
+The file at `.github/copilot-instructions.md` defines how GitHub Copilot reviews pull requests in this repository.
+
+- Use natural language to describe backend and frontend coding preferences.
+- When adding new conventions, be specific (e.g., “use async route handlers in Quart”).
+- After editing, commit directly to the default branch.
+
+> Tip: After you push updates, open a test PR to confirm the new rules take effect.
+
+## How to Verify Copilot is Using the Custom Instructions
+- To verify Copilot is using these rules:
+  1. Open a test PR with code changes.
+  2. Wait for Copilot to comment.
+  3. Check that the comment references this `.github/copilot-instructions.md` file.
+
+If no comment appears, or the suggestions seem off-topic:
+- Confirm the PR includes backend/frontend changes.
+- Make sure `.github/copilot-instructions.md` exists and is correctly formatted.
+- Check that Copilot PR Reviews are enabled (see below).
+
+## How to Enable or Disable the Copilot PR Review Feature Locally
+You don’t need a specific editor to use Copilot’s pull request review feature — it runs automatically on GitHub once the repository settings are enabled.
+
+However, if you also want your editor’s Copilot suggestions to follow the same rules as `.github/copilot-instructions.md`, here’s how to enable that locally:
+
+In VS Code: 
+1. Go to `Settings`.
+2. Navigate to `GitHub › Copilot › Chat › Code Generation: Use Instruction Files`
+3. Enable: `Use Instruction Files`.
+
+In Visual Studio: 
+1. Open `Tools > Options`.
+2. Go to `GitHub Copilot > PR Reviews`.
+3. Check: "Enable custom instructions".
+
+These settings affect local code completions, not the GitHub-hosted PR reviews.
+
+You can disable Copilot PR reviews at any time by unchecking this option.