Introdução
Esse site tem como objetivo documentar o desenvolvimento do projeto PharmaBot, um sistema de automação para farmácias hospitalares. Aqui você encontrará informações sobre o projeto, a equipes envolvida, as sprints realizadas e os artefatos gerados ao longo do desenvolvimento.
Descrição do Projeto
O projeto em desenvolvimento visa aprimorar o processo de separação e montagem de medicamentos em farmácias do Hopital de Clínicas da Unicamp. Atualmente, a separação e montagem de medicamentos no Hospital de Clínicas da Unicamp é realizada manualmente, o que gera diversos desafios operacionais e riscos que afetam diretamente a qualidade do atendimento ao paciente. Alguns dos principais problemas enfrentados incluem:
-
Erros na separação de medicamentos: O processo manual está sujeito a falhas humanas, como a seleção errada de medicamentos, doses incorretas ou até mesmo a duplicação de itens. Esses erros podem comprometer a segurança do paciente e levar a complicações no tratamento.
-
Alto consumo de tempo e recursos humanos: A montagem da chamada “Fita de medicamentos” exige um esforço significativo da equipe de farmácia, aumentando a carga de trabalho dos profissionais e limitando a capacidade de atendimento do hospital. Além disso, esse processo demanda um grande número de colaboradores, elevando os custos operacionais.
-
Dificuldade de rastreabilidade e controle de estoque: O controle manual dos medicamentos separados e montados dificulta a rastreabilidade dos itens, tornando mais complexa a identificação de medicamentos vencidos ou em falta. Essa falta de controle pode levar a desperdícios, perdas financeiras e problemas de gestão de estoque.
Para solucionar esses desafios, o projeto PharmaBot propõe a implementação de um sistema de automação para a separação e montagem de medicamentos, utilizando um robô separador e um sistema de controle integrado. O robô separador será responsável por identificar, selecionar e separar os medicamentos de acordo com as prescrições médicas, enquanto o sistema de controle gerenciará o fluxo de trabalho, a comunicação com o sistema de gestão hospitalar e a geração de relatórios de desempenho.
Integrantes
O projeto PharmaBot é desenvolvido por uma equipe multidisciplinar de estudantes do Instituto de Tecnologia e Liderança (Inteli). A equipe é composta por estudantes do curso de Engenharia de Computação, sendo eles:
- Júlia Lika Ishikawa
- Laura Rodrigues
- Isabelle Dantas
- Heitor Candido
- Gustavo Gonçalves da Costa
- Felipe Simão
- Matheus Jorge
- Lucas Santos
Log de Atividades das Sprints
A seguir, são apresentados os links para as apresentações das sprints realizadas pela equipe do projeto PharmaBot. Cada sprint corresponde a um ciclo de desenvolvimento do projeto, com atividades específicas e entregáveis definidos.
Sprint 1
Durante a Sprint 1, a equipe realizou a matriz de risco, o canvas proposta de valor, as 5 forças de Porter, a pesquisa de imersão preliminar, as personas, a jornada do usuário, os requisitos funcionais, os requisitos não funcionais e o diagrama de blocos. Além disso, a documentação foi publicada no GitHub Pages.
A apresentação da Sprint 1 está disponível no link a seguir: Link da apresentação
Status Report
Essa tabela apresenta o status atual do projeto, com base nas atividades realizadas e planejadas para a Sprint 1.
| Atividade | Status | Data de Início | Data de Término |
|---|---|---|---|
| Matriz de Risco | Concluída | 05/02/2025 | 07/02/2025 |
| Canvas Proposta de Valor | Concluída | 05/02/2025 | 07/02/2025 |
| 5 Forças de Porter | Concluída | 10/02/2025 | 13/02/2025 |
| Pesquisa de Imersão Preliminar | Concluída | 05/02/2025 | 07/02/2025 |
| Personas | Concluída | 05/02/2025 | 07/02/2025 |
| Jornada do Usuário | Concluída | 06/02/2025 | 07/02/2025 |
| Requisitos Funcionais | Concluída | 10/02/2025 | 12/02/2025 |
| Requisitos Não Funcionais | Concluída | 10/02/2025 | 12/02/2025 |
| Diagrama de Blocos | Concluída | 10/02/2025 | 12/02/2025 |
| GitHub Pages com a Documentação | Concluída | 07/02/2025 | 11/02/2025 |
Sprint 2
Durante a Sprint 2, a equipe realizou a revisão do diagrama de blocos, elaborou o diagrama da API, o diagrama do banco de dados, as funções do robô e as user stories. Além disso, foram desenvolvidos a CLI do robô, o wireframe, o user flow e a apresentação do projeto. O protótipo de alta fidelidade está em andamento e será concluído até o final da Sprint 3.
A apresentação da Sprint 2 está disponível no link a seguir: Link da apresentação
Status Report
Essa tabela apresenta o status atual do projeto, com base nas atividades realizadas e planejadas para a Sprint 2.
| Atividade | Status | Data de Início | Data de Término |
|---|---|---|---|
| Revisão do Diagrama de Blocos | Concluída | 17/02/2025 | 19/02/2025 |
| Diagrama da API | Concluída | 17/02/2025 | 21/02/2025 |
| Diagrama do Banco de Dados | Concluída | 17/02/2025 | 21/02/2025 |
| Funções do Robô | Concluída | 17/02/2025 | 21/02/2025 |
| User Stories | Concluída | 17/02/2025 | 21/02/2025 |
| CLI do Robô | Concluída | 21/02/2025 | 26/02/2025 |
| WireFrame | Concluída | 21/02/2025 | 25/02/2025 |
| User Flow | Concluída | 21/02/2025 | 25/02/2025 |
| Apresentação | Concluída | 21/02/2025 | 26/02/2025 |
| Protótipo de alta fidelidade | Em andamento | 21/02/2025 | --- |
Sprint 3
Durante a Sprint 3, a equipe realizou a integração dos periféricos (leitor de QRCode e sensor infravermelho ao robô). Além disso, foi realizada a conexão do backend da aplicação com a Raspberry Pi Pico de forma que é agora é possível controlar o robô via requisições na API. No que tange à aplicação, desenvolveu-se o front-end completo do histórico de logs e os primeiros 1000 logs da plataforma e do robô foram enviados para esta página. A página de login está em processo de integração com o backend, assim como o front-end da tela de cadastro.
A apresentação da Sprint 3 está disponível no link a seguir: Link da apresentação
Status Report
Essa tabela apresenta o status atual do projeto, com base nas atividades realizadas e planejadas para a Sprint 3.
| Atividade | Status | Data de Início | Data de Término |
|---|---|---|---|
| Diagrama de Circuito | Concluída | 07/03/2025 | 10/03/2025 |
| Implantação dos Periféricos | Concluída | 10/03/2025 | 10/03/2025 |
| Integração dos Periféricos | Concluída | 10/03/2025 | 14/03/2025 |
| Conexão Robô-API via Websocket | Concluída | 10/03/2025 | 13/03/2025 |
| Front-end do Login | Concluída | 10/03/2025 | 13/03/2025 |
| Front-end do Cadastro | Em Andamento | 13/03/2025 | --- |
| Back-end do Login | Concluída | 07/03/2025 | 11/03/2025 |
| Back-end do Cadastro | Concluída | 07/03/2025 | 12/03/2025 |
| Front-end dos Logs | Concluída | 10/03/2025 | 14/03/2025 |
| Back-end dos Logs | Concluída | 10/03/2025 | 14/03/2025 |
| Deploy da plataforma no servidor do Inteli | Concluída | 11/03/2025 | 14/03/2025 |
| Integração Login | Em andamento | 14/03/2025 | --- |
| Integração Histórico de Logs | Concluída | 12/03/2025 | 14/03/2025 |
Configuração do Ambiente para Execução
Este guia fornece as instruções para configurar o ambiente e executar o projeto corretamente.
1️.Clonar o Repositório Para obter o código-fonte do projeto, clone o repositório do GitHub:
git clone https://github.com/Inteli-College/2025-1A-T12-EC05-G02.git
cd 2025-1A-T12-EC05-G02
2️. Criar e Acessar a Branch de Desenvolvimento
git checkout -b main
3️. Instalar o Docusaurus
cd docs
npm install
4️. Rodar o Docusaurus Localmente
npm run start
A documentação estará disponível em http://localhost:3000/.
Guia de Inicialização do frontend local
1° Passo: Entrar no diretório do projeto
Primeiro, abra um terminal e digite o seguinte comando para entrar na pasta do frontend.
cd src/frontend/pharmabot
2° Passo: Instalar as dependências
Em seguida, instale as dependências do projeto com o seguinte comando:
npm install
3° Passo: Executar a aplicação
Para iniciar o servidor local do frontend, execute o seguinte comando:
npm run dev
Após a execução, o terminal exibirá o link onde a aplicação estará rodando, geralmente http://localhost:3000/. Basta abrir o navegador e acessar o link para visualizar a aplicação em funcionamento.