Skip to content

AUDIT_NEW_FILES_ANALYSIS.md

Latest commit

 

History

History
223 lines (162 loc) · 6.29 KB

AUDIT_NEW_FILES_ANALYSIS.md

File metadata and controls

223 lines (162 loc) · 6.29 KB
Raw

Auditoria Crítica: Novos Arquivos GEM

Data: 2026-02-03 Auditor: Claude (TSA Manager review) Status: PENDENTE VALIDACAO

1. Arquivos Analisados

Arquivo Tipo Tamanho Data
Gem ATS ERD (1).xlsx Schema/ERD 4 sheets ?
Solution Design Plan_ Gem (1).docx Documento 102 paragrafos ?
Gem_API_Docs (1).json OpenAPI Spec 27 endpoints ?
helpcenter_combined.json Help Articles 376 artigos ?

2. Descobertas Criticas

2.1 GEM tem DOIS produtos diferentes!

Produto API Base Foco
GEM CRM /v0/ Sourcing, Outreach, Sequences, Projects
GEM ATS /ats/v0/ Applications, Interviews, Scorecards, Jobs

EVIDENCIA:

  • Gem_API_Docs (1).json = CRM API (27 endpoints em /v0/)
  • Tickets originais referenciam /ats/v0/ = ATS API
  • Solution Design fala de "CRM for recruiting"

IMPACTO: Solution Design pode ser para produto DIFERENTE do que estamos implementando!

2.2 Solution Design vs Tickets Atuais

Solution Design Tickets Atuais Conflito?
Foca em Sequences, Projects, Events Foca em Candidates, Applications, Interviews SIM
Usa /v0/candidates Usa /ats/v0/candidates SIM
Personas: Sourcer, Recruiter Personas: menos definidas Parcial
5 cenarios de demo 6 Stories diferentes Parcial

CONCLUSAO: Solution Design parece ser para GEM CRM, não GEM ATS.

2.3 ERD vs APIs Disponiveis

ERD Table CRM API (/v0/) ATS API (/ats/v0/)
Candidate POST /candidates POST /ats/v0/candidates
Application - POST /ats/v0/applications
Job - GET /ats/v0/jobs
JobStage - GET /ats/v0/job_stages
ScheduledInterview - POST /ats/v0/scheduled_interviews
Scorecard - POST /ats/v0/scorecards
User GET /users GET /ats/v0/users
Department - GET /ats/v0/departments
Offer - ?
Project POST /projects -
Sequence GET /sequences -
Note POST /notes POST /ats/v0/.../notes

CONCLUSAO: ERD alinha com ATS API, não CRM API.

3. O que a Nova Informacao DERRUBA

3.1 DERRUBADO: API Details no apply_api_refinements.py

Problema: Script referencia endpoints que podem estar incompletos.

Evidencia do CRM API (Gem_API_Docs.json):

POST /v0/candidates - Cria candidato com campos ricos
POST /v0/candidates/{id}/events - Loga eventos
POST /v0/candidates/{id}/uploaded_resumes/{user_id} - Upload resume
POST /v0/notes - Cria notas
POST /v0/projects - Cria projetos

Isso NAO estava nos tickets. Mas... isso é CRM, não ATS.

VEREDICTO: NAO DERRRUBA. ATS API (que usamos) é separada.

3.2 DERRUBADO: Stories mapeiam para cenarios diferentes

Solution Design tem:

  1. From Prospect to Pipeline (Sourcing)
  2. Outreach Lifecycle (Sequences)
  3. Collaborative Hiring (Projects)
  4. Pipeline Management (Status changes)
  5. Executive Dashboard (Analytics)

Tickets atuais tem:

  1. AI Application Review
  2. Interview Scheduling
  3. Team Collaboration
  4. Executive Visibility
  5. Source ROI
  6. Talent Rediscovery

Mapeamento problematico:

  • Story 1 (AI Application Review) != Scenario 1 (Sourcing)
  • Story 2 (Interview Scheduling) != Scenario 2 (Outreach/Sequences)

VEREDICTO: Solution Design NAO deve ser aplicado aos tickets.

3.3 MANTIDO: ERD Schema

ERD alinha com ATS API porque:

  • Tabelas: Candidate, Application, Job, Scorecard, ScheduledInterview
  • Estes sao objetos do ATS, nao do CRM
  • Relationships fazem sentido para fluxo de hiring

VEREDICTO: ERD aplicado aos tickets ESTA CORRETO.

4. O que FALTA nos Tickets

4.1 CRM API Awareness

Os tickets NAO mencionam que existe uma CRM API separada. Isso pode causar confusao.

Recomendacao: Adicionar nota nos tickets relevantes:

"GEM tem duas APIs: CRM (/v0/) para sourcing e ATS (/ats/v0/) para applications. Este ticket usa ATS API."

4.2 Help Center como Referencia

376 artigos de documentacao do usuario que podem ajudar:

  • "Application Review" - como funciona no UI
  • "Setting up integrations" - para entender fluxos
  • "Academy Courses" - para entender features

Recomendacao: Criar index dos artigos relevantes por ticket.

4.3 Falta de Datas nos Documentos

Nenhum documento tem data clara:

  • Solution Design: pode ser v1, v2, ou deprecated
  • ERD: pode ser atual ou antigo
  • API Docs: versao nao clara

Recomendacao: Validar com fonte (GEM Engineering ou PM).

5. Acoes Recomendadas

# Acao Prioridade Responsavel
1 NAO aplicar Solution Design aos tickets CRITICA -
2 MANTER ERD aplicado (alinha com ATS) OK JA FEITO
3 Validar se ERD esta atualizado ALTA TSA
4 Criar glossario CRM vs ATS MEDIA TSA
5 Indexar Help Center por feature BAIXA DATA
6 Confirmar qual API usar por ticket ALTA CE + TSA

6. Resumo Executivo

O que aprendemos:

  1. GEM = 2 produtos (CRM + ATS) com APIs separadas
  2. Solution Design = CRM (nao aplicavel aos nossos tickets ATS)
  3. ERD = ATS (aplicavel e ja aplicado)
  4. Help Center = 376 artigos de referencia

O que invalidamos:

  1. Solution Design aplicado aos tickets (REVERTIDO)
  2. Mapeamento Stories -> Scenarios (NAO APLICAVEL)

O que mantivemos:

  1. ERD Schema nos 10 tickets (CORRETO)
  2. API Implementation Details anteriores (CORRETO - usa ATS API)

Proximos passos:

  1. Validar ERD com GEM Engineering
  2. Confirmar se ATS API e a correta para cada ticket
  3. Documentar diferenca CRM vs ATS para o time

Anexo: Endpoints por API

CRM API (/v0/) - 27 endpoints

Candidates: GET, POST, PUT, DELETE + events, notes, resumes
Notes: POST, GET, DELETE
Projects: GET, POST, PATCH + candidates
Custom Fields: GET, POST, PATCH + options
Sequences: GET
Users: GET
Data Export: GET

ATS API (/ats/v0/) - Estimado ~20+ endpoints

Candidates: GET, POST
Applications: GET, POST, move
Jobs: GET
Job Stages: GET
Scheduled Interviews: GET, POST, PATCH, DELETE
Scorecards: GET, POST
Users: GET, PATCH
Offices: GET
Departments: GET
Activity Feed: notes, emails

Auditoria concluida em 2026-02-03 por Claude