# Processo de Configuração do Projeto PraFrota FE

Este documento descreve as etapas realizadas para configurar o ambiente de desenvolvimento e iniciar a aplicação PraFrota FE, incluindo as correções de problemas encontrados durante o processo.

## 📋 Resumo do Processo

O projeto é um workspace Angular 19 multi-projetos. O principal desafio foi a gestão de dependências locais e problemas de permissão no ambiente Windows.

### 1. Exploração Inicial
- **Arquivos Analisados**: `package.json`, `angular.json`, `tsconfig.json`.
- **Dependência Crítica**: Identificamos que a aplicação principal (`idt_app`) depende de uma biblioteca local (`libs`) que deve ser compilada previamente em `dist/libs`.

### 2. Resolução de Dependências (Troubleshooting)
Inicialmente, o comando `npm install` falhou devido a conflitos de peer dependencies e erros de permissão (`EPERM`).

**Solução aplicada:**
1. **Limpeza Profunda**: Remoção completa da pasta `node_modules` para garantir um estado limpo.
   ```powershell
   Remove-Item -Path node_modules -Recurse -Force
   ```
2. **Reinstalação**: Execução do install ignorando conflitos de versão legados.
   ```powershell
   npm install --legacy-peer-deps
   ```

### 3. Build da Biblioteca (Pré-requisito)
Antes de subir a aplicação principal, foi necessário compilar o projeto de bibliotecas compartilhadas:
```bash
npm run build libs
```
Este comando gera os arquivos em `dist/libs`, que são mapeados no `tsconfig.json` para serem usados pelos outros projetos do workspace.

### 4. Inicialização da Aplicação
Com as dependências instaladas e a biblioteca compilada, iniciamos a aplicação principal:
```bash
npm run start-debug
```
- **Porta**: 4200
- **Host**: localhost
- **Configuração**: Development

### 5. Verificação
A aplicação foi validada acessando `http://localhost:4200`, confirmando que:
- O servidor de desenvolvimento Angular subiu sem erros.
- A tela de login (SignIn) carregou corretamente com todos os assets e estilos.
- O componente de aviso de PWA/Mobile está funcional.

---

## ⚠️ Observações Técnicas

- **Node.js**: Recomendado v20+ (Utilizado v24.12.0 durante o setup).
- **Angular CLI**: v19.2.13.
- **Dica**: Se encontrar erros de "path not found" para `idt-libs`, certifique-se de que o passo `npm run build libs` foi executado com sucesso.
