# romanvintoniak/carinsurancesales architecture

> Architecture diagram of the GitHub repository romanvintoniak/carinsurancesales, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/romanvintoniak/carinsurancesales
- Repository: https://github.com/romanvintoniak/carinsurancesales

## Overview

##### Project type and purpose
- This is a .NET solution that implements a Telegram bot (CarInsuranceSalesBot).
- CarInsuranceSales.Api exposes HTTP endpoints (for Telegram webhook or API testing) and wires up the bot.
- CarInsuranceSales.Core is the application layer: it contains command handlers (BuyCarInsuranceCommand, ConfirmDocumentsDataCommand, etc.), document-data providers (Mindee or fake), policy providers (OpenAI or fake), models, configuration, and shared helpers.

##### File structure
- Top-level solution (CarInsuranceSales.sln) ties together two projects:
- CarInsuranceSales.Api
– Controllers/InsuranceSalesBotController.cs
– Program.cs (configures ASP.NET Core pipeline, DI, Telegram.Bot, routing)
– appsettings.json (TelegramBotToken, MindeeApiKey, OpenAiApiKey, PolicyDocumentUrl)
- CarInsuranceSales.Core
– Commands/…Command.cs (each bot action is a command implementing IBotCommand)
– DocumentDataProviders/…Provider.cs (implement IDocumentDataProvider)
– PolicyProviders/…Provider.cs (implement IPolicyProvider)
– Interfaces (IBotCommand, IDocumentDataProvider, IPolicyProvider)
– Models (DocumentData)
– Configuration (AppOptions) and Prompts.cs
- No dedicated database layer: the project relies on external APIs for document extraction and policy generation.

##### README for additional insights
- Lists dependencies: Telegram.Bot SDK, Mindee API client, OpenAI SDK.
- Specifies that the user sends documents → Mindee processes them → the bot asks for confirmations → OpenAI generates policy text → transaction completes.

##### Elements
- Clear labels: “Telegram User”, “Telegram Bot API”, “ASP.NET Core API”, “Command Dispatcher”, “Mindee OCR Service”, “OpenAI Service”.
- from User to Telegram Bot API
- from Bot API to your Webhook endpoint
- between Webhook controller and Command Dispatcher
- from commands to external APIs, back to controller, back to user
- Rectangles for internal components (API, dispatcher, commands)
- Cloud symbols for external services (Mindee, OpenAI, Telegram)

