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_servers/
│   │   ├── admin_server.py                  # Admin MCP server
│   │   ├── database.py                      # Database connection utilities
│   │   ├── embeddings.py                    # Embedding generation
│   │   ├── main.py                          # RAG MCP server main
│   │   ├── rag_server.py                    # RAG MCP server
│   │   ├── web_server.py                    # Web search MCP server (English results)
│   │   └── models/
│   │       ├── __init__.py
│   │       ├── admin.py                     # Admin request models
│   │       ├── rag.py                       # RAG request models
│   │       └── web.py                       # Web search request models
│   ├── 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

• rag_server.py - RAG/knowledge retrieval server
• web_server.py - Web search server (forces English results)
• admin_server.py - Admin/governance server

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