# franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance architecture

> Architecture diagram of the GitHub repository franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance
- Repository: https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance

## Overview

FranchiseOps AI is a multi-outlet franchise operations platform. Managers use its dashboard to review outlet performance and health, manage inventory, staff and marketing, and work with insights, recommendations, alerts and reports. The AI assistant accepts business questions and hands them to an agent orchestrator; the intelligence engine also reads tenant data for cross-domain analysis. Tenant records are stored in browser local storage, with an optional Supabase outlet-data path. Several feature pages and the orchestrator are represented from the tree and README; their internal wiring was not sampled, so uncertain links are omitted.

Main entry points: [`src/App.tsx`](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/App.tsx) (App routes), [`src/services/tenantService.ts`](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/tenantService.ts) (Tenant data service), [`src/services/outletPerformanceService.ts`](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/outletPerformanceService.ts) (Outlet analytics), [`src/services/franchiseIntelligenceEngine.ts`](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/franchiseIntelligenceEngine.ts) (Franchise intelligence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Application experience"]
  node_app["App routes<br/>[App.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_assistant["Floating assistant"]
end

subgraph group_operations["Franchise operations"]
  node_outlet_pages["Outlet views<br/>[Outlets.tsx]"]
  node_outlet_detail["Outlet detail<br/>[OutletDetail.tsx]"]
  node_inventory["Inventory<br/>[InventoryPage.tsx]"]
  node_staff["Staff<br/>[StaffPage.tsx]"]
  node_marketing["Marketing<br/>[MarketingPage.tsx]"]
  node_business_data["Business data hub"]
  node_risk["Risk center<br/>[RiskCenterPage.tsx]"]
  node_reports["Reports<br/>[ReportsPage.tsx]"]
end

subgraph group_intelligence["AI and analytics"]
  node_insights["Insights workspace"]
  node_recommendations["Recommendations"]
  node_orchestrator["Agent orchestrator"]
  node_intelligence_engine["Franchise intelligence"]
  node_performance_service["Outlet analytics"]
  node_health_engine["Health scoring"]
  node_multilingual["Multilingual assistant"]
end

subgraph group_data["Business data"]
  node_tenant_service["Tenant data service<br/>[tenantService.ts]"]
  node_local_storage[("Browser storage")]
end

node_manager(("Manager"))
node_supabase[("Supabase")]

node_manager -->|"uses"| node_app
node_app -->|"routes"| node_dashboard
node_app -->|"routes"| node_outlet_pages
node_app -->|"routes"| node_outlet_detail
node_app -->|"routes"| node_inventory
node_app -->|"routes"| node_staff
node_app -->|"routes"| node_marketing
node_app -->|"routes"| node_business_data
node_app -->|"routes"| node_insights
node_app -->|"routes"| node_recommendations
node_app -->|"routes"| node_risk
node_app -->|"routes"| node_reports
node_manager -->|"asks"| node_assistant
node_assistant -->|"submits query"| node_orchestrator
node_intelligence_engine -->|"reads tenant data"| node_tenant_service
node_intelligence_engine -->|"delegates query"| node_orchestrator
node_performance_service -->|"reads outlet data"| node_tenant_service
node_performance_service -->|"calculates scores"| node_health_engine
node_performance_service -.->|"fetches outlets"| node_supabase
node_tenant_service -->|"reads and writes"| node_local_storage
node_multilingual -->|"reads business data"| node_tenant_service

click node_app "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/App.tsx"
click node_dashboard "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/Dashboard.tsx"
click node_outlet_pages "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/Outlets.tsx"
click node_outlet_detail "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/OutletDetail.tsx"
click node_inventory "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/InventoryPage.tsx"
click node_staff "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/StaffPage.tsx"
click node_marketing "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/MarketingPage.tsx"
click node_business_data "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/BusinessDataHub.tsx"
click node_insights "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/IntelligenceWorkspace.tsx"
click node_recommendations "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/Recommendations.tsx"
click node_risk "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/RiskCenterPage.tsx"
click node_reports "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/ReportsPage.tsx"
click node_assistant "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/components/ai/FloatingAIAssistant.tsx"
click node_orchestrator "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/businessAgentOrchestrator.ts"
click node_intelligence_engine "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/franchiseIntelligenceEngine.ts"
click node_performance_service "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/outletPerformanceService.ts"
click node_health_engine "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/healthScoreEngine.ts"
click node_multilingual "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/multilingualAssistantService.ts"
click node_tenant_service "https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/tenantService.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_dashboard,node_assistant toneBlue
class node_outlet_pages,node_outlet_detail,node_inventory,node_staff,node_marketing,node_business_data,node_risk,node_reports,node_supabase toneAmber
class node_insights,node_recommendations,node_orchestrator,node_intelligence_engine,node_performance_service,node_health_engine,node_multilingual toneMint
class node_tenant_service,node_local_storage toneRose
class node_manager toneIndigo
```

## Components

### Application experience

- [App routes](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/App.tsx): `src/App.tsx`
- [Dashboard](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Floating assistant](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/components/ai/FloatingAIAssistant.tsx): `src/components/ai/FloatingAIAssistant.tsx`

### Franchise operations

- [Outlet views](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/Outlets.tsx): `src/pages/Outlets.tsx`
- [Outlet detail](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/OutletDetail.tsx): `src/pages/OutletDetail.tsx`
- [Inventory](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/InventoryPage.tsx): `src/pages/InventoryPage.tsx`
- [Staff](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/StaffPage.tsx): `src/pages/StaffPage.tsx`
- [Marketing](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/MarketingPage.tsx): `src/pages/MarketingPage.tsx`
- [Business data hub](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/BusinessDataHub.tsx): `src/pages/BusinessDataHub.tsx`
- [Risk center](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/RiskCenterPage.tsx): `src/pages/RiskCenterPage.tsx`
- [Reports](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/ReportsPage.tsx): `src/pages/ReportsPage.tsx`

### AI and analytics

- [Insights workspace](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/IntelligenceWorkspace.tsx): `src/pages/IntelligenceWorkspace.tsx`
- [Recommendations](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/pages/Recommendations.tsx): `src/pages/Recommendations.tsx`
- [Agent orchestrator](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/businessAgentOrchestrator.ts): `src/services/businessAgentOrchestrator.ts`
- [Franchise intelligence](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/franchiseIntelligenceEngine.ts): `src/services/franchiseIntelligenceEngine.ts`
- [Outlet analytics](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/outletPerformanceService.ts): `src/services/outletPerformanceService.ts`
- [Health scoring](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/healthScoreEngine.ts): `src/services/healthScoreEngine.ts`
- [Multilingual assistant](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/multilingualAssistantService.ts): `src/services/multilingualAssistantService.ts`

### Business data

- [Tenant data service](https://github.com/franchise-agentic-ai/agentic-ai-for-franchise-management-system-with-performance-monitoring-assistance/blob/main/src/services/tenantService.ts): `src/services/tenantService.ts`
- **Browser storage**

### Other components

- **Manager**
- **Supabase**

## Connections

- Manager → App routes: uses
- App routes → Dashboard: routes
- App routes → Outlet views: routes
- App routes → Outlet detail: routes
- App routes → Inventory: routes
- App routes → Staff: routes
- App routes → Marketing: routes
- App routes → Business data hub: routes
- App routes → Insights workspace: routes
- App routes → Recommendations: routes
- App routes → Risk center: routes
- App routes → Reports: routes
- Manager → Floating assistant: asks
- Floating assistant → Agent orchestrator: submits query
- Franchise intelligence → Tenant data service: reads tenant data
- Franchise intelligence → Agent orchestrator: delegates query
- Outlet analytics → Tenant data service: reads outlet data
- Outlet analytics → Health scoring: calculates scores
- Outlet analytics → Supabase: fetches outlets
- Tenant data service → Browser storage: reads and writes
- Multilingual assistant → Tenant data service: reads business data