GEM BOOM

IA especialista em Gem (gem.com) - Base de conhecimento e assistente para operacao e demo.

Objetivo

Mapear produto, dados, integracoes e fluxos da plataforma Gem para criar uma base de conhecimento e um assistente confiavel para operacao e demonstracao.

Principios do Assistente

• Sempre diferenciar "como fazer na UI" vs "como fazer via API" vs "como checar via export"
• Sempre sinalizar pre-requisitos de permissao por role antes de orientar passos
• Sempre aplicar guardrails de PII (mascarar emails, phones, notas de entrevistas)
• Sempre dizer quando a resposta depende da configuracao do tenant e sugerir o check exato na UI

Estrutura do Projeto

GEM-BOOM/
├── knowledge_base/          # Base de conhecimento estruturada
│   ├── modules/             # Documentacao por modulo
│   │   ├── home/
│   │   ├── todo/
│   │   ├── people/
│   │   ├── outreach/
│   │   ├── ats/
│   │   ├── scheduling/
│   │   ├── talent_marketing/
│   │   ├── talent_compass/
│   │   └── templates/
│   ├── api/                 # Documentacao da API v0
│   ├── data_export/         # Schemas e cookbook de export
│   ├── permissions/         # Matriz de permissoes por role
│   ├── troubleshooting/     # Top issues e resolucoes
│   └── glossary/            # Glossario oficial e sinonimos
├── scripts/                 # Scripts de processamento e RAG
├── data/                    # Dados do projeto
│   ├── exports/             # CSV/JSON exports (gitignored)
│   ├── synthetic/           # Dados sinteticos para demo
│   └── screenshots/         # Prints de referencia
├── evidence/                # Evidencias coletadas
│   ├── ui_walkthroughs/     # Videos de navegacao
│   └── prints/              # Capturas de tela
├── config/                  # Configuracoes
├── golden_set/              # Perguntas de avaliacao por modulo
└── playbooks/               # Playbooks operacionais
    ├── crm/
    ├── ats/
    ├── scheduling/
    └── outreach/

Modulos do Gem

Modulo	Descricao
Home	Dashboard, metricas, widgets
To do	Pendencias, SLA, estados
People	Candidates, profiles, tags, custom fields
Outreach	Sequences, templates, metricas
ATS	Jobs, stages, applications, scorecards, offers
Scheduling	Calendario, entrevistas, eventos
Talent Marketing	Campanhas e metricas de marketing
Talent Compass	Analytics avancado
Templates	Templates de mensagens e scorecards

Superficies de Dados

UI

• Fonte de verdade para configuracao de modulos
• Criacao de entidades ATS (jobs, pipeline, entrevistas)
• Criacao e edicao de sequences

API Publica v0

Cobre bem (foco CRM):

• Users, Candidates (CRUD), Projects, Notes, Custom fields
• Sequences (somente leitura)
• Data export (leitura)

Restricoes criticas:

• Rate limit: 20 req/s, burst 500
• Events list: deprecated
• Events create: apenas manual_touchpoints
• Candidate list: limite 20 ids por request
• Project membership: ate 1000 candidate_ids por chamada
• Sequences: read-only

Data Export

• Expoe objetos ATS e CRM mesmo sem endpoints
• Fonte de evidencia e modelagem de dataset

Fases do Projeto

1. Coleta - Pacote versionado de fontes por modulo
2. Normalizacao - Glossario oficial e regras de chunking
3. Modelagem - Data dictionary, mapa de permissoes, playbooks
4. Assistente RAG - Pipeline com guardrails de PII
5. Avaliacao - Golden set e backlog de gaps

Setup

cd GEM-BOOM
pip install -e .
# ou com uv:
uv pip install -e .

Configuracao

Criar arquivo .env com:

GEM_API_KEY=sua_api_key_aqui
OPENAI_API_KEY=sua_openai_key_aqui
ANTHROPIC_API_KEY=sua_anthropic_key_aqui

Backlog Prioritario

Item	Area	Prioridade	Status
1	Roles e permissoes	P0	Not started
2	API key e runbook	P0	In progress
3	Data dictionary	P0	In progress
4	UI e navegacao	P0	Not started
7	Scheduling	P0	Not started
10	PII policy	P0	Not started
5	Outreach sequences	P1	Not started
6	ATS completo	P1	Not started
9	Analytics	P1	Not started
11	Export cookbook	P1	Not started
14	Synthetic data	P1	Not started
15	Troubleshooting top 20	P1	Not started