Projeto de API - 6º Semestre (2026-2) da Fatec São José dos Campos - Bug Busters
O objetivo deste projeto é solucionar um gargalo crítico enfrentado pela Dom Rock: a vulnerabilidade, ineficiência e falta de conformidade na apuração manual de comissões de vendas.
Atualmente, a gestão de incentivos depende de planilhas desarticuladas, gerando impactos operacionais e financeiros imediatos:
- Inconsistências Temporais e Passivo Trabalhista: Lançamentos de vendas atribuídos a colaboradores fora do período de vigência de seu contrato (ex: vendas registradas antes da data de admissão do colaborador) geram comissionamentos indevidos e passivos contábeis.
- Falta de Rastreabilidade e Auditoria: Ausência de registros imutáveis que comprovem a origem exata da taxa aplicada (se proveniente de uma regra de campanha específica ou da taxa-base por cargo/marca).
- Insegurança Orçamentária em Campanhas: Gestores comerciais lançam propostas de comissionamento sem capacidade de prever o impacto financeiro real frente ao histórico de vendas, resultando em estouros frequentes do teto orçamentário.
A plataforma ComissionAI resolve esse cenário unificando a ingestão de dados de RH, Vendas e Comissões sob um motor de cálculo determinístico e imutável, dotado de barreira de validação temporal de vínculos, proteção contra duplicações e interpretação assistida por IA com simulação orçamentária prévia (sandbox).
| Cliente | Periodo/Curso | Professor M2 | Professor P2 | Contato Cliente |
|---|---|---|---|---|
| Dom Rock | 6º ADS (Análise e Desenvolvimento de Sistemas) | Claudio Lima claudio.lima@cps.sp.gov.br |
Walmir Duque jose.duque@cps.sp.gov.br |
Andre F. de Almeida andre.almeida@domrock.com.br |
| Sprint | Previsão | Status |
|---|---|---|
| Kick Off | 26/08 | Concluido |
| 01 | 27/09 | Concluida |
| 02 | 25/10 | Em andamento |
| 03 | 22/11 | A fazer |
| Feira de Soluções | 03/12 | A fazer |
| Rank | Prioridade | User Story | Estimativa | Sprint |
|---|---|---|---|---|
| 1 | Alta | Como Analista de Operações, quero cadastrar, editar e remover regras manuais para manter as taxas vigentes atualizadas. | 3 | 1 |
| 2 | Alta | Como Analista de Operações, quero executar o processamento de vendas contra regras ativas para apurar valores devidos de forma determinística e ágil. | 5 | 1 |
| 3 | Média | Como Auditor de Compliance, quero que o sistema bloqueie regras sem data final para evitar comissionamento por tempo indeterminado e custos descontrolados. | 2 | 1 |
| 4 | Alta | Como Auditor de Compliance, quero que cada cálculo executado gere um log imutável discriminando taxa-base ou regra de campanha para auditoria irrefutável. | 3 | 1 |
| 5 | Alta | Como Head Comercial, quero formular propostas em linguagem natural para que o sistema interprete e estruture parâmetros executáveis automaticamente. | 8 | 1 |
| 6 | Alta | Como Administrador de Dados, quero importar e validar as bases de RH, vendas e taxas para garantir que apenas dados íntegros entrem no cálculo por competência. | 8 | 1 |
| 7 | Alta | Como Head Comercial, quero simular o impacto financeiro de uma proposta contra o histórico de vendas para verificar aderência ao orçamento sem gerar comissão real. | 8 | 2 |
| 8 | Alta | Como Diretor Financeiro, quero revisar e aprovar explicitamente os parâmetros da simulação para homologar a ativação da regra em produção. | 5 | 2 |
| 9 | Alta | Como Auditor de Compliance, quero visualizar o snippet explicativo de código gerado pelo agente para auditar a interpretação lógica da regra antes de sua persistência (Explainable AI). | 5 | 2 |
| 10 | Média | Como Auditor de Compliance, quero ser alertado quando houver anomalias nas vendas diárias de um colaborador (outliers estatísticos) para verificação preventiva. | 8 | 3 |
| 11 | Baixa | Como Head Comercial, quero receber sugestões de ajuste de parâmetros caso a simulação estoure o teto orçamentário previsto. | 5 | 3 |
| 12 | Média | Como Gerente de Vendas, quero emitir o relatório consolidado de fechamento detalhando resultados por canal e equipe. | 5 | 3 |
| 13 | Média | Como Administrador de TI, quero consultar os históricos de envios e validações para auditar o ciclo de carga e integridade das bases. | 3 | 3 |
Estimativas em story points
- Analista de Operações: Responsável pela manutenção operacional do catálogo de regras, atualização manual de taxas, vigências e exceções de mercado.
- Administrador de Dados: Responsável pelo controle de integridade, ingestão e validação das cargas mensais de arquivos (RH, Vendas e Comissões) no sistema.
- Head Comercial: Perfil estratégico focado na formulação de campanhas de incentivo em linguagem natural, validação de viabilidade comercial e simulação orçamentária prévia (modo sandbox).
- Diretor Financeiro: Autoridade orçamentária com poder de homologação explícita (aprovação humana) para converter propostas e simulações em regras ativas no ambiente produtivo.
- Auditor de Compliance: Responsável pela governança, conformidade legal e fiscal, exigindo logs imutáveis, detecção de anomalias operacionais e rastreabilidade total do raciocínio da IA.
- Gerente de Vendas: Liderança operacional que consome relatórios consolidados de fechamento por equipe e canal para acompanhamento de metas.
- Administrador de TI: Responsável pela sustentação técnica, monitoramento de concorrência e auditoria de logs de acesso e de modificação no banco de dados.
- Explainable AI (XAI): Conjunto de práticas e técnicas que tornam as decisões e o raciocínio de modelos de inteligência artificial transparentes e auditáveis por humanos.
- Snippet: Trecho curto e autoexplicativo de código (em Python) gerado pelo agente para detalhar a lógica condicional inferida antes de sua persistência definitiva no banco relacional.
- Competência: Mês e ano de referência (formato MM/AAAA) no qual as vendas ocorreram e sobre o qual os vínculos contratuais e taxas ativas são processados.
- Impedimento: Inconsistência cadastral ou temporal (ex: venda registrada antes da data de admissão do colaborador) que segrega o cálculo individual para auditoria manual sem travar o restante do lote processado.
- Log Imutável: Registro de auditoria em banco de dados gravado exclusivamente em modo append-only (sem permissão de edição ou deleção), assegurando prova histórica e rastreabilidade de execuções.
- Story Points (Estimativa): Métrica ágil que quantifica o esforço relativo, complexidade técnica e riscos envolvidos na entrega de cada User Story.
Para que uma User Story seja considerada pronta para execução na Sprint, ela deve atender aos seguintes critérios:
- Contrato de Interface Definido: Payloads de entrada e saída (DTOs / Schemas de interpretação) acordados entre Front, Back e serviço de IA.
- Regras de Negócio e Casos de Borda Detalhados: Especificação explícita de critérios de bloqueio (ex: divergência temporal de admissão, ausência de taxa base, duplicidade de lote).
- Critérios de Aceitação Formalizados: Cenários de validação documentados no formato BDD/Gherkin.
- Estrutura de Dados Mapeada: Tabelas e constraints de banco de dados provisionadas via migrations do Flyway.
Preview-Sprint1.mp4
Acesse o manual de instalação seguindo os passos pelo arquivo CONTRIBUTING.md
| Função | Nome | GitHub | |
|---|---|---|---|
| Product Owner | Davi Miyake |  |
 |
| Scrum Master | Renan Tomasi | |
|
| Team Member | Humberto Ishii | |
|
| Team Member | Diego Castilho | |
|
| Team Member | Vinicius Elias | |
|
| Team Member | Ygor Pereira | |
|
