# leosousajesus/agente-vagas-python architecture

> Architecture diagram of the GitHub repository leosousajesus/agente-vagas-python, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/leosousajesus/agente-vagas-python
- Repository: https://github.com/leosousajesus/agente-vagas-python

## Overview

O agente percorre categorias de tecnologia escolhidas no menu local ou todas no modo GitHub Actions, coleta vagas do Programathor, filtra descrições com Gemini e notifica matches no Telegram. O histórico persistente evita reanálises. As relações abaixo se baseiam no README e no único módulo de runtime exibido; a implementação do agendamento e do arquivo de histórico não foi inspecionada.

Main entry points: [`agente_final.py`](https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py) (Extração de vagas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Execução e busca"]
  node_agent["Agente de vagas<br/>[agente_final.py]"]
  node_category_selection["Seleção de categorias<br/>[agente_final.py]"]
  node_category_search["Busca por categoria<br/>[agente_final.py]"]
  node_job_parser["Extração de vagas<br/>[agente_final.py]"]
end

subgraph group_qualification["Qualificação de vagas"]
  node_ai_analysis["Análise Gemini<br/>[agente_final.py]"]
  node_match_filter["Filtro de match<br/>[agente_final.py]"]
end

subgraph group_state_delivery["Estado e notificações"]
  node_history[("Histórico de vagas<br/>[agente_final.py]")]
  node_telegram_sender["Envio Telegram<br/>[agente_final.py]"]
end

node_user(("Usuário local"))
node_github_actions(("GitHub Actions"))
node_job_site["Programathor"]
node_gemini["Google Gemini"]
node_telegram["Telegram Bot API"]

node_user -->|"inicia"| node_agent
node_github_actions -->|"executa diariamente"| node_agent
node_agent -->|"inicia"| node_category_selection
node_category_selection -->|"seleciona termos"| node_category_search
node_category_search -->|"busca páginas"| node_job_site
node_category_search -->|"entrega páginas"| node_job_parser
node_job_parser -->|"consulta e atualiza"| node_history
node_job_parser -->|"envia descrição"| node_ai_analysis
node_ai_analysis -->|"solicita análise"| node_gemini
node_ai_analysis -->|"retorna JSON"| node_match_filter
node_job_parser -->|"encaminha matches"| node_telegram_sender
node_telegram_sender -->|"envia mensagem"| node_telegram

click node_agent "https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py"
click node_category_selection "https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py"
click node_category_search "https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py"
click node_job_parser "https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py"
click node_history "https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py"
click node_ai_analysis "https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py"
click node_match_filter "https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py"
click node_telegram_sender "https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.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_agent,node_category_selection,node_category_search,node_job_parser toneBlue
class node_ai_analysis,node_match_filter toneAmber
class node_history,node_telegram_sender,node_telegram toneMint
class node_user,node_github_actions,node_job_site,node_gemini toneIndigo
```

## Components

### Execução e busca

- [Agente de vagas](https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py): `agente_final.py`
- [Seleção de categorias](https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py): `agente_final.py`
- [Busca por categoria](https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py): `agente_final.py`
- [Extração de vagas](https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py): `agente_final.py`

### Qualificação de vagas

- [Análise Gemini](https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py): `agente_final.py`
- [Filtro de match](https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py): `agente_final.py`

### Estado e notificações

- [Histórico de vagas](https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py): `agente_final.py`
- [Envio Telegram](https://github.com/leosousajesus/agente-vagas-python/blob/main/agente_final.py): `agente_final.py`

### Other components

- **Usuário local**
- **GitHub Actions**
- **Programathor**
- **Google Gemini**
- **Telegram Bot API**

## Connections

- Usuário local → Agente de vagas: inicia (evidence: `README.md`)
- GitHub Actions → Agente de vagas: executa diariamente (evidence: `README.md`)
- Agente de vagas → Seleção de categorias: inicia (evidence: `agente_final.py`)
- Seleção de categorias → Busca por categoria: seleciona termos (evidence: `agente_final.py`)
- Busca por categoria → Programathor: busca páginas (evidence: `agente_final.py`)
- Busca por categoria → Extração de vagas: entrega páginas (evidence: `agente_final.py`)
- Extração de vagas → Histórico de vagas: consulta e atualiza (evidence: `agente_final.py`)
- Extração de vagas → Análise Gemini: envia descrição (evidence: `agente_final.py`)
- Análise Gemini → Google Gemini: solicita análise (evidence: `agente_final.py`)
- Análise Gemini → Filtro de match: retorna JSON (evidence: `agente_final.py`)
- Extração de vagas → Envio Telegram: encaminha matches (evidence: `agente_final.py`)
- Envio Telegram → Telegram Bot API: envia mensagem (evidence: `agente_final.py`)
