Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/inteli-college/2024-1b-t08-ec06-g03
Repositório do grupo 2024-1B-T08-EC06-G03
https://github.com/inteli-college/2024-1b-t08-ec06-g03
Last synced: 10 days ago
JSON representation
Repositório do grupo 2024-1B-T08-EC06-G03
- Host: GitHub
- URL: https://github.com/inteli-college/2024-1b-t08-ec06-g03
- Owner: Inteli-College
- Created: 2024-04-16T19:06:59.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-05-22T20:57:51.000Z (8 months ago)
- Last Synced: 2024-05-22T21:59:47.847Z (8 months ago)
- Language: TypeScript
- Homepage: https://inteli-college.github.io/2024-1B-T08-EC06-G03/
- Size: 10.1 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Desencana!
Repositório do grupo Rebólins
## Vídeo - Demonstração
Vídeo de demonstração - Visão da plataforma web
[](https://www.youtube.com/watch?v=tj1b849KVzc)
Vídeo de demonstração - Visão do robô/computador
[](https://www.youtube.com/watch?v=vlz-0ZPnVqQ)
## Descrição do Projeto "Desencana!"
O grupo Rebólins, em parceria com a Atvos, comprometida com a melhoria contínua de suas operações na indústria de processamento de cana-de-açúcar, está implementando uma solução inovadora de monitoramento e manutenção de reboilers através do "Projeto Desencana!". Este projeto visa integrar as tecnologias de robótica e visão computacional clássica para inspecionar e verificar a eficácia da limpeza dos tubos de reboilers, essenciais para a etapa de processamento da cana. Utilizando um sistema de sensores auxiliares, o robô especializado realiza uma avaliação precisa do estado de limpeza dos tubos, coletando dados críticos, que são automaticamente enviados para uma base central. Essa iniciativa não só otimiza a eficiência operacional, reduzindo tempos de inatividade devido a manutenções não planejadas, mas também garante a manutenção da qualidade e segurança no processo de produção. Através do Projeto Desencana!, a Atvos reforça seu compromisso com a inovação e a excelência operacional, estabelecendo novos padrões de manutenção preventiva na indústria.
## Objetivos do Projeto
- Garantir que todos os reboilers estão completamente limpos;
- Disponibilizar de forma sistemática dados relacionados a limpeza dos tubos;
## 👨🎓 Integrantes:
- Eduardo Santos Barreto
- Fernando Antonio Sampaio Cabral de Vasconcelos
- Gabrielle Dias Cartaxo
- Guilherme Ferreira Linhares
- Ivan Gonçalves Ferreira
- Luiza Souza Rubim
- Ólin Medeiros Costa
## 👩🏫 Professores:
### Orientador
- Rodrigo Nicola
### Instrutores
- Guilherme Cestari
- Geraldo Vasconcelos
- Lisane Valdo
- Mônica Anastassiu
- Murilo Zanini de Carvalho
## Estrutura de Pastas
```
└── 📂2024-1B-T08-EC06-G03
└── 📂.github
└── 📂workflows
└── 📜static.yml
└── 📂docs
└── 📂docs
└── index.md
└── 📂Sprint 1
└── 📂Sprint 2
└── 📂Sprint 3
└── 📂Sprint 4
└── 📂Sprint 5
└── 📂src
└── 📂components
└── 📂css
└── 📂static
└── 📂img
└── README.md
├── 📂src
└── 📂Backend
└── 📂api
└── 📂controllers
└── 📂data
└── 📂models
└── 📂routes
└── 📂service
└── 📂config
┗ 📜express.js
└── 📂node_modules
└── 📂scripts
┗ 📜.env
┗ 📜server.js
└── 📂bolin
└── 📂src
└── 📂bolin
└── 📂bolin
┗ 📜battery_mock.py
┗ 📜setup.py
└── 📂bolin_bringup
└── 📂bolin_bringup
└── 📂launch
┗ 📜launch.py
┗ 📜webots_launch.py
┗ 📜setup.py
└── 📂bolin_camera
└── 📂bolin_camera
┗ 📜setup.py
└── 📂bolin_teleop
└── 📂bolin_camera
┗ 📜setup.py
└── 📂bolin_lidar
└── 📂bolin_lidar
┗ 📜setup.py
┗ 📜build.sh
└── 📂frontend
└── 📂src
└── 📂api
└── 📂assets
└── 📂components
└── 📂pages
└── 📂styles
┗ 📜App.js
┗ 📜App.tsx
┗ 📜index.css
┗ 📜main.tsx
┗ 📜vite-env.d.ts
┗ 📜index.html
┗ 📜tsconfig.json
┗ 📜vite.config.js
└── 📂model
└── 📂runs
└── 📂detect
┗ 📜app.py
┗ 📜best_100e.pt
┗ 📜oloy_train.ipynb
┗ 📜requirements.txt
```
## Guia de instrução
## Conexão com o robô
### 1. Conexão com o Robô via SSH
Para iniciar a conexão com o robô, é necessário utilizar o protocolo SSH. Há um tutorial de como deve ser feito o [setup do robô](https://inteli-college.github.io/2024-1B-T08-EC06-G03/Sprint-2/metodologia) Execute os seguintes passos no seu terminal:
1. **Inicie o Robô**: Certifique-se de que o robô esteja ligado e pronto para conexão.
2. **Conectar via SSH**:
- Abra um terminal no seu computador.
- Digite o comando SSH para estabelecer uma conexão segura. Confirme o comando exato e o IP na documentação de metodologia. Um exemplo de comando é:
```bash
ssh [email protected]
```
### 2. Clonar o projeto no robô
```sh
git clone https://github.com/Inteli-College/2024-1B-T08-EC06-G03.git
```
Além disso, é importante ter instalado o [ROS2](https://docs.ros.org/en/humble/Installation.html).
### 3. Inicialização do Robô
Após estabelecer a conexão SSH, o próximo passo é inicializar os componentes necessários do robô. Execute isso no mesmo terminal do
1. **Entrar na pasta de código**:
- É necessário entrar na pasta que os pacotes estão alocados.
```bash
cd src/bolin
```
2. **Executar o Build.sh**:
- É necessário rodar o arquivo de build para construir os pacotes ros.
```bash
source build.sh
```
3. **Executar o Comando de BringUp**:
- No terminal SSH, execute o comando que inicializa os processos necessários no robô. Este comando pode ser encontrado na documentação técnica ou em tutoriais relevantes. Um exemplo comum para robôs baseados em ROS pode ser algo como:
```bash
ros2 launch bolin_bringup launch.py
```
- Este comando inicializa um listener no robô e ativa vários serviços e processos internos.
4. **Iniciar o ROSBridge**
- Execute o comando que inicia o ROSBridge
```bash
ros2 launch rosbridge_server rosbridge_websocket_launch.xml
```
- Este comando inicia o ROSBridge, que é responsável por intermediar a comunicação entre o ROS e a aplicação web.
- Não precisa necessariamente ser executado no robô, também pode ser executado no computador.
### 4. Execução do Software de Controle
Com o robô devidamente inicializado, a próxima etapa é executar o software de controle que interage com o robô.
1. **Clonar o projeto no computador**
- É necessário clonar o projeto no computador que vá rodar a aplicação.
```bash
git clone https://github.com/Inteli-College/2024-1B-T08-EC06-G03.git
```
2. **Inicialização do Back-End**:
- Instale o [Node.js](https://nodejs.org/en/download/)
- No seu computador (não no terminal SSH), abra um novo terminal.
- Acesse a pasta do Back-End
```bash
cd src/backend/
```
- Instale as dependências
```bash
npm install
```
:::warning Alerta
Para continuar, visualize as intruções existentes para a [configuração do database](/Sprint-5/Arquitetura/Banco-BackEnd/banco-de-dados.md), pois é a criação de um banco de dados. Como a solução utiliza Turso, existe um passo a passo para ser seguido sobre a implementação do mesmo. Segue [tutorial](/Sprint-5/Arquitetura/Banco-BackEnd/back-end.md) para mais informações.
:::
- Execute o Back-End
```bash
npm start
```
3. **Inicialização do Front-End**:
- Instale o [Node.js](https://nodejs.org/en/download/)
- No seu computador (não no terminal SSH), abra um novo terminal.
- Acesse a pasta do Front-End
```bash
cd src/frontend/
```
- Instale as dependências
```bash
npm install
```
- Instalação da biblioteca do shadcn.
```bash
npx shadcn-ui@latest init
```
- Execute o Front-End
```bash
npm run dev
```
- Acesse [http://localhost:5173](http://localhost:5173) no seu navegador.
### 5. Controle do Robô
- Utilize o joystick para controlar o robô.
**Nota:** É importante confirmar todos os comandos e caminhos exatos com a documentação técnica disponível para garantir que as instruções estejam corretas e atualizadas.
## Documentação
Para acessar a nossa [documentação](https://inteli-college.github.io/2024-1B-T08-EC06-G03/), clique [aqui](https://inteli-college.github.io/2024-1B-T08-EC06-G03/)!
## 📋 Licença/License
Desencana! - por Eduardo Barreto, Fernando Vasconcelos, Gabrielle Cartaxo, Guilherme Linhares, Ivan Ferreira, Luiza Rubim e Olin Costa is licensed under CC BY 4.0
