From 959a3d9a23cf10b62b15ad27a0dea099cab39358 Mon Sep 17 00:00:00 2001 From: GabrielHMA01 Date: Wed, 5 Mar 2025 12:34:54 -0300 Subject: [PATCH 1/4] =?UTF-8?q?docs:=20adiciona=20texto=20explicando=20com?= =?UTF-8?q?o=20inicializar=20a=20aplica=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- "docs/docs/Inicializa\303\247\303\243o.md" | 213 +++++++++++++++++++++ docs/docusaurus.config.js | 12 +- src/{ => dobot}/requirements.txt | Bin 3 files changed, 219 insertions(+), 6 deletions(-) create mode 100644 "docs/docs/Inicializa\303\247\303\243o.md" rename src/{ => dobot}/requirements.txt (100%) diff --git "a/docs/docs/Inicializa\303\247\303\243o.md" "b/docs/docs/Inicializa\303\247\303\243o.md" new file mode 100644 index 0000000..8d472d9 --- /dev/null +++ "b/docs/docs/Inicializa\303\247\303\243o.md" @@ -0,0 +1,213 @@ +--- +sidebar_label: "Inicialização" +--- + +# Inicializando a Aplicação Localmente + +Para que você consiga executar a aplicação em seu ambiente local, é importante compreender os três pilares que a compõem: a interface de linha de comando (CLI), o front-end e o back-end. Cada um desses elementos foi cuidadosamente selecionado e implementado utilizando tecnologias modernas, que juntas formam uma arquitetura eficiente e completa. + +
+ +## Interface de Linha de Comando (CLI) 💻 + +A **CLI** é uma ferramenta versátil e eficiente que permite a interação com a aplicação por meio do terminal. Desenvolvida em **Python**, a CLI foi projetada para simplificar tarefas rotineiras, como iniciar o servidor, gerenciar scripts, executar comandos de manutenção e até mesmo automatizar processos complexos. A escolha do Python para esta interface não é aleatória: graças à sua sintaxe clara, ampla documentação e vasta biblioteca de módulos, Python facilita a criação de scripts ágeis e de fácil manutenção. Com essa ferramenta, os usuários podem configurar e monitorar a aplicação de forma rápida e sem a necessidade de uma interface gráfica elaborada. + + +## Front-end 🎨 + +O **front-end** da aplicação é responsável por toda a experiência visual e interação do usuário. Utilizamos o **React**, uma biblioteca JavaScript criada pelo Facebook que revolucionou o desenvolvimento de interfaces de usuário. O React adota uma abordagem baseada em componentes, permitindo que cada parte da interface seja modular e reutilizável. Isso torna o desenvolvimento mais organizado e a aplicação mais escalável, pois cada componente pode ser desenvolvido, testado e atualizado independentemente. Além disso, o React utiliza o Virtual DOM, que melhora significativamente a performance da aplicação, garantindo uma experiência fluida e responsiva, mesmo em interfaces complexas. Essa escolha reflete o compromisso com uma interface moderna e eficiente, que atende às expectativas dos usuários atuais. + + +## Back-end 🔧 + +No **back-end**, encontramos o núcleo que gerencia a lógica de negócio, o armazenamento e o processamento de dados da aplicação. Essa camada foi implementada utilizando o **Flask**, um micro-framework de Python conhecido por sua simplicidade e flexibilidade. O Flask permite a criação de APIs seguras, que servem como ponte entre o front-end e os sistemas de gerenciamento de dados. Sua estrutura minimalista possibilita uma rápida configuração e a adição de funcionalidades conforme necessário, sem impor uma arquitetura rígida. Dessa forma, o Flask facilita a integração com bancos de dados, serviços de autenticação e outras ferramentas essenciais para o funcionamento da aplicação, garantindo que a comunicação entre os diversos componentes seja eficiente e confiável. + +
+ +--- + +
+ +## Como inicializar a CLI 💻 + +Para executar a interface de linha de comando (CLI) de nossa aplicação, siga as instruções detalhadas abaixo. Este procedimento garantirá que seu ambiente esteja configurado corretamente, permitindo que você utilize todas as funcionalidades oferecidas pela CLI. + + + +### **Pré-requisitos 🔧** + +- **Python:** Certifique-se de que o Python (versão 3.7 ou superior é recomendado) esteja instalado em sua máquina. Caso não esteja, acesse [python.org](https://www.python.org/downloads/). +- **Terminal:** Utilize um terminal (Prompt de Comando ou PowerShell no Windows, Terminal no Linux/macOS) para executar os comandos a seguir. + + + +### **Passo 1: Navegue até o Diretório da CLI 📂** + +Abra o terminal e acesse a pasta `dobot` do repositório, onde se encontram o arquivo `cli.py` e o arquivo `requirements.txt`. + +Utilize o seguinte comando para navegar até esse diretório: +```bash + cd 2025-1A-T12-EC05-G05/src/dobot +``` + + +### **Passo 2: Crie e Ative o Ambiente Virtual 🛠️** + +Crie um ambiente virtual para isolar as dependências do projeto com o comando: +```bash + python3 -m venv nome_da_venv +``` + +> **Observação:** Substitua `nome_da_venv` pelo nome que desejar para o seu ambiente virtual. + +Em seguida, ative o ambiente virtual: + +- **Para Linux/macOS:** +```bash + source nome_da_venv/bin/activate +``` +- **Para Windows:** +```bash + nome_da_venv\Scripts\Activate +``` + + +### **Passo 3: Instale as Dependências do Projeto 📦** + +Com o ambiente virtual ativado, instale todas as bibliotecas necessárias executando: +```bash + pip install -r requirements.txt +``` +Este comando fará o download e a instalação de todas as dependências listadas no arquivo `requirements.txt`. + + + +### **Passo 4: Execute a CLI e Confira as Funcionalidades 🔄** + +Após configurar o ambiente, execute o comando abaixo para visualizar as opções disponíveis na CLI: +```bash + python3 cli.py --help +``` +Este comando exibirá uma mensagem de ajuda com todas as funções e comandos disponíveis, permitindo que você comece a operar o robô via linha de comando. + +Caso encontre algum problema, verifique se todas as dependências foram instaladas corretamente e se o ambiente virtual foi ativado com sucesso. + +--- + +## Como inicializar o Front-end 🚀 + +Para executar o front-end de nossa aplicação localmente, siga as instruções detalhadas a seguir. Este procedimento permitirá que você configure e inicie o ambiente de desenvolvimento de forma adequada, garantindo que todas as dependências sejam corretamente instaladas e que a aplicação seja executada sem contratempos. + +### **Pré-requisitos 🔧** + +- **Node.js e npm:** Certifique-se de que o Node.js (versão 14 ou superior é recomendado) e o npm estão instalados em sua máquina, caso contrário instale [nesse link](https://nodejs.org/en). +- **Editor de Código:** Recomenda-se utilizar um editor de código, como o [Visual Studio Code](https://code.visualstudio.com/download), que facilita a edição, depuração e manutenção do código. + +### **Passo 1: Navegue até o Diretório do Front-end 📂** + +Abra o terminal e acesse o diretório que contém o arquivo `package.json` do front-end. + +Utilize o seguinte comando para navegar até esse diretório: +```bash + cd 2025-1A-T12-EC05-G05/src/frontend/src +``` + +### **Passo 2: Instale as Dependências do Projeto 📦** + +Com o terminal posicionado no diretório correto, execute: +```bash + npm install +``` +Este comando fará o download e a instalação de todas as dependências listadas no arquivo `package.json`, as quais são indispensáveis para o funcionamento correto da aplicação. + +### **Passo 3: Inicie o Servidor de Desenvolvimento 🔄** + +Após a instalação das dependências, inicie o servidor de desenvolvimento com o comando: +```bash + npm run start +``` +Este comando compilará o projeto e iniciará um servidor de desenvolvimento. Normalmente, a aplicação ficará disponível na URL `http://localhost:3000` (ou em outra porta configurada no projeto). + +### **Passo 4: Acesse a Aplicação no Navegador 🌐** + +Abra o seu navegador de preferência e acesse: + + http://localhost:3000 + +Ao acessar essa URL, você visualizará a aplicação front-end em execução. O servidor de desenvolvimento conta com recarregamento automático (hot reload), permitindo que qualquer alteração no código seja imediatamente refletida na interface. + +Caso haja qualquer problema durante o processo, verifique se todas as dependências foram instaladas corretamente e se o caminho do diretório está correto. + +--- + +## Como inicializar o Back-end 🔧 + +Para executar o back-end de nossa aplicação localmente, siga as instruções detalhadas a seguir. Este procedimento garantirá que o ambiente esteja devidamente configurado, que todas as dependências sejam instaladas e que as variáveis de ambiente essenciais estejam definidas, assegurando o funcionamento correto do sistema. + + +### **Pré-requisitos 📋** + +- **Python:** Certifique-se de que o Python (versão 3.7 ou superior é recomendado) esteja instalado em sua máquina. +- **Redis:** Baixe e instale o Redis. Para instruções de instalação, consulte [redis.io/download](https://redis.io/download). Certifique-se de que o Redis esteja em execução na URL padrão `redis://127.0.0.1:6379`. +- **Virtual Environment:** É recomendável utilizar um ambiente virtual para isolar as dependências do projeto. + + +### **Passo 1: Navegue até o Diretório do Back-end 📂** + +Abra o terminal (ou prompt de comando) e acesse o diretório que contém o back-end da aplicação. + +Utilize o seguinte comando para navegar até esse diretório: +```bash + cd C:\Users\gabri\Documents\GitHub\2025-1A-T12-EC05-G05\src\backend +``` + +### **Passo 2: Crie e Ative o Ambiente Virtual 🛠️** + +Crie um ambiente virtual no diretório atual executando: +```bash + python -m venv venv +``` +Em seguida, ative o ambiente virtual: + +- **No Windows:** +```bash + venv\Scripts\activate +``` +- **No Linux/MacOS:** +```bash + source venv/bin/activate +``` + +### **Passo 3: Instale as Dependências do Projeto 📦** + +Com o ambiente virtual ativado, instale as dependências listadas no arquivo `requirements.txt` (que se encontra no mesmo nível da pasta `app`) com o seguinte comando: +```bash + pip install -r requirements.txt +``` + +### **Passo 4: Configure as Variáveis de Ambiente 🔑** + +É necessário definir uma variável de ambiente `SECRET_KEY` para proteger a aplicação. Crie um arquivo chamado **.env** no diretório do back-end (ao lado do arquivo `requirements.txt`) com o seguinte conteúdo: + + SECRET_KEY=your_random_secret_key_here + +> Para gerar uma string aleatória, você pode usar o comando abaixo no terminal: +>```bash +> python -c "import secrets; print(secrets.token_hex(16))" +>``` +> Copie o resultado e substitua `your_random_secret_key_here` no arquivo **.env**. + +O arquivo **.env** será carregado pela aplicação (através do `load_dotenv`) para configurar a variável `SECRET_KEY` e outras configurações necessárias. + + +### **Passo 5: Execute a Aplicação Back-end 🚀** + +Após concluir a configuração, navegue até a pasta **app** e inicie a aplicação. +```bash + python run app.py +``` + +A aplicação deverá ser iniciada e estará disponível na URL padrão, geralmente `http://127.0.0.1:5000`. + + +Caso haja qualquer problema, verifique se o Redis está em execução, se o ambiente virtual foi ativado e se as dependências foram instaladas corretamente. diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js index 2737f89..e3baef3 100644 --- a/docs/docusaurus.config.js +++ b/docs/docusaurus.config.js @@ -83,11 +83,12 @@ const config = { position: 'left', label: 'Documentação', }, - // { - // to: '/autores', - // position: 'left', - // label: 'Sobre os Autores' - // }, + { + type: 'doc', + docId: 'Inicialização', + position: 'left', + label: 'Como Executar a Aplicação' + }, { href: 'https://github.com/Inteli-College/2025-1A-T12-EC05-G05', label: 'GitHub', @@ -131,5 +132,4 @@ const config = { }), }; - export default config; diff --git a/src/requirements.txt b/src/dobot/requirements.txt similarity index 100% rename from src/requirements.txt rename to src/dobot/requirements.txt From 534f1d4db463470021929d69b3e59a2dbb874743 Mon Sep 17 00:00:00 2001 From: GabrielHMA01 Date: Wed, 5 Mar 2025 13:02:06 -0300 Subject: [PATCH 2/4] docs: removes bold from titles --- "docs/docs/Inicializa\303\247\303\243o.md" | 32 +++++++++++----------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git "a/docs/docs/Inicializa\303\247\303\243o.md" "b/docs/docs/Inicializa\303\247\303\243o.md" index 8d472d9..1a22af5 100644 --- "a/docs/docs/Inicializa\303\247\303\243o.md" +++ "b/docs/docs/Inicializa\303\247\303\243o.md" @@ -34,14 +34,14 @@ Para executar a interface de linha de comando (CLI) de nossa aplicação, siga a -### **Pré-requisitos 🔧** +### Pré-requisitos 🔧 - **Python:** Certifique-se de que o Python (versão 3.7 ou superior é recomendado) esteja instalado em sua máquina. Caso não esteja, acesse [python.org](https://www.python.org/downloads/). - **Terminal:** Utilize um terminal (Prompt de Comando ou PowerShell no Windows, Terminal no Linux/macOS) para executar os comandos a seguir. -### **Passo 1: Navegue até o Diretório da CLI 📂** +### Passo 1: Navegue até o Diretório da CLI 📂 Abra o terminal e acesse a pasta `dobot` do repositório, onde se encontram o arquivo `cli.py` e o arquivo `requirements.txt`. @@ -51,7 +51,7 @@ Utilize o seguinte comando para navegar até esse diretório: ``` -### **Passo 2: Crie e Ative o Ambiente Virtual 🛠️** +### Passo 2: Crie e Ative o Ambiente Virtual 🛠️ Crie um ambiente virtual para isolar as dependências do projeto com o comando: ```bash @@ -72,7 +72,7 @@ Em seguida, ative o ambiente virtual: ``` -### **Passo 3: Instale as Dependências do Projeto 📦** +### Passo 3: Instale as Dependências do Projeto 📦 Com o ambiente virtual ativado, instale todas as bibliotecas necessárias executando: ```bash @@ -82,7 +82,7 @@ Este comando fará o download e a instalação de todas as dependências listada -### **Passo 4: Execute a CLI e Confira as Funcionalidades 🔄** +### Passo 4: Execute a CLI e Confira as Funcionalidades 🔄 Após configurar o ambiente, execute o comando abaixo para visualizar as opções disponíveis na CLI: ```bash @@ -98,12 +98,12 @@ Caso encontre algum problema, verifique se todas as dependências foram instalad Para executar o front-end de nossa aplicação localmente, siga as instruções detalhadas a seguir. Este procedimento permitirá que você configure e inicie o ambiente de desenvolvimento de forma adequada, garantindo que todas as dependências sejam corretamente instaladas e que a aplicação seja executada sem contratempos. -### **Pré-requisitos 🔧** +### Pré-requisitos 🔧 - **Node.js e npm:** Certifique-se de que o Node.js (versão 14 ou superior é recomendado) e o npm estão instalados em sua máquina, caso contrário instale [nesse link](https://nodejs.org/en). - **Editor de Código:** Recomenda-se utilizar um editor de código, como o [Visual Studio Code](https://code.visualstudio.com/download), que facilita a edição, depuração e manutenção do código. -### **Passo 1: Navegue até o Diretório do Front-end 📂** +### Passo 1: Navegue até o Diretório do Front-end 📂 Abra o terminal e acesse o diretório que contém o arquivo `package.json` do front-end. @@ -112,7 +112,7 @@ Utilize o seguinte comando para navegar até esse diretório: cd 2025-1A-T12-EC05-G05/src/frontend/src ``` -### **Passo 2: Instale as Dependências do Projeto 📦** +### Passo 2: Instale as Dependências do Projeto 📦 Com o terminal posicionado no diretório correto, execute: ```bash @@ -120,7 +120,7 @@ Com o terminal posicionado no diretório correto, execute: ``` Este comando fará o download e a instalação de todas as dependências listadas no arquivo `package.json`, as quais são indispensáveis para o funcionamento correto da aplicação. -### **Passo 3: Inicie o Servidor de Desenvolvimento 🔄** +### Passo 3: Inicie o Servidor de Desenvolvimento 🔄 Após a instalação das dependências, inicie o servidor de desenvolvimento com o comando: ```bash @@ -128,7 +128,7 @@ Após a instalação das dependências, inicie o servidor de desenvolvimento com ``` Este comando compilará o projeto e iniciará um servidor de desenvolvimento. Normalmente, a aplicação ficará disponível na URL `http://localhost:3000` (ou em outra porta configurada no projeto). -### **Passo 4: Acesse a Aplicação no Navegador 🌐** +### Passo 4: Acesse a Aplicação no Navegador 🌐 Abra o seu navegador de preferência e acesse: @@ -145,14 +145,14 @@ Caso haja qualquer problema durante o processo, verifique se todas as dependênc Para executar o back-end de nossa aplicação localmente, siga as instruções detalhadas a seguir. Este procedimento garantirá que o ambiente esteja devidamente configurado, que todas as dependências sejam instaladas e que as variáveis de ambiente essenciais estejam definidas, assegurando o funcionamento correto do sistema. -### **Pré-requisitos 📋** +### Pré-requisitos 📋 - **Python:** Certifique-se de que o Python (versão 3.7 ou superior é recomendado) esteja instalado em sua máquina. - **Redis:** Baixe e instale o Redis. Para instruções de instalação, consulte [redis.io/download](https://redis.io/download). Certifique-se de que o Redis esteja em execução na URL padrão `redis://127.0.0.1:6379`. - **Virtual Environment:** É recomendável utilizar um ambiente virtual para isolar as dependências do projeto. -### **Passo 1: Navegue até o Diretório do Back-end 📂** +### Passo 1: Navegue até o Diretório do Back-end 📂 Abra o terminal (ou prompt de comando) e acesse o diretório que contém o back-end da aplicação. @@ -161,7 +161,7 @@ Utilize o seguinte comando para navegar até esse diretório: cd C:\Users\gabri\Documents\GitHub\2025-1A-T12-EC05-G05\src\backend ``` -### **Passo 2: Crie e Ative o Ambiente Virtual 🛠️** +### Passo 2: Crie e Ative o Ambiente Virtual 🛠️ Crie um ambiente virtual no diretório atual executando: ```bash @@ -178,14 +178,14 @@ Em seguida, ative o ambiente virtual: source venv/bin/activate ``` -### **Passo 3: Instale as Dependências do Projeto 📦** +### Passo 3: Instale as Dependências do Projeto 📦 Com o ambiente virtual ativado, instale as dependências listadas no arquivo `requirements.txt` (que se encontra no mesmo nível da pasta `app`) com o seguinte comando: ```bash pip install -r requirements.txt ``` -### **Passo 4: Configure as Variáveis de Ambiente 🔑** +### Passo 4: Configure as Variáveis de Ambiente 🔑 É necessário definir uma variável de ambiente `SECRET_KEY` para proteger a aplicação. Crie um arquivo chamado **.env** no diretório do back-end (ao lado do arquivo `requirements.txt`) com o seguinte conteúdo: @@ -200,7 +200,7 @@ Com o ambiente virtual ativado, instale as dependências listadas no arquivo `re O arquivo **.env** será carregado pela aplicação (através do `load_dotenv`) para configurar a variável `SECRET_KEY` e outras configurações necessárias. -### **Passo 5: Execute a Aplicação Back-end 🚀** +### Passo 5: Execute a Aplicação Back-end 🚀 Após concluir a configuração, navegue até a pasta **app** e inicie a aplicação. ```bash From 767097f2c6b678a2bbf6dba54fe6270ab62d2d2d Mon Sep 17 00:00:00 2001 From: Danilo Date: Wed, 5 Mar 2025 17:13:44 -0300 Subject: [PATCH 3/4] fix: Local gitignore --- src/{ => dobot}/.gitignore | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename src/{ => dobot}/.gitignore (100%) diff --git a/src/.gitignore b/src/dobot/.gitignore similarity index 100% rename from src/.gitignore rename to src/dobot/.gitignore From d5f40e2cf98a51718e52aa2389e12d90a499a4e9 Mon Sep 17 00:00:00 2001 From: GabrielHMA01 Date: Wed, 5 Mar 2025 19:48:44 -0300 Subject: [PATCH 4/4] =?UTF-8?q?docs:=20muda=20a=20ordem=20de=20emoji=20e?= =?UTF-8?q?=20texto=20e=20duplica=20a=20instru=C3=A7=C3=A3o=20de=20como=20?= =?UTF-8?q?rodar?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- "docs/docs/Inicializa\303\247\303\243o.md" | 96 +++++----- src/README.md | 199 +++++++++++++++++++++ 2 files changed, 240 insertions(+), 55 deletions(-) create mode 100644 src/README.md diff --git "a/docs/docs/Inicializa\303\247\303\243o.md" "b/docs/docs/Inicializa\303\247\303\243o.md" index 1a22af5..41b1a5b 100644 --- "a/docs/docs/Inicializa\303\247\303\243o.md" +++ "b/docs/docs/Inicializa\303\247\303\243o.md" @@ -8,17 +8,15 @@ Para que você consiga executar a aplicação em seu ambiente local, é importan
-## Interface de Linha de Comando (CLI) 💻 +## 💻 Interface de Linha de Comando (CLI) A **CLI** é uma ferramenta versátil e eficiente que permite a interação com a aplicação por meio do terminal. Desenvolvida em **Python**, a CLI foi projetada para simplificar tarefas rotineiras, como iniciar o servidor, gerenciar scripts, executar comandos de manutenção e até mesmo automatizar processos complexos. A escolha do Python para esta interface não é aleatória: graças à sua sintaxe clara, ampla documentação e vasta biblioteca de módulos, Python facilita a criação de scripts ágeis e de fácil manutenção. Com essa ferramenta, os usuários podem configurar e monitorar a aplicação de forma rápida e sem a necessidade de uma interface gráfica elaborada. - -## Front-end 🎨 +## 🎨 Front-end O **front-end** da aplicação é responsável por toda a experiência visual e interação do usuário. Utilizamos o **React**, uma biblioteca JavaScript criada pelo Facebook que revolucionou o desenvolvimento de interfaces de usuário. O React adota uma abordagem baseada em componentes, permitindo que cada parte da interface seja modular e reutilizável. Isso torna o desenvolvimento mais organizado e a aplicação mais escalável, pois cada componente pode ser desenvolvido, testado e atualizado independentemente. Além disso, o React utiliza o Virtual DOM, que melhora significativamente a performance da aplicação, garantindo uma experiência fluida e responsiva, mesmo em interfaces complexas. Essa escolha reflete o compromisso com uma interface moderna e eficiente, que atende às expectativas dos usuários atuais. - -## Back-end 🔧 +## 🔧 Back-end No **back-end**, encontramos o núcleo que gerencia a lógica de negócio, o armazenamento e o processamento de dados da aplicação. Essa camada foi implementada utilizando o **Flask**, um micro-framework de Python conhecido por sua simplicidade e flexibilidade. O Flask permite a criação de APIs seguras, que servem como ponte entre o front-end e os sistemas de gerenciamento de dados. Sua estrutura minimalista possibilita uma rápida configuração e a adição de funcionalidades conforme necessário, sem impor uma arquitetura rígida. Dessa forma, o Flask facilita a integração com bancos de dados, serviços de autenticação e outras ferramentas essenciais para o funcionamento da aplicação, garantindo que a comunicação entre os diversos componentes seja eficiente e confiável. @@ -28,34 +26,29 @@ No **back-end**, encontramos o núcleo que gerencia a lógica de negócio, o arm
-## Como inicializar a CLI 💻 +## 💻 Como inicializar a CLI Para executar a interface de linha de comando (CLI) de nossa aplicação, siga as instruções detalhadas abaixo. Este procedimento garantirá que seu ambiente esteja configurado corretamente, permitindo que você utilize todas as funcionalidades oferecidas pela CLI. - - -### Pré-requisitos 🔧 +### 🔧 Pré-requisitos - **Python:** Certifique-se de que o Python (versão 3.7 ou superior é recomendado) esteja instalado em sua máquina. Caso não esteja, acesse [python.org](https://www.python.org/downloads/). - **Terminal:** Utilize um terminal (Prompt de Comando ou PowerShell no Windows, Terminal no Linux/macOS) para executar os comandos a seguir. - - -### Passo 1: Navegue até o Diretório da CLI 📂 +### 📂 Passo 1: Navegue até o Diretório da CLI Abra o terminal e acesse a pasta `dobot` do repositório, onde se encontram o arquivo `cli.py` e o arquivo `requirements.txt`. Utilize o seguinte comando para navegar até esse diretório: ```bash - cd 2025-1A-T12-EC05-G05/src/dobot +cd 2025-1A-T12-EC05-G05/src/dobot ``` - -### Passo 2: Crie e Ative o Ambiente Virtual 🛠️ +### 🛠️ Passo 2: Crie e Ative o Ambiente Virtual Crie um ambiente virtual para isolar as dependências do projeto com o comando: ```bash - python3 -m venv nome_da_venv +python3 -m venv nome_da_venv ``` > **Observação:** Substitua `nome_da_venv` pelo nome que desejar para o seu ambiente virtual. @@ -64,29 +57,26 @@ Em seguida, ative o ambiente virtual: - **Para Linux/macOS:** ```bash - source nome_da_venv/bin/activate +source nome_da_venv/bin/activate ``` - **Para Windows:** ```bash - nome_da_venv\Scripts\Activate +nome_da_venv\Scripts\Activate ``` - -### Passo 3: Instale as Dependências do Projeto 📦 +### 📦 Passo 3: Instale as Dependências do Projeto Com o ambiente virtual ativado, instale todas as bibliotecas necessárias executando: ```bash - pip install -r requirements.txt +pip install -r requirements.txt ``` Este comando fará o download e a instalação de todas as dependências listadas no arquivo `requirements.txt`. - - -### Passo 4: Execute a CLI e Confira as Funcionalidades 🔄 +### 🔄 Passo 4: Execute a CLI e Confira as Funcionalidades Após configurar o ambiente, execute o comando abaixo para visualizar as opções disponíveis na CLI: ```bash - python3 cli.py --help +python3 cli.py --help ``` Este comando exibirá uma mensagem de ajuda com todas as funções e comandos disponíveis, permitindo que você comece a operar o robô via linha de comando. @@ -94,41 +84,41 @@ Caso encontre algum problema, verifique se todas as dependências foram instalad --- -## Como inicializar o Front-end 🚀 +## 🚀 Como inicializar o Front-end Para executar o front-end de nossa aplicação localmente, siga as instruções detalhadas a seguir. Este procedimento permitirá que você configure e inicie o ambiente de desenvolvimento de forma adequada, garantindo que todas as dependências sejam corretamente instaladas e que a aplicação seja executada sem contratempos. -### Pré-requisitos 🔧 +### 🔧 Pré-requisitos - **Node.js e npm:** Certifique-se de que o Node.js (versão 14 ou superior é recomendado) e o npm estão instalados em sua máquina, caso contrário instale [nesse link](https://nodejs.org/en). - **Editor de Código:** Recomenda-se utilizar um editor de código, como o [Visual Studio Code](https://code.visualstudio.com/download), que facilita a edição, depuração e manutenção do código. -### Passo 1: Navegue até o Diretório do Front-end 📂 +### 📂 Passo 1: Navegue até o Diretório do Front-end Abra o terminal e acesse o diretório que contém o arquivo `package.json` do front-end. Utilize o seguinte comando para navegar até esse diretório: ```bash - cd 2025-1A-T12-EC05-G05/src/frontend/src +cd 2025-1A-T12-EC05-G05/src/frontend/src ``` -### Passo 2: Instale as Dependências do Projeto 📦 +### 📦 Passo 2: Instale as Dependências do Projeto Com o terminal posicionado no diretório correto, execute: ```bash - npm install +npm install ``` Este comando fará o download e a instalação de todas as dependências listadas no arquivo `package.json`, as quais são indispensáveis para o funcionamento correto da aplicação. -### Passo 3: Inicie o Servidor de Desenvolvimento 🔄 +### 🔄 Passo 3: Inicie o Servidor de Desenvolvimento Após a instalação das dependências, inicie o servidor de desenvolvimento com o comando: ```bash - npm run start +npm run start ``` Este comando compilará o projeto e iniciará um servidor de desenvolvimento. Normalmente, a aplicação ficará disponível na URL `http://localhost:3000` (ou em outra porta configurada no projeto). -### Passo 4: Acesse a Aplicação no Navegador 🌐 +### 🌐 Passo 4: Acesse a Aplicação no Navegador Abra o seu navegador de preferência e acesse: @@ -140,74 +130,70 @@ Caso haja qualquer problema durante o processo, verifique se todas as dependênc --- -## Como inicializar o Back-end 🔧 +## 🔧 Como inicializar o Back-end Para executar o back-end de nossa aplicação localmente, siga as instruções detalhadas a seguir. Este procedimento garantirá que o ambiente esteja devidamente configurado, que todas as dependências sejam instaladas e que as variáveis de ambiente essenciais estejam definidas, assegurando o funcionamento correto do sistema. - -### Pré-requisitos 📋 +### 📋 Pré-requisitos - **Python:** Certifique-se de que o Python (versão 3.7 ou superior é recomendado) esteja instalado em sua máquina. - **Redis:** Baixe e instale o Redis. Para instruções de instalação, consulte [redis.io/download](https://redis.io/download). Certifique-se de que o Redis esteja em execução na URL padrão `redis://127.0.0.1:6379`. - **Virtual Environment:** É recomendável utilizar um ambiente virtual para isolar as dependências do projeto. - -### Passo 1: Navegue até o Diretório do Back-end 📂 +### 📂 Passo 1: Navegue até o Diretório do Back-end Abra o terminal (ou prompt de comando) e acesse o diretório que contém o back-end da aplicação. Utilize o seguinte comando para navegar até esse diretório: ```bash - cd C:\Users\gabri\Documents\GitHub\2025-1A-T12-EC05-G05\src\backend +cd C:\Users\gabri\Documents\GitHub\2025-1A-T12-EC05-G05\src\backend ``` -### Passo 2: Crie e Ative o Ambiente Virtual 🛠️ +### 🛠️ Passo 2: Crie e Ative o Ambiente Virtual Crie um ambiente virtual no diretório atual executando: ```bash - python -m venv venv +python -m venv venv ``` Em seguida, ative o ambiente virtual: - **No Windows:** ```bash - venv\Scripts\activate +venv\Scripts\activate ``` - **No Linux/MacOS:** ```bash - source venv/bin/activate +source venv/bin/activate ``` -### Passo 3: Instale as Dependências do Projeto 📦 +### 📦 Passo 3: Instale as Dependências do Projeto Com o ambiente virtual ativado, instale as dependências listadas no arquivo `requirements.txt` (que se encontra no mesmo nível da pasta `app`) com o seguinte comando: ```bash - pip install -r requirements.txt +pip install -r requirements.txt ``` -### Passo 4: Configure as Variáveis de Ambiente 🔑 +### 🔑 Passo 4: Configure as Variáveis de Ambiente É necessário definir uma variável de ambiente `SECRET_KEY` para proteger a aplicação. Crie um arquivo chamado **.env** no diretório do back-end (ao lado do arquivo `requirements.txt`) com o seguinte conteúdo: SECRET_KEY=your_random_secret_key_here > Para gerar uma string aleatória, você pode usar o comando abaixo no terminal: ->```bash -> python -c "import secrets; print(secrets.token_hex(16))" ->``` +```bash +python -c "import secrets; print(secrets.token_hex(16))" +``` > Copie o resultado e substitua `your_random_secret_key_here` no arquivo **.env**. O arquivo **.env** será carregado pela aplicação (através do `load_dotenv`) para configurar a variável `SECRET_KEY` e outras configurações necessárias. - -### Passo 5: Execute a Aplicação Back-end 🚀 +### 🚀 Passo 5: Execute a Aplicação Back-end Após concluir a configuração, navegue até a pasta **app** e inicie a aplicação. ```bash - python run app.py +python run app.py ``` A aplicação deverá ser iniciada e estará disponível na URL padrão, geralmente `http://127.0.0.1:5000`. - -Caso haja qualquer problema, verifique se o Redis está em execução, se o ambiente virtual foi ativado e se as dependências foram instaladas corretamente. +Caso haja qualquer problema, verifique se o Redis está em execução, se o ambiente virtual foi ativado e se as dependências foram instaladas corretamente. \ No newline at end of file diff --git a/src/README.md b/src/README.md new file mode 100644 index 0000000..41b1a5b --- /dev/null +++ b/src/README.md @@ -0,0 +1,199 @@ +--- +sidebar_label: "Inicialização" +--- + +# Inicializando a Aplicação Localmente + +Para que você consiga executar a aplicação em seu ambiente local, é importante compreender os três pilares que a compõem: a interface de linha de comando (CLI), o front-end e o back-end. Cada um desses elementos foi cuidadosamente selecionado e implementado utilizando tecnologias modernas, que juntas formam uma arquitetura eficiente e completa. + +
+ +## 💻 Interface de Linha de Comando (CLI) + +A **CLI** é uma ferramenta versátil e eficiente que permite a interação com a aplicação por meio do terminal. Desenvolvida em **Python**, a CLI foi projetada para simplificar tarefas rotineiras, como iniciar o servidor, gerenciar scripts, executar comandos de manutenção e até mesmo automatizar processos complexos. A escolha do Python para esta interface não é aleatória: graças à sua sintaxe clara, ampla documentação e vasta biblioteca de módulos, Python facilita a criação de scripts ágeis e de fácil manutenção. Com essa ferramenta, os usuários podem configurar e monitorar a aplicação de forma rápida e sem a necessidade de uma interface gráfica elaborada. + +## 🎨 Front-end + +O **front-end** da aplicação é responsável por toda a experiência visual e interação do usuário. Utilizamos o **React**, uma biblioteca JavaScript criada pelo Facebook que revolucionou o desenvolvimento de interfaces de usuário. O React adota uma abordagem baseada em componentes, permitindo que cada parte da interface seja modular e reutilizável. Isso torna o desenvolvimento mais organizado e a aplicação mais escalável, pois cada componente pode ser desenvolvido, testado e atualizado independentemente. Além disso, o React utiliza o Virtual DOM, que melhora significativamente a performance da aplicação, garantindo uma experiência fluida e responsiva, mesmo em interfaces complexas. Essa escolha reflete o compromisso com uma interface moderna e eficiente, que atende às expectativas dos usuários atuais. + +## 🔧 Back-end + +No **back-end**, encontramos o núcleo que gerencia a lógica de negócio, o armazenamento e o processamento de dados da aplicação. Essa camada foi implementada utilizando o **Flask**, um micro-framework de Python conhecido por sua simplicidade e flexibilidade. O Flask permite a criação de APIs seguras, que servem como ponte entre o front-end e os sistemas de gerenciamento de dados. Sua estrutura minimalista possibilita uma rápida configuração e a adição de funcionalidades conforme necessário, sem impor uma arquitetura rígida. Dessa forma, o Flask facilita a integração com bancos de dados, serviços de autenticação e outras ferramentas essenciais para o funcionamento da aplicação, garantindo que a comunicação entre os diversos componentes seja eficiente e confiável. + +
+ +--- + +
+ +## 💻 Como inicializar a CLI + +Para executar a interface de linha de comando (CLI) de nossa aplicação, siga as instruções detalhadas abaixo. Este procedimento garantirá que seu ambiente esteja configurado corretamente, permitindo que você utilize todas as funcionalidades oferecidas pela CLI. + +### 🔧 Pré-requisitos + +- **Python:** Certifique-se de que o Python (versão 3.7 ou superior é recomendado) esteja instalado em sua máquina. Caso não esteja, acesse [python.org](https://www.python.org/downloads/). +- **Terminal:** Utilize um terminal (Prompt de Comando ou PowerShell no Windows, Terminal no Linux/macOS) para executar os comandos a seguir. + +### 📂 Passo 1: Navegue até o Diretório da CLI + +Abra o terminal e acesse a pasta `dobot` do repositório, onde se encontram o arquivo `cli.py` e o arquivo `requirements.txt`. + +Utilize o seguinte comando para navegar até esse diretório: +```bash +cd 2025-1A-T12-EC05-G05/src/dobot +``` + +### 🛠️ Passo 2: Crie e Ative o Ambiente Virtual + +Crie um ambiente virtual para isolar as dependências do projeto com o comando: +```bash +python3 -m venv nome_da_venv +``` + +> **Observação:** Substitua `nome_da_venv` pelo nome que desejar para o seu ambiente virtual. + +Em seguida, ative o ambiente virtual: + +- **Para Linux/macOS:** +```bash +source nome_da_venv/bin/activate +``` +- **Para Windows:** +```bash +nome_da_venv\Scripts\Activate +``` + +### 📦 Passo 3: Instale as Dependências do Projeto + +Com o ambiente virtual ativado, instale todas as bibliotecas necessárias executando: +```bash +pip install -r requirements.txt +``` +Este comando fará o download e a instalação de todas as dependências listadas no arquivo `requirements.txt`. + +### 🔄 Passo 4: Execute a CLI e Confira as Funcionalidades + +Após configurar o ambiente, execute o comando abaixo para visualizar as opções disponíveis na CLI: +```bash +python3 cli.py --help +``` +Este comando exibirá uma mensagem de ajuda com todas as funções e comandos disponíveis, permitindo que você comece a operar o robô via linha de comando. + +Caso encontre algum problema, verifique se todas as dependências foram instaladas corretamente e se o ambiente virtual foi ativado com sucesso. + +--- + +## 🚀 Como inicializar o Front-end + +Para executar o front-end de nossa aplicação localmente, siga as instruções detalhadas a seguir. Este procedimento permitirá que você configure e inicie o ambiente de desenvolvimento de forma adequada, garantindo que todas as dependências sejam corretamente instaladas e que a aplicação seja executada sem contratempos. + +### 🔧 Pré-requisitos + +- **Node.js e npm:** Certifique-se de que o Node.js (versão 14 ou superior é recomendado) e o npm estão instalados em sua máquina, caso contrário instale [nesse link](https://nodejs.org/en). +- **Editor de Código:** Recomenda-se utilizar um editor de código, como o [Visual Studio Code](https://code.visualstudio.com/download), que facilita a edição, depuração e manutenção do código. + +### 📂 Passo 1: Navegue até o Diretório do Front-end + +Abra o terminal e acesse o diretório que contém o arquivo `package.json` do front-end. + +Utilize o seguinte comando para navegar até esse diretório: +```bash +cd 2025-1A-T12-EC05-G05/src/frontend/src +``` + +### 📦 Passo 2: Instale as Dependências do Projeto + +Com o terminal posicionado no diretório correto, execute: +```bash +npm install +``` +Este comando fará o download e a instalação de todas as dependências listadas no arquivo `package.json`, as quais são indispensáveis para o funcionamento correto da aplicação. + +### 🔄 Passo 3: Inicie o Servidor de Desenvolvimento + +Após a instalação das dependências, inicie o servidor de desenvolvimento com o comando: +```bash +npm run start +``` +Este comando compilará o projeto e iniciará um servidor de desenvolvimento. Normalmente, a aplicação ficará disponível na URL `http://localhost:3000` (ou em outra porta configurada no projeto). + +### 🌐 Passo 4: Acesse a Aplicação no Navegador + +Abra o seu navegador de preferência e acesse: + + http://localhost:3000 + +Ao acessar essa URL, você visualizará a aplicação front-end em execução. O servidor de desenvolvimento conta com recarregamento automático (hot reload), permitindo que qualquer alteração no código seja imediatamente refletida na interface. + +Caso haja qualquer problema durante o processo, verifique se todas as dependências foram instaladas corretamente e se o caminho do diretório está correto. + +--- + +## 🔧 Como inicializar o Back-end + +Para executar o back-end de nossa aplicação localmente, siga as instruções detalhadas a seguir. Este procedimento garantirá que o ambiente esteja devidamente configurado, que todas as dependências sejam instaladas e que as variáveis de ambiente essenciais estejam definidas, assegurando o funcionamento correto do sistema. + +### 📋 Pré-requisitos + +- **Python:** Certifique-se de que o Python (versão 3.7 ou superior é recomendado) esteja instalado em sua máquina. +- **Redis:** Baixe e instale o Redis. Para instruções de instalação, consulte [redis.io/download](https://redis.io/download). Certifique-se de que o Redis esteja em execução na URL padrão `redis://127.0.0.1:6379`. +- **Virtual Environment:** É recomendável utilizar um ambiente virtual para isolar as dependências do projeto. + +### 📂 Passo 1: Navegue até o Diretório do Back-end + +Abra o terminal (ou prompt de comando) e acesse o diretório que contém o back-end da aplicação. + +Utilize o seguinte comando para navegar até esse diretório: +```bash +cd C:\Users\gabri\Documents\GitHub\2025-1A-T12-EC05-G05\src\backend +``` + +### 🛠️ Passo 2: Crie e Ative o Ambiente Virtual + +Crie um ambiente virtual no diretório atual executando: +```bash +python -m venv venv +``` +Em seguida, ative o ambiente virtual: + +- **No Windows:** +```bash +venv\Scripts\activate +``` +- **No Linux/MacOS:** +```bash +source venv/bin/activate +``` + +### 📦 Passo 3: Instale as Dependências do Projeto + +Com o ambiente virtual ativado, instale as dependências listadas no arquivo `requirements.txt` (que se encontra no mesmo nível da pasta `app`) com o seguinte comando: +```bash +pip install -r requirements.txt +``` + +### 🔑 Passo 4: Configure as Variáveis de Ambiente + +É necessário definir uma variável de ambiente `SECRET_KEY` para proteger a aplicação. Crie um arquivo chamado **.env** no diretório do back-end (ao lado do arquivo `requirements.txt`) com o seguinte conteúdo: + + SECRET_KEY=your_random_secret_key_here + +> Para gerar uma string aleatória, você pode usar o comando abaixo no terminal: +```bash +python -c "import secrets; print(secrets.token_hex(16))" +``` +> Copie o resultado e substitua `your_random_secret_key_here` no arquivo **.env**. + +O arquivo **.env** será carregado pela aplicação (através do `load_dotenv`) para configurar a variável `SECRET_KEY` e outras configurações necessárias. + +### 🚀 Passo 5: Execute a Aplicação Back-end + +Após concluir a configuração, navegue até a pasta **app** e inicie a aplicação. +```bash +python run app.py +``` + +A aplicação deverá ser iniciada e estará disponível na URL padrão, geralmente `http://127.0.0.1:5000`. + +Caso haja qualquer problema, verifique se o Redis está em execução, se o ambiente virtual foi ativado e se as dependências foram instaladas corretamente. \ No newline at end of file