API ADS 3º Semestre

---

Desafio | MVP | Protótipo | Demonstração | Sprints | Metodologia | Backlog do Produto | Equipe | Cliente | Docentes

Status do Projeto: Concluído! ✔️

🏁 Desafio: Plataforma Web de Acompanhamento dos Resultados de Importação e Exportação dos Estados

O objetivo deste projeto é desenvolver uma plataforma web que disponibilize informações sobre o desempenho dos Estados Brasileiros no comércio exterior, com base nos dados abertos do Ministério do Desenvolvimento, Indústria, Comércio e Serviços. Essa ferramenta fornecerá aos tomadores de decisão dados claros e acessíveis, permitindo a identificação de municípios que estejam em ascensão, estagnação ou declínio no mercado internacional.

🫧 MVP (Minimal Viable Product)

💜 AdaTrade é uma plataforma que permitirá que economistas, gestores públicos e empresas acompanhem e analisem o desempenho dos estados brasileiros no comércio exterior de maneira eficiente e acessível.
Descrição do Projeto: A plataforma web visa organizar e estruturar os dados de comércio exterior brasileiro, permitindo o acompanhamento detalhado do desempenho dos estados no mercado internacional.
O sistema se baseia nos dados abertos do Ministério do Desenvolvimento, Indústria, Comércio e Serviços, oferecendo uma interface interativa para análise e tomada de decisão.

🛠️ Funcionalidades Principais

O usuário poderá:
✅ Visualizar estatísticas da balança comercial (importação e exportação) de cada estado.
✅ Filtrar informações por período (2014-2024), estado e setor econômico.
✅ Identificar tendências de crescimento, estagnação ou declínio nos municípios.
✅ Gerar gráficos e relatórios interativos sobre o desempenho econômico.
✅ Exportar dados e insights para análises externas.

🛠️ Requisitos Técnicos

📌 Desenvolvimento baseado em Orientação a Objetos (OO)
📌 Modelagem de processos usando VPC e BPMN
📌 Backlog de Produto e Backlog de Sprint detalhados
📌 Implementação em TypeScript utilizando IDEs especializadas
📌 Revisão e otimização de código focada em estrutura de dados

📚 Documentação e Manual do Usuário

A documentação técnica e o manual do usuário estão disponíveis na pasta Documentação deste repositório:

• 📄 Documentação do Projeto (PDF)
• 👤 Manual do Usuário (PDF)

Esses arquivos fornecem uma visão detalhada sobre o funcionamento do sistema, arquitetura, endpoints da API, bem como instruções de uso para usuários finais.

✨ Protótipo do Programa

🎥 Demonstração

📂 Sprint 1:

Demo.-.Sprint.1.mp4

📂 Sprint 2:

Sprint.2.mp4

📂 Sprint 3:

API-SEMESTRE3.mp4

---

📖 Metodologia

Este é um projeto pedagógico alicerçado na Metodologia API, baseado na metodologia ágil SCRUM, para ensino-aprendizado focado no desenvolvimento de competências e fundamentada nos pilares de aprendizado com problemas reais (RPBL), validação externa e mentalidade ágil.
Uso de estratégias para entender o problema, conceber uma solução viável ao desenvolver e implementar o MVP seguido de sua operação (CDIO).
Os resultados dos projetos devem obedecer ao Aviso Legal disponível no site da Fatec SJC com definição das datas do kickoff e das sprints.
Ler mais

📅 Sprints

✅ SPRINT 1: Concluída!

✅ SPRINT 2: Concluída!

✅ SPRINT 3: Concluída!

🐙 Backlog do Produto

Rank	Prioridade	User Story	Sprint	Status
1	Alta	Como cliente, desejo que os dados sejam normalizados e limpos utilizando o Google Colab, para garantir a qualidade das informações antes da análise.	1	✅
2	Alta	Como cliente, quero um relatório documentando os problemas encontrados e as correções feitas na base de dados, para que eu tenha visibilidade sobre a qualidade dos dados, e possa avaliar possíveis impactos na análise final.	1	✅
3	Alta	Como cliente, quero armazenar os dados tratados em um banco de dados relacional, para facilitar consultas futuras.	1	✅
4	Alta	Como cliente, quero testar a comunicação entre o Front-end e o Back-end com uma funcionalidade mínima implementada para garantir a integração entre as partes.	1	✅
5	Alta	Como usuário do sistema, quero visualizar os dados de exportação/importação segmentados por Estados, para facilitar minha análise.	2	✅
6	Alta	Como cliente, quero que a API seja estruturada para permitir consultas detalhadas ao banco de dados para obter informações mais precisas.	2	✅
7	Alta	Como usuário do sistema, quero pesquisar cargas por código NCM, para encontrar informações específicas rapidamente.	2	✅
8	Alta	Como usuário do sistema, eu quero um painel que classifique as exportações por meio de transporte (rodoviário, marítimo, etc.) para entender padrões logísticos.	2	✅
9	Alta	Como usuário do sistema, quero filtrar os dados por período(2014 a 2024), para realizar análises históricas.	3	✅
10	Alta	Como cliente, quero exportar os dados do dashboard para outras ferramentas, como PowerBI, para que eu possa aprofundar minhas análises e obter insights mais detalhados.	3	✅
11	Média	Como usuário do sistema, quero visualizar um mapa interativo, exibindo fluxos de exportação, para que eu possa entender melhor os mercados envolvidos e analisar tendências comerciais.	3	✅
12	Baixa	Como usuário do sistema, quero que a aplicação seja hospedada na nuvem, para que eu possa acessá-la remotamente com maior disponibilidade e confiabilidade.	3	✅

🫧 AdaTeam

Membro	Função	Github	Linkedin
Renan Tomasi	Scrum Master
Matheus Germano	Product Owner
Angelina Borroni	Dev Team
Maria Fernanda Hansen	Dev Team
Ramon Amorim da Silva	Dev Team
Raphaela Monteiro	Dev Team
Vitor Ribeiro	Dev Team

🚀 Cliente:

Cliente
Prof° Marcus Nascimento	Curso de Logística da Faculdade de Tecnologia de São José dos Campos

🗝️ Docentes:

P²	M²
Prof° Fernando Masanori Ashikaga	Prof° Cláudio Lima