Gerador de Currículos ATS

Template — Gere currículos compatíveis com sistemas ATS nos formatos DOCX e Markdown a partir de um único arquivo JSON. Desenvolvido com TypeScript e Arquitetura Limpa (Clean Architecture).

Recursos

• Gera currículos nos formatos .docx e .md para diferentes objetivos profissionais.
• Extrai palavras-chave de uma descrição de vaga e as incorpora ao currículo.
• Todos os seus dados pessoais ficam centralizados em um único arquivo resume.json (ignorado pelo Git — nunca é enviado ao repositório).
• Toda a configuração dos perfis profissionais fica em arquivos JSON dentro da pasta config/, sem necessidade de alterar código TypeScript.
• Arquitetura baseada em Clean Architecture: Domínio → Aplicação → Infraestrutura → Apresentação.

---

Início Rápido

# 1. Clone o repositório ou utilize este template
git clone https://github.com/your-user/ats-cv-generator.git
cd ats-cv-generator

# 2. Instale as dependências
npm install

# 3. Crie seu arquivo de currículo
cp resume.example.json resume.json
# ✏️ Edite o arquivo resume.json com seus dados reais

# 4. Gere todos os currículos (DOCX)
npm run generate -- --all

# 5. Os arquivos gerados estarão na pasta ./output/

---

Personalização

1. Seus dados pessoais → resume.json

Copie resume.example.json para resume.json e preencha todos os campos.

O arquivo resume.json é ignorado pelo Git, garantindo que seus dados pessoais nunca sejam enviados ao repositório.

2. Perfis profissionais → config/focuses.json

Cada chave representa um perfil profissional. Você pode adicionar, renomear ou remover perfis conforme desejar.

{
  "node_react": {
    "filename": "Curriculo_Node_React.docx",
    "title": "Engenheiro Full Stack Node.js"
  }
}

3. Resumos profissionais → config/profiles.json

Defina um resumo profissional para cada perfil. O texto pode ser escrito em primeira ou terceira pessoa.

{
  "node_react": "Engenheiro de Software especializado em..."
}

4. Competências → config/skills.json

As habilidades são organizadas por categoria e exibidas na ordem definida no arquivo.

{
  "node_react": {
    "Linguagens": ["TypeScript", "JavaScript"],
    "Backend": ["Node.js", "Express.js"]
  }
}

5. Regras de impacto → config/impact-rules.json

Relaciona empresas (com o mesmo nome utilizado em resume.json) a métricas baseadas em palavras-chave.

Quando uma atividade profissional contém alguma das palavras-chave definidas, o resultado correspondente é automaticamente acrescentado à descrição.

{
  "Acme Corp": [
    {
      "keywords": ["api", "rest"],
      "result": "Redução de 30% no tempo de resposta dos serviços"
    }
  ]
}

---

Utilização pela Linha de Comando (CLI)

# Gerar todos os perfis (DOCX)
npm run generate -- --all

# Gerar apenas um perfil
npm run generate -- --focus=node_react

# Gerar currículo personalizado a partir de uma descrição de vaga
npm run generate -- --focus=node_react --job=descricao-da-vaga.txt

# Gerar todos os currículos em Markdown
npm run generate -- --all --markdown

# Gerar todos os perfis utilizando uma descrição de vaga
npm run generate -- --all --job=descricao-da-vaga.txt

Opções disponíveis

Opção	Descrição
--all	Gera todos os perfis configurados
--focus=<id>	Gera apenas um perfil específico
--job=<arquivo>	Caminho para um arquivo .txt contendo a descrição da vaga para extração de palavras-chave
--markdown	Gera arquivos .md em vez de .docx

---

Estrutura do Projeto

ats-cv-generator/
├── src/
│   ├── domain/                     # Regras de negócio (sem dependências externas)
│   │   ├── entities/
│   │   ├── interfaces/
│   │   └── services/
│   ├── application/                # Casos de uso
│   ├── infrastructure/             # Adaptadores externos
│   ├── presentation/               # Interface de linha de comando (CLI)
│   └── main.ts                     # Ponto de entrada
├── config/                         # Arquivos de configuração
│   ├── focuses.json
│   ├── profiles.json
│   ├── skills.json
│   └── impact-rules.json
├── resume.example.json             # Modelo de currículo
├── resume.json                     # Seus dados (ignorado pelo Git)
├── output/                         # Currículos gerados (ignorado pelo Git)
├── tsconfig.json
└── package.json

---

Arquitetura

        Argumentos CLI
              │
    ┌─────────▼──────────┐
    │ Apresentação (CLI) │
    └─────────┬──────────┘
              │
    ┌─────────▼──────────┐
    │     Aplicação      │
    └─────────┬──────────┘
              │
    ┌─────────▼──────────┐
    │      Domínio       │
    └─────────┬──────────┘
              │
    ┌─────────▼──────────┐
    │   Infraestrutura   │
    └────────────────────┘

A camada de Domínio possui zero dependências externas. Ela não depende de bibliotecas como fs, docx ou path, tornando as regras de negócio independentes e facilmente testáveis.

---

Compilação

# Compila o projeto para a pasta dist/
npm run build

# Executa a versão compilada
npm run generate:compiled -- --all

---

Licença

Este projeto está licenciado sob a Licença MIT.