# mansityagi130/teamcenter_ai architecture

> Architecture diagram of the GitHub repository mansityagi130/teamcenter_ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mansityagi130/teamcenter_ai
- Repository: https://github.com/mansityagi130/teamcenter_ai

## Overview

Teamcenter AI Copilot is a conversational PLM assistant with a React interface, FastAPI backend, MCP tool gateway, and SQLite-backed services. The primary workflow is a user request through the Copilot into backend routing and, for Teamcenter operations, MCP or Teamcenter APIs; the system returns results to the interface. Separate product branches provide search, property and API discovery, administration, health, and observability. Several relationships are documented in the README or SOURCE INDEX; unsampled implementations are represented only at supported paths.

Main entry points: [`backend.py`](https://github.com/mansityagi130/teamcenter_ai/blob/main/backend.py) (FastAPI application), [`frontend_src/src/api.ts`](https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/api.ts) (Authenticated API client), [`frontend_src/src/App.tsx`](https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/App.tsx) (Application routing), [`tc_api_client.py`](https://github.com/mansityagi130/teamcenter_ai/blob/main/tc_api_client.py) (Teamcenter API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_app["Application routing<br/>[App.tsx]"]
  node_copilot["AI Copilot<br/>[Copilot.tsx]"]
  node_search_ui["Advanced search"]
  node_command_ui["Teamcenter command center"]
  node_layout["Authenticated workspace<br/>[Layout.tsx]"]
  node_mcp_ui["MCP tool explorer"]
  node_health_ui["Health dashboard"]
  node_settings_ui["Settings and access<br/>[Settings.tsx]"]
  node_http_client["Authenticated API client<br/>[api.ts]"]
end

subgraph group_api["Backend API"]
  node_backend["FastAPI application<br/>[backend.py]"]
  node_api_catalog["API catalog<br/>[service.py]"]
  node_dynamic_executor["Dynamic endpoint execution<br/>[service.py]"]
end

subgraph group_plm["PLM operations"]
  node_search_service["Search engine<br/>[service.py]"]
  node_metadata["Metadata discovery<br/>[service.py]"]
  node_properties["Property service<br/>[service.py]"]
  node_workflow["Slot-filling workflows<br/>[workflow.py]"]
  node_tc_client["Teamcenter API client<br/>[tc_api_client.py]"]
end

subgraph group_ai["AI and MCP"]
  node_mcp_router["MCP administration routes<br/>[router.py]"]
  node_mcp_server["FastMCP tool server<br/>[mcp_server.py]"]
end

subgraph group_state["Data and monitoring"]
  node_database[("SQLite PLM store<br/>[database.py]")]
  node_demo["Demo response simulation<br/>[demo.py]"]
  node_observability[("Request and activity logs<br/>[observability.py]")]
end

node_user(("Engineer or administrator"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_copilot
node_app -->|"routes to"| node_search_ui
node_app -->|"routes to"| node_command_ui
node_app -->|"renders"| node_layout
node_copilot -->|"requests through"| node_http_client
node_search_ui -->|"requests through"| node_http_client
node_command_ui -->|"requests through"| node_http_client
node_mcp_ui -.->|"requests through"| node_http_client
node_health_ui -.->|"requests through"| node_http_client
node_settings_ui -.->|"requests through"| node_http_client
node_http_client -->|"sends HTTP"| node_backend
node_backend -->|"reads and writes"| node_database
node_backend -->|"dispatches workflows"| node_workflow
node_backend -->|"routes catalog requests"| node_api_catalog
node_backend -->|"routes dynamic calls"| node_dynamic_executor
node_backend -->|"routes searches"| node_search_service
node_backend -->|"routes metadata requests"| node_metadata
node_backend -->|"routes property requests"| node_properties
node_backend -->|"routes MCP admin"| node_mcp_router
node_mcp_router -->|"lists and invokes tools"| node_mcp_server
node_mcp_server -->|"uses client"| node_tc_client
node_tc_client -->|"matches mock responses"| node_demo
node_tc_client -->|"logs requests"| node_observability
node_observability -->|"stores log records"| node_database
node_workflow -->|"reads and writes"| node_database
node_backend -->|"records requests"| node_observability
node_backend -.->|"uses MCP tools"| node_mcp_server

click node_app "https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/App.tsx"
click node_copilot "https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/Copilot.tsx"
click node_search_ui "https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/AdvancedSearchPage.tsx"
click node_command_ui "https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/TeamcenterCommandCenter.tsx"
click node_layout "https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/Layout.tsx"
click node_mcp_ui "https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/McpToolExplorer.tsx"
click node_health_ui "https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/TeamcenterHealthDashboard.tsx"
click node_settings_ui "https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/Settings.tsx"
click node_http_client "https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/api.ts"
click node_backend "https://github.com/mansityagi130/teamcenter_ai/blob/main/backend.py"
click node_api_catalog "https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/api_catalog/service.py"
click node_dynamic_executor "https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/dynamic_executor/service.py"
click node_search_service "https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/search_engine/service.py"
click node_metadata "https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/metadata/service.py"
click node_properties "https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/property_service/service.py"
click node_workflow "https://github.com/mansityagi130/teamcenter_ai/blob/main/workflow.py"
click node_mcp_router "https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/mcp_explorer/router.py"
click node_mcp_server "https://github.com/mansityagi130/teamcenter_ai/blob/main/mcp_server.py"
click node_tc_client "https://github.com/mansityagi130/teamcenter_ai/blob/main/tc_api_client.py"
click node_database "https://github.com/mansityagi130/teamcenter_ai/blob/main/services/database.py"
click node_demo "https://github.com/mansityagi130/teamcenter_ai/blob/main/services/demo.py"
click node_observability "https://github.com/mansityagi130/teamcenter_ai/blob/main/services/observability.py"

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_copilot,node_search_ui,node_command_ui,node_layout,node_mcp_ui,node_health_ui,node_settings_ui,node_http_client toneBlue
class node_backend,node_api_catalog,node_dynamic_executor toneAmber
class node_search_service,node_metadata,node_properties,node_workflow,node_tc_client toneMint
class node_mcp_router,node_mcp_server toneRose
class node_database,node_demo,node_observability,node_user toneIndigo
```

## Components

### User interface

- [Application routing](https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/App.tsx): `frontend_src/src/App.tsx`
- [AI Copilot](https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/Copilot.tsx): `frontend_src/src/components/Copilot.tsx`
- [Advanced search](https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/AdvancedSearchPage.tsx): `frontend_src/src/components/AdvancedSearchPage.tsx`
- [Teamcenter command center](https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/TeamcenterCommandCenter.tsx): `frontend_src/src/components/TeamcenterCommandCenter.tsx`
- [Authenticated workspace](https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/Layout.tsx): `frontend_src/src/components/Layout.tsx`
- [MCP tool explorer](https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/McpToolExplorer.tsx): `frontend_src/src/components/McpToolExplorer.tsx`
- [Health dashboard](https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/TeamcenterHealthDashboard.tsx): `frontend_src/src/components/TeamcenterHealthDashboard.tsx`
- [Settings and access](https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/components/Settings.tsx): `frontend_src/src/components/Settings.tsx`
- [Authenticated API client](https://github.com/mansityagi130/teamcenter_ai/blob/main/frontend_src/src/api.ts): `frontend_src/src/api.ts`

### Backend API

- [FastAPI application](https://github.com/mansityagi130/teamcenter_ai/blob/main/backend.py): `backend.py`
- [API catalog](https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/api_catalog/service.py): `backend/teamcenter/api_catalog/service.py`
- [Dynamic endpoint execution](https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/dynamic_executor/service.py): `backend/teamcenter/dynamic_executor/service.py`

### PLM operations

- [Search engine](https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/search_engine/service.py): `backend/teamcenter/search_engine/service.py`
- [Metadata discovery](https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/metadata/service.py): `backend/teamcenter/metadata/service.py`
- [Property service](https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/property_service/service.py): `backend/teamcenter/property_service/service.py`
- [Slot-filling workflows](https://github.com/mansityagi130/teamcenter_ai/blob/main/workflow.py): `workflow.py`
- [Teamcenter API client](https://github.com/mansityagi130/teamcenter_ai/blob/main/tc_api_client.py): `tc_api_client.py`

### AI and MCP

- [MCP administration routes](https://github.com/mansityagi130/teamcenter_ai/blob/main/backend/teamcenter/mcp_explorer/router.py): `backend/teamcenter/mcp_explorer/router.py`
- [FastMCP tool server](https://github.com/mansityagi130/teamcenter_ai/blob/main/mcp_server.py): `mcp_server.py`

### Data and monitoring

- [SQLite PLM store](https://github.com/mansityagi130/teamcenter_ai/blob/main/services/database.py): `services/database.py`
- [Demo response simulation](https://github.com/mansityagi130/teamcenter_ai/blob/main/services/demo.py): `services/demo.py`
- [Request and activity logs](https://github.com/mansityagi130/teamcenter_ai/blob/main/services/observability.py): `services/observability.py`

### Other components

- **Engineer or administrator**

## Connections

- Engineer or administrator → Application routing: uses
- Application routing → AI Copilot: routes to (evidence: `frontend_src/src/App.tsx`)
- Application routing → Advanced search: routes to (evidence: `frontend_src/src/App.tsx`)
- Application routing → Teamcenter command center: routes to (evidence: `frontend_src/src/App.tsx`)
- Application routing → Authenticated workspace: renders (evidence: `frontend_src/src/App.tsx`)
- AI Copilot → Authenticated API client: requests through
- Advanced search → Authenticated API client: requests through (evidence: `frontend_src/src/components/AdvancedSearchPage.tsx`)
- Teamcenter command center → Authenticated API client: requests through (evidence: `frontend_src/src/components/TeamcenterCommandCenter.tsx`)
- MCP tool explorer → Authenticated API client: requests through
- Health dashboard → Authenticated API client: requests through
- Settings and access → Authenticated API client: requests through
- Authenticated API client → FastAPI application: sends HTTP
- FastAPI application → SQLite PLM store: reads and writes (evidence: `backend.py`)
- FastAPI application → Slot-filling workflows: dispatches workflows (evidence: `backend.py`)
- FastAPI application → API catalog: routes catalog requests (evidence: `backend.py`)
- FastAPI application → Dynamic endpoint execution: routes dynamic calls (evidence: `backend.py`)
- FastAPI application → Search engine: routes searches (evidence: `backend.py`)
- FastAPI application → Metadata discovery: routes metadata requests (evidence: `backend.py`)
- FastAPI application → Property service: routes property requests (evidence: `backend.py`)
- FastAPI application → MCP administration routes: routes MCP admin (evidence: `backend.py`)
- MCP administration routes → FastMCP tool server: lists and invokes tools (evidence: `backend/teamcenter/mcp_explorer/router.py`)
- FastMCP tool server → Teamcenter API client: uses client (evidence: `mcp_server.py`)
- Teamcenter API client → Demo response simulation: matches mock responses (evidence: `tc_api_client.py`)
- Teamcenter API client → Request and activity logs: logs requests (evidence: `tc_api_client.py`)
- Request and activity logs → SQLite PLM store: stores log records (evidence: `services/observability.py`)
- Slot-filling workflows → SQLite PLM store: reads and writes (evidence: `workflow.py`)
- FastAPI application → Request and activity logs: records requests (evidence: `backend.py`)
- FastAPI application → FastMCP tool server: uses MCP tools
