# Manual de Instalação e Configuração Linux - PraFrota FE

Este manual detalha o processo para preparar o ambiente e rodar o workspace **Angular 19** da PraFrota em máquinas Linux.

## 📋 Pré-requisitos
- **Node.js**: Versão 20.x (Obrigatório).
- **Angular CLI**: Instalado globalmente.
- **NVM**: Para gestão de versão do Node.

---

## 🚀 Passo a Passo

### 1. Instalar NVM e Node 20
Se ainda não tiver o Node 20:
```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
# nvm use: ativa a versão 20 no terminal atual.
```

### 2. Instalar Angular CLI Globalmente
Para gerir o workspace e rodar testes:
```bash
npm install -g @angular/cli@19
# -g: instala globalmente no sistema para ser usado em qualquer pasta.
```

### 3. Instalar Dependências do Workspace
Na raiz da pasta `prafrota_fe-main`:
```bash
npm install
# npm install: baixará centenas de pacotes necessários para o Angular, Material e Plugins.
```

### 4. Rodar o Projeto Principal (idt_app)
**ATENÇÃO**: O projeto utiliza um script customizado de inicialização.
```bash
npm run serve:prafrota
# serve:prafrota: este comando inicia o projeto central (ERP) na porta 4200.
```

### 5. Levantamento de Outros Cenários (Linux Universal)
Para facilitar configurações em diferentes distros (Arch, RHEL, Ubuntu), utilize o script automatizado disponível no projeto:
```bash
chmod +x ./scripts/setup-linux-universal.sh
./scripts/setup-linux-universal.sh
# chmod +x: dá permissão de execução ao script.
# Este script detecta sua distribuição Linux e instala as bibliotecas de sistema necessárias automaticamente.
```

---

## 🛠️ Explicação Técnica dos Comandos
- **`ng build`**: Compila a aplicação para produção, minimizando o código JS para acelerar o site.
- **`ng test`**: Executa testes automáticos para garantir que nada foi quebrado em novas atualizações.
- **`nvmrc`**: O arquivo `.nvmrc` na raiz permite que você rode `nvm use` e o sistema selecione a versão correta do Node automaticamente.
