# sergeyprist/raccoon-test architecture

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

- Interactive diagram: https://gitdiagram.com/sergeyprist/raccoon-test
- Repository: https://github.com/sergeyprist/raccoon-test

## Overview

This PHP application models user-setting changes that require verification: a frontend request reaches the controller, the settings service creates and dispatches a code, and a later request validates it before applying the change. The README also documents SMS, email, and Telegram delivery and a user-to-many-confirmations database relationship. The excerpts show the service and sender selection logic, but persistence and external delivery are comments or otherwise unspecified; those links are marked unverified rather than presented as implemented integrations.

Main entry points: [`Service/UserSettingsService.php`](https://github.com/sergeyprist/raccoon-test/blob/master/Service/UserSettingsService.php) (Settings service), [`Components/SendVerificationCodeFactory.php`](https://github.com/sergeyprist/raccoon-test/blob/master/Components/SendVerificationCodeFactory.php) (Sender factory), [`Components/SendEmailVerificationCode.php`](https://github.com/sergeyprist/raccoon-test/blob/master/Components/SendEmailVerificationCode.php) (Email sender), [`Components/SendSMSVerificationCode.php`](https://github.com/sergeyprist/raccoon-test/blob/master/Components/SendSMSVerificationCode.php) (SMS sender)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_request["Request handling"]
  node_controller["User controller<br/>[UserController.php]"]
end

subgraph group_verification["Verification workflow"]
  node_settings_service["Settings service"]
  node_confirmation_service["Confirmation service"]
end

subgraph group_delivery["Code delivery"]
  node_factory["Sender factory"]
  node_sender_contract["Sender interface"]
  node_email_sender["Email sender"]
  node_sms_sender["SMS sender"]
  node_telegram_sender["Telegram sender"]
end

subgraph group_state["User state"]
  node_user["User entity<br/>[User.php]"]
  node_confirmation["Confirmation entity"]
  node_database[("Application database")]
end

node_frontend(("Frontend"))
node_email_service["Email delivery"]
node_sms_service["SMS delivery"]
node_telegram_service["Telegram delivery"]

node_frontend -->|"sends requests"| node_controller
node_controller -->|"calls"| node_settings_service
node_settings_service -->|"selects sender"| node_factory
node_settings_service -->|"creates and validates codes"| node_confirmation_service
node_settings_service -->|"reads and updates"| node_user
node_settings_service -.->|"dispatches code"| node_email_sender
node_settings_service -.->|"dispatches code"| node_sms_sender
node_settings_service -.->|"dispatches code"| node_telegram_sender
node_factory -->|"creates"| node_email_sender
node_factory -->|"creates"| node_sms_sender
node_factory -->|"creates"| node_telegram_sender
node_email_sender -->|"implements"| node_sender_contract
node_sms_sender -->|"implements"| node_sender_contract
node_telegram_sender -->|"implements"| node_sender_contract
node_email_sender -.->|"sends code"| node_email_service
node_sms_sender -.->|"sends code"| node_sms_service
node_telegram_sender -.->|"sends code"| node_telegram_service
node_confirmation_service -->|"creates and checks"| node_confirmation
node_confirmation_service -.->|"persists and looks up"| node_database
node_settings_service -.->|"saves user changes"| node_database

click node_controller "https://github.com/sergeyprist/raccoon-test/blob/master/Controller/UserController.php"
click node_settings_service "https://github.com/sergeyprist/raccoon-test/blob/master/Service/UserSettingsService.php"
click node_confirmation_service "https://github.com/sergeyprist/raccoon-test/blob/master/Service/UserSettingsConfirmationService.php"
click node_factory "https://github.com/sergeyprist/raccoon-test/blob/master/Components/SendVerificationCodeFactory.php"
click node_sender_contract "https://github.com/sergeyprist/raccoon-test/blob/master/Components/Interface/SendVerificationCodeInterface.php"
click node_email_sender "https://github.com/sergeyprist/raccoon-test/blob/master/Components/SendEmailVerificationCode.php"
click node_sms_sender "https://github.com/sergeyprist/raccoon-test/blob/master/Components/SendSMSVerificationCode.php"
click node_telegram_sender "https://github.com/sergeyprist/raccoon-test/blob/master/Components/SendTelegramVerificationCode.php"
click node_user "https://github.com/sergeyprist/raccoon-test/blob/master/Entity/User.php"
click node_confirmation "https://github.com/sergeyprist/raccoon-test/blob/master/Entity/UserSettingsConfirmation.php"

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_controller,node_frontend toneBlue
class node_settings_service,node_confirmation_service toneAmber
class node_factory,node_sender_contract,node_email_sender,node_sms_sender,node_telegram_sender toneMint
class node_user,node_confirmation,node_database toneRose
class node_email_service,node_sms_service,node_telegram_service toneIndigo
```

## Components

### Request handling

- [User controller](https://github.com/sergeyprist/raccoon-test/blob/master/Controller/UserController.php): `Controller/UserController.php`

### Verification workflow

- [Settings service](https://github.com/sergeyprist/raccoon-test/blob/master/Service/UserSettingsService.php): `Service/UserSettingsService.php`
- [Confirmation service](https://github.com/sergeyprist/raccoon-test/blob/master/Service/UserSettingsConfirmationService.php): `Service/UserSettingsConfirmationService.php`

### Code delivery

- [Sender factory](https://github.com/sergeyprist/raccoon-test/blob/master/Components/SendVerificationCodeFactory.php): `Components/SendVerificationCodeFactory.php`
- [Sender interface](https://github.com/sergeyprist/raccoon-test/blob/master/Components/Interface/SendVerificationCodeInterface.php): `Components/Interface/SendVerificationCodeInterface.php`
- [Email sender](https://github.com/sergeyprist/raccoon-test/blob/master/Components/SendEmailVerificationCode.php): `Components/SendEmailVerificationCode.php`
- [SMS sender](https://github.com/sergeyprist/raccoon-test/blob/master/Components/SendSMSVerificationCode.php): `Components/SendSMSVerificationCode.php`
- [Telegram sender](https://github.com/sergeyprist/raccoon-test/blob/master/Components/SendTelegramVerificationCode.php): `Components/SendTelegramVerificationCode.php`

### User state

- [User entity](https://github.com/sergeyprist/raccoon-test/blob/master/Entity/User.php): `Entity/User.php`
- [Confirmation entity](https://github.com/sergeyprist/raccoon-test/blob/master/Entity/UserSettingsConfirmation.php): `Entity/UserSettingsConfirmation.php`
- **Application database**

### Other components

- **Frontend**
- **Email delivery**
- **SMS delivery**
- **Telegram delivery**

## Connections

- Frontend → User controller: sends requests (evidence: `README.md`)
- User controller → Settings service: calls (evidence: `Controller/UserController.php`)
- Settings service → Sender factory: selects sender (evidence: `Service/UserSettingsService.php`)
- Settings service → Confirmation service: creates and validates codes (evidence: `Service/UserSettingsService.php`)
- Settings service → User entity: reads and updates (evidence: `Service/UserSettingsService.php`)
- Settings service → Email sender: dispatches code
- Settings service → SMS sender: dispatches code
- Settings service → Telegram sender: dispatches code
- Sender factory → Email sender: creates (evidence: `Components/SendVerificationCodeFactory.php`)
- Sender factory → SMS sender: creates (evidence: `Components/SendVerificationCodeFactory.php`)
- Sender factory → Telegram sender: creates (evidence: `Components/SendVerificationCodeFactory.php`)
- Email sender → Sender interface: implements (evidence: `Components/SendEmailVerificationCode.php`)
- SMS sender → Sender interface: implements (evidence: `Components/SendSMSVerificationCode.php`)
- Telegram sender → Sender interface: implements (evidence: `Components/SendTelegramVerificationCode.php`)
- Email sender → Email delivery: sends code (evidence: `Components/SendEmailVerificationCode.php`)
- SMS sender → SMS delivery: sends code (evidence: `Components/SendSMSVerificationCode.php`)
- Telegram sender → Telegram delivery: sends code (evidence: `Components/SendTelegramVerificationCode.php`)
- Confirmation service → Confirmation entity: creates and checks (evidence: `Service/UserSettingsConfirmationService.php`)
- Confirmation service → Application database: persists and looks up
- Settings service → Application database: saves user changes
