Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

Desafio 6DSM - 2026-2(1)

Chatbot para Orientação ao Consumidor via WhatsApp


📝 Descrição

O Desafio 6DSM - 2026-2(1) é um projeto acadêmico desenvolvido no 6º semestre do curso de Desenvolvimento de Software Multiplataforma da FATEC Jacareí, em parceria com o PROCON --- Fundação de Proteção e Defesa do Consumidor de Jacareí-SP.

O projeto tem como tema o desenvolvimento de um Chatbot para Orientação ao Consumidor via WhatsApp.

A proposta é criar um sistema capaz de orientar cidadãos sobre direitos do consumidor, procedimentos de reclamação, prazos, documentos necessários e possíveis encaminhamentos. O chatbot deverá conduzir o usuário por fluxos decisórios definidos pelo PROCON, apresentando perguntas e opções de forma estruturada e intuitiva.

Ao final da interação, o sistema deverá gerar uma resposta orientadora consolidada, indicando os próximos passos recomendados ao consumidor. Quando necessário, essa resposta poderá ser complementada por um modelo de linguagem (LLM) utilizado exclusivamente para geração textual explicativa, sempre respeitando os limites e informações definidos pelo PROCON.

Importante: a solução possui caráter exclusivamente orientativo e não substitui o atendimento jurídico, administrativo ou formal realizado pelo PROCON.

Caso o chatbot não consiga solucionar adequadamente a dúvida do cidadão, o sistema deverá possibilitar o agendamento de atendimento presencial, orientando também sobre possíveis documentos necessários para a consulta.


🎯 Objetivos

O projeto busca:

  • Ampliar o acesso dos cidadãos às informações fornecidas pelo PROCON;
  • Reduzir a demanda causada por dúvidas e perguntas recorrentes;
  • Orientar o consumidor sem exigir, inicialmente, seu deslocamento até a unidade do PROCON;
  • Conduzir o usuário por fluxos decisórios previamente definidos;
  • Fornecer respostas claras, objetivas e acessíveis;
  • Permitir o agendamento presencial quando a orientação automatizada não for suficiente;
  • Disponibilizar uma interface web para gerenciamento dos atendimentos agendados;
  • Registrar as interações para permitir análise posterior dos fluxos mais utilizados;
  • Respeitar os princípios e requisitos da LGPD durante o tratamento das informações dos usuários.

🛠️ Tecnologias

As tecnologias definitivas do projeto ainda serão definidas pela equipe durante o desenvolvimento.

Integração

WhatsApp

A integração deverá ser realizada preferencialmente por meio da WhatsApp Business Platform (Cloud API). Para fins acadêmicos, poderão ser utilizadas alternativas gratuitas, ambientes de teste ou soluções simuladas que reproduzam o fluxo de comunicação.

Backend

O back-end deverá utilizar tecnologias compatíveis com aplicações web modernas, como:

Node.js Python

A tecnologia utilizada pelo grupo será definida posteriormente.

Infraestrutura & Ferramentas

Docker Git GitHub

O sistema deverá obrigatoriamente executar em Docker e adotar práticas modernas de desenvolvimento, incluindo versionamento de código, testes, documentação técnica e integração/entrega contínua (CI/CD).

Modelo de Linguagem

O projeto poderá utilizar um LLM local exclusivamente para complementar a geração textual das orientações.

Não deverão ser utilizadas APIs externas de LLM, mesmo que gratuitas, devido às restrições de custo e à necessidade de proteção das informações conforme a LGPD.


🔄 Scrum

Sprint Início Fim Status 📉 Burndown Chart Sprint Backlog/Review
1 10/08/2026 14/09/2026 🟡 Em andamento Ver Gráfico Ver
2 15/09/2026 19/10/2026 ⚪ Pendente Ver Gráfico Ver
3 20/10/2026 23/11/2026 ⚪ Pendente Ver Gráfico Ver

📋 Product Backlog

