FILE_STRUCTURE.md

IntegraChat - Current File Structure

IntegraChat/
├── backend/
│   ├── api/
│   │   ├── main.py                          # FastAPI main application
│   │   ├── mcp_clients/
│   │   │   ├── admin_client.py              # Admin MCP client
│   │   │   ├── mcp_client.py                # Main MCP client wrapper
│   │   │   ├── rag_client.py                # RAG MCP client
│   │   │   └── web_client.py                 # Web search MCP client
│   │   ├── models/
│   │   │   ├── __init__.py
│   │   │   ├── agent.py                     # Agent request/response models
│   │   │   └── redflag.py                   # Red flag rule models
│   │   ├── routes/
│   │   │   ├── admin.py                     # Admin routes
│   │   │   ├── agent.py                     # Agent chat routes
│   │   │   ├── analytics.py                 # Analytics routes
│   │   │   ├── rag.py                       # RAG routes
│   │   │   └── web.py                       # Web search routes
│   │   ├── services/
│   │   │   ├── agent_orchestrator.py        # Main orchestrator (multi-tool execution)
│   │   │   ├── intent_classifier.py         # Intent classification service
│   │   │   ├── llm_client.py                # LLM client (Ollama/Groq)
│   │   │   ├── prompt_builder.py            # Prompt building utilities
│   │   │   ├── redflag_detector.py          # Red flag detection service
│   │   │   └── tool_selector.py             # Multi-tool selection logic
│   │   └── utils/
│   │       └── text_extractor.py            # Text extraction utilities
│   ├── mcp_server/
│   │   ├── server.py                        # Unified MCP entrypoint (rag/web/admin)
│   │   ├── rag/                             # RAG tool handlers (search/ingest/delete)
│   │   ├── web/                             # Web search tool handler
│   │   ├── admin/                           # Admin rules + violations tools
│   │   └── common/                          # Shared tenant/logging/utils helpers
│   ├── tests/
│   │   ├── conftest.py                      # Pytest configuration
│   │   ├── test_agent_orchestrator.py       # Orchestrator tests
│   │   └── test_intent.py                   # Intent classification tests
│   └── workers/                             # Background workers (empty)
│
├── venv/                                    # Python virtual environment
├── env.example                              # Environment variables template
├── pytest.ini                               # Pytest configuration
├── README.md                                # Project documentation
├── requirements.txt                         # Python dependencies
└── start.bat                                # Windows startup script

Key Files Overview

Core Services

• agent_orchestrator.py - Main orchestrator handling multi-tool execution
• tool_selector.py - Intelligent multi-tool selection (RAG + Web + LLM)
• intent_classifier.py - Classifies user intent
• redflag_detector.py - Detects policy violations

MCP Servers

• backend/mcp_server/server.py - Unified MCP entrypoint (rag/web/admin tools)
• backend/mcp_server/rag/*.py - RAG tool handlers (search/ingest/delete)
• backend/mcp_server/web/search.py - DuckDuckGo handler
• backend/mcp_server/admin/*.py - Admin rules & violations tools

API Routes

• agent.py - Main chat/agent endpoint
• rag.py - RAG operations
• web.py - Web search operations
• admin.py - Admin operations
• analytics.py - Analytics endpoints

Models

• agent.py - AgentRequest, AgentDecision, AgentResponse
• redflag.py - RedFlagRule, RedFlagMatch

MCP Clients

• mcp_client.py - Unified MCP client wrapper
• rag_client.py - RAG client
• web_client.py - Web search client
• admin_client.py - Admin client