# drincdalin/bot-fundvoiculescu architecture

> Architecture diagram of the GitHub repository drincdalin/bot-fundvoiculescu, 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/drincdalin/bot-fundvoiculescu
- Repository: https://github.com/drincdalin/bot-fundvoiculescu

## Overview

This single-script Python bot automates repeated voting: its entry point opens the voting site, creates a temporary mail.tm account, submits the candidate vote, retrieves and enters the email code, then logs successful attempts. The script also configures/restarts Chrome and uses randomized waits. The README documents these capabilities; the source excerpt confirms the workflow and internal helpers. This map describes the documented automation, not whether it succeeds against current services.

Main entry points: [`vot_fundvoiculescu.py`](https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py) (Vote runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Vote workflow"]
  node_runner["Vote runner"]
  node_candidate_vote["Candidate vote"]
  node_mail_account["Mail account"]
  node_verification["Code retrieval"]
end

subgraph group_support["Automation support"]
  node_browser["Chrome driver"]
  node_human_timing["Random waits"]
  node_safe_click["Safe click"]
end

subgraph group_state["Local state"]
  node_logs[("Vote log")]
end

node_user(("Operator"))
node_voting_site["Voting site"]
node_mail_tm["Mail.tm API"]

node_user -->|"starts"| node_runner
node_runner -->|"creates and restarts"| node_browser
node_runner -->|"requests account"| node_mail_account
node_mail_account -->|"creates account"| node_mail_tm
node_runner -->|"runs attempts"| node_candidate_vote
node_candidate_vote -->|"submits vote"| node_voting_site
node_candidate_vote -->|"requests code"| node_verification
node_verification -->|"reads messages"| node_mail_tm
node_verification -->|"returns code"| node_candidate_vote
node_runner -->|"calls waits"| node_human_timing
node_candidate_vote -->|"clicks controls"| node_safe_click
node_runner -->|"loads summary"| node_logs
node_candidate_vote -->|"saves success"| node_logs

click node_runner "https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py"
click node_candidate_vote "https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py"
click node_mail_account "https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py"
click node_verification "https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py"
click node_browser "https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py"
click node_human_timing "https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py"
click node_safe_click "https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py"
click node_logs "https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.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_runner,node_candidate_vote,node_mail_account,node_verification toneBlue
class node_browser,node_human_timing,node_safe_click toneAmber
class node_logs,node_mail_tm toneMint
class node_user,node_voting_site toneIndigo
```

## Components

### Vote workflow

- [Vote runner](https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py): `vot_fundvoiculescu.py`
- [Candidate vote](https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py): `vot_fundvoiculescu.py`
- [Mail account](https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py): `vot_fundvoiculescu.py`
- [Code retrieval](https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py): `vot_fundvoiculescu.py`

### Automation support

- [Chrome driver](https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py): `vot_fundvoiculescu.py`
- [Random waits](https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py): `vot_fundvoiculescu.py`
- [Safe click](https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py): `vot_fundvoiculescu.py`

### Local state

- [Vote log](https://github.com/drincdalin/bot-fundvoiculescu/blob/main/vot_fundvoiculescu.py): `vot_fundvoiculescu.py`

### Other components

- **Operator**
- **Voting site**
- **Mail.tm API**

## Connections

- Operator → Vote runner: starts (evidence: `README.md`)
- Vote runner → Chrome driver: creates and restarts (evidence: `vot_fundvoiculescu.py`)
- Vote runner → Mail account: requests account (evidence: `vot_fundvoiculescu.py`)
- Mail account → Mail.tm API: creates account (evidence: `vot_fundvoiculescu.py`)
- Vote runner → Candidate vote: runs attempts (evidence: `vot_fundvoiculescu.py`)
- Candidate vote → Voting site: submits vote (evidence: `vot_fundvoiculescu.py`)
- Candidate vote → Code retrieval: requests code (evidence: `vot_fundvoiculescu.py`)
- Code retrieval → Mail.tm API: reads messages (evidence: `vot_fundvoiculescu.py`)
- Code retrieval → Candidate vote: returns code (evidence: `vot_fundvoiculescu.py`)
- Vote runner → Random waits: calls waits (evidence: `vot_fundvoiculescu.py`)
- Candidate vote → Safe click: clicks controls (evidence: `vot_fundvoiculescu.py`)
- Vote runner → Vote log: loads summary (evidence: `vot_fundvoiculescu.py`)
- Candidate vote → Vote log: saves success (evidence: `vot_fundvoiculescu.py`)