Número Recurso Funcional Síntese do Requisito Status
RF01 Integração com WhatsApp Permitir a integração do usuário por meio de um chatbot no WhatsApp.
Pendente
RF02 Tabela de Decisões Apresentar opções de resposta com base nos fluxos fornecidos pelo PROCON.
Pendente
RF03 Fluxos Decisórios Apresentar perguntas e alternativas de maneira sequencial e compreensível.
Pendente
RF04 Resposta Orientadora Gerar ao final do fluxo um resumo do caso e os próximos passos recomendados.
Pendente
RF05 Complemento com LLM Permitir geração textual explicativa por LLM dentro dos limites definidos pelo PROCON.
Pendente
RF06 Registro de Interações Registrar interaçõies para análise posterior dos fluxos mais utilizados.
Pendente
RF07 Agendamento Presencial Realizar agendamento quando o chatbot não solucionar a dúvida do cidadão.
Pendente
RF08 Gerenciamento Web Disponibilizar interface web para gerenciamento dos atendimentos agendados.
Pendente
Número Recurso Não-Funcional Síntese do Requisito Status
RNF01 Usabilidade Utilizar linguagem clara, objetiva e acessível ao público geral.
Pendente
RNF02 Disponibilidade Garantir alta disponibilidade e tempo de resposta adequado para conversas em tempo real.
Pendente
RNF03 LGPD Garantir tratamento adequado e proteção das informações dos usuários.
Pendente
RNF04 Caráter Orientativo Informar explicitamente que as respostas não substituem atendimento formal
Pendente
RNF05 Transparência LLM Identificar claramente respostas geradas com auxílio de modelos de linguagem.
Pendente
RNF06 Docker Garantir a execução da aplicação em Docker
Pendente
RNF07 Documentação Documentar instalação e requisitos necessários de hardware e software.
Pendente
RNF08 Boas Práticas Adotar metodologia ágil, CI/CD, versionamento, testes e documentação técnica mínima.
Pendente

🔒 Restrições do Projeto

  • A integração com o WhatsApp deverá ocorrer preferencialmente pela WhatsApp Business Platform (Cloud API);
  • Poderão ser utilizados ambientes de teste ou soluções simuladas para fins acadêmicos;
  • O back-end deverá utilizar tecnologia compatível com aplicações web modernas, como Node.js ou Python;
  • A arquitetura deverá ser modular, separando:
    • lógica do chatbot;
    • gestão dos fluxos decisórios;
    • integração com modelos de linguagem;
  • O escopo deverá ser compatível com o período disponível para desenvolvimento durante o semestre;
  • APIs externas de LLM não poderão ser utilizadas, mesmo quando gratuitas;
  • O tratamento de dados deverá observar os requisitos da LGPD.

✅ Definition of Done

Uma entrega será considerada concluída quando:

  • Os requisitos e critérios definidos para a funcionalidade forem atendidos;
  • O código estiver versionado no repositório do projeto;
  • A funcionalidade estiver integrada ao restante da aplicação;
  • Os testes aplicáveis tiverem sido executados;
  • A documentação relacionada estiver atualizada;
  • A entrega estiver disponível em ambiente Docker quando aplicável.

📖 User Stories

As User Stories e seus respectivos critérios de aceitação serão definidos e refinados pela equipe durante o planejamento das Sprints, com base nos requisitos e fluxos decisórios fornecidos pelo PROCON.


⚙️ Instalação

As instruções de instalação serão adicionadas conforme a arquitetura e as tecnologias do projeto forem definidas.

A documentação deverá incluir:

  1. Pré-requisitos de hardware e software;
  2. Clonagem do repositório;
  3. Configuração das variáveis de ambiente;
  4. Configuração da integração com o WhatsApp ou ambiente simulado;
  5. Configuração do modelo de linguagem local, caso utilizado;
  6. Inicialização dos containers Docker;
  7. Execução da aplicação.

Exemplo inicial:

git clone <URL_DO_REPOSITORIO>
cd <NOME_DO_REPOSITORIO>
docker compose up --build

👨‍💻 Dev Team

Nome Função GitHub
Maurício Oliveira Medeiros Cepinho Product Owner GitHub
Cláudio dos Santos Siqueira Júnior Dev Team GitHub
Lucas Roque Alvim Cruz Scrum Master GitHub
Nícolas Aquino Dev Team GitHub
Luiz Felipe dos Santos Dev Team GitHub
Vitor Francisco de Azevedo Zonzini Dev Team GitHub
Victor Hugo Dantas Carbajo Dev Team GitHub

🤝 Parceiro

PROCON --- Fundação de Proteção e Defesa do Consumidor de Jacareí-SP

Projeto desenvolvido como parte da metodologia de Aprendizagem Baseada em Projetos (ABP) do 6º semestre de Desenvolvimento de Software Multiplataforma da FATEC Jacareí.


📌 Convenções de Commit

Para manter a organização e padronização do histórico do projeto, a equipe deverá utilizar boas práticas de commits.

Sugestão de referência:

Padrões de Commits


📄 Licença

A definição da licença do projeto será realizada posteriormente pela equipe.

About

Projeto integrador de disciplinas para o sexto semestre.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors