> For the complete documentation index, see [llms.txt](https://maqsoftware.gitbook.io/demomateai-technical-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://maqsoftware.gitbook.io/demomateai-technical-documentation/readme.md).

# DemoMate AI Technical Documentation

DemoMate AI is deployed as an Azure Marketplace managed application. This documentation set walks through the required Azure subscription preparation, Microsoft Entra app registration, marketplace deployment, post-deployment redirect URI setup, and first-time administrator bootstrap using mock mode.

## What DemoMate AI Deploys

DemoMate AI provisions the application runtime and supporting Azure services needed for AI-powered demo generation and administration.

* Azure App Service for the web application
* Azure Container Apps for backend automation and processing
* Azure OpenAI for GPT and Whisper model deployments
* Azure AI Speech for narration and text-to-speech
* Azure Storage for generated assets and application data
* Azure Cosmos DB for metadata and logs
* Azure Service Bus for asynchronous processing
* Azure Log Analytics and Application Insights for monitoring
* Managed identity and related Azure access configuration

## Recommended Reading Order

Use the documents in this order for a first-time deployment.

| Step | Document                                                                                                     | Purpose                                                                         |
| ---- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| 1    | [Prerequisite/prerequisite.md](/demomateai-technical-documentation/prerequisite/prerequisite.md)             | Register required Azure resource providers before deployment                    |
| 2    | [Pre-Deployment/app-registration.md](/demomateai-technical-documentation/pre-deployment/app-registration.md) | Create the Microsoft Entra app registration and collect tenant and client IDs   |
| 3    | [Deploy/deploy\_updated.md](/demomateai-technical-documentation/deploy/deploy_updated.md)                    | Follow the current Azure Marketplace deployment flow                            |
| 4    | [Configure/configure.md](/demomateai-technical-documentation/configure/configure.md)                         | Add the deployed App Service URL as the redirect URI                            |
| 5    | [MockUser/Mock User.md](/demomateai-technical-documentation/mockuser/mock-user.md)                           | Bootstrap the first admin user and disable mock mode after access is configured |

## Deployment Workflow Summary

1. Register the required Azure resource providers in the target subscription.
2. Create a single-tenant Microsoft Entra app registration for DemoMate AI.
3. Save the application display name, client ID, and tenant ID.
4. Deploy DemoMate AI from Azure Marketplace using the saved identity values and a mock admin email.
5. After deployment, copy the App Service URL and add it as a redirect URI in the app registration.
6. Sign in as the mock admin, add real users or Microsoft Entra security groups, then disable mock mode.

## Important Deployment Inputs

Prepare these values before you start the marketplace deployment:

* Azure subscription and resource group
* Primary Azure region
* Microsoft Entra tenant ID
* Microsoft Entra client ID
* Mock admin email address
* App naming and environment values
* Azure OpenAI model and version details
* Capacity and SKU selections for the deployed services

## Document Notes

* [Deploy/deploy\_updated.md](/demomateai-technical-documentation/deploy/deploy_updated.md) should be treated as the primary deployment guide.
* [Deploy/deploy.md](/demomateai-technical-documentation/deploy/deploy.md) contains an alternate, more detailed deployment walkthrough that may still be useful for validation or comparison.
* Mock mode is intended only for first-time setup and should be disabled after at least one real admin user or admin group is configured.

## Intended Audience

* Azure administrators deploying the managed application
* Microsoft Entra administrators creating the app registration and granting consent
* Application administrators configuring initial access control
* Operators validating the application after deployment

## Outcome of This Guide

After completing the full sequence, you should have:

* A deployed DemoMate AI managed application in Azure
* A working Microsoft Entra sign-in flow using the correct redirect URI
* Initial admin access configured through real users or groups
* Mock mode disabled and the environment ready for normal use