##### Detailed breakdown for maximal clarity
- Command Handlers (each user intent)
- DocumentDataProviders (multiple strategies)
- PolicyProviders (multiple strategies)
- Shared Models & Prompts
- Configuration node showing the appsettings.json keys.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Services
    subgraph "External Services"
        direction TB
        User["Telegram User"]:::external
        TBAPI["Telegram Bot API"]:::external
        Mindee["Mindee OCR Service"]:::external
        OpenAI["OpenAI Service"]:::external
    end

    %% API Layer
    subgraph "ASP.NET Core API"
        direction TB
        Controller["InsuranceSalesBotController"]:::api
        Program["Program (Host & DI)"]:::api
        AppSettings["appsettings.json/.Development"]:::config
    end

    %% Core Layer
    subgraph "Core Library" 
        direction TB
        Dispatcher["Bot Command Dispatcher"]:::core
        subgraph "Commands"
            direction TB
            BuyCI["BuyCarInsuranceCommand"]:::command
            CancelCI["CancelBuyingCarInsuranceCommand"]:::command
            ConfirmDocs["ConfirmDocumentsDataCommand"]:::command
            DisagreePrice["DisagreePriceCommand"]:::command
            ProcessDocs["ProcessDocumentsCommand"]:::command
            ResubmitDocs["ResubmitDocumentsCommand"]:::command
            Welcome["WelcomeCommand"]:::command
        end
        IBotCmd["IBotCommand"]:::core

        subgraph "DocumentDataProviders"
            direction TB
            MindeeProv["MindeeDocumentDataProvider"]:::provider
            FakeProv["FakeDocumentDataProvider"]:::provider
            IDocProv["IDocumentDataProvider"]:::core
        end

        subgraph "PolicyProviders"
            direction TB
            OpenAIProv["OpenAiPolicyProvider"]:::provider
            FakePolicy["FakePolicyProvider"]:::provider
            IPolicyProv["IPolicyProvider"]:::core
        end

        subgraph "Models & Prompts"
            direction TB
            DocData["DocumentData model"]:::model
            Prompts["Prompts definitions"]:::model
            Helpers["Helper utilities"]:::model
        end

        AppOptions["AppOptions (Configuration)"]:::config
    end

    %% Connections
    User -->|"sends message/media"| TBAPI
    TBAPI -->|"webhook"| Controller
    Controller -->|"dispatch"| Dispatcher
    Dispatcher -->|"implements"| IBotCmd
    Dispatcher --> BuyCI
    Dispatcher --> CancelCI
    Dispatcher --> ConfirmDocs
    Dispatcher --> DisagreePrice
    Dispatcher --> ProcessDocs
    Dispatcher --> ResubmitDocs
    Dispatcher --> Welcome

    BuyCI --> IDocProv
    CancelCI --> IDocProv
    ConfirmDocs --> IDocProv
    ProcessDocs --> IDocProv
    ResubmitDocs --> IDocProv

    IDocProv --> MindeeProv
    IDocProv --> FakeProv
    MindeeProv --> Mindee
    FakeProv -->|"stub"| DocData

    BuyCI --> IPolicyProv
    ConfirmDocs --> IPolicyProv
    DisagreePrice --> IPolicyProv
    ProcessDocs --> IPolicyProv
    ResubmitDocs --> IPolicyProv

    IPolicyProv --> OpenAIProv
    IPolicyProv --> FakePolicy
    OpenAIProv --> OpenAI
    FakePolicy -->|"stub"| DocData

    Dispatcher --> DocData
    Dispatcher --> Prompts
    Dispatcher --> Helpers

    Controller --> Program
    Program --> AppSettings
    AppSettings --> AppOptions
    Program --> Dispatcher

    Controller -->|"responds via"| TBAPI

    %% Click Events
    click Controller "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Api/Controllers/InsuranceSalesBotController.cs"
    click Program "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Api/Program.cs"
    click AppSettings "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Api/appsettings.json"
    click AppSettings "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Api/appsettings.Development.json"
    click AppOptions "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Configuration/AppOptions.cs"
    click BuyCI "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Commands/BuyCarInsuranceCommand.cs"
    click CancelCI "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Commands/CancelBuyingCarInsuranceCommand.cs"
    click ConfirmDocs "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Commands/ConfirmDocumentsDataCommand.cs"
    click DisagreePrice "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Commands/DisagreePriceCommand.cs"
    click ProcessDocs "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Commands/ProcessDocumentsCommand.cs"
    click ResubmitDocs "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Commands/ResubmitDocumentsCommand.cs"
    click Welcome "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Commands/WelcomeCommand.cs"
    click IBotCmd "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Interfaces/IBotCommand.cs"
    click MindeeProv "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/DocumentDataProviders/MindeeDocumentDataProvider.cs"
    click FakeProv "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/DocumentDataProviders/FakeDocumentDataProvider.cs"
    click IDocProv "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Interfaces/IDocumentDataProvider.cs"
    click OpenAIProv "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/PolicyProviders/OpenAiPolicyProvider.cs"
    click FakePolicy "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/PolicyProviders/FakePolicyProvider.cs"
    click IPolicyProv "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Interfaces/IPolicyProvider.cs"
    click DocData "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Models/DocumentData.cs"
    click Prompts "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Prompts.cs"
    click Helpers "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.Core/Helpers.cs"
    click README "https://github.com/romanvintoniak/carinsurancesales/blob/master/README.md"
    click SLN "https://github.com/romanvintoniak/carinsurancesales/blob/master/CarInsuranceSales.sln"

    %% Styles
    classDef external fill:#B0E0E6,stroke:#333,stroke-width:1px
    classDef api fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef core fill:#FFA500,stroke:#333,stroke-width:1px
    classDef command fill:#90EE90,stroke:#333,stroke-width:1px
    classDef provider fill:#98FB98,stroke:#333,stroke-width:1px
    classDef model fill:#FFFFE0,stroke:#333,stroke-width:1px
    classDef config fill:#FFB6C1,stroke:#333,stroke-width:1px
```
