testes/prafrota_fe-main/prafrota_fe-main/README.md

77 lines
2.1 KiB
Markdown

# PraFrota FE (Angular Workspace)
Este repositório contém o Front-End da plataforma PraFrota, desenvolvido em **Angular 19**. O projeto está estruturado como um workspace multi-projetos, permitindo o compartilhamento de código e gestão centralizada de dependências.
## 🚀 Tecnologias
- **Framework**: [Angular 19](https://angular.io/)
- **Linguagem**: TypeScript
- **Componentes UI**: Angular Material, FontAwesome
- **Mapas**: Leaflet (ng-leaflet-universal)
- **Gráficos**: ng2-charts
- **Build System**: Angular CLI (com suporte Nx)
## 📂 Estrutura do Workspace
O código fonte reside principalmente na pasta `projects/`.
### Projetos Principais (`/projects`)
- **`idt_app`**: **Aplicação Principal (PraFrota)**.
- É a aplicação core executada pelos comandos de start principais.
- Provavelmente contém o painel administrativo e de gestão.
- **`cliente`**: **Portal do Cliente**.
- Aplicação dedicada à visão do cliente/tenant.
- **`escala`**: **Módulo de Escala**.
- Funcionalidade específica (possivelmente micro-frontend ou app independente) para gestão de escalas.
- **`idt_pattern`**: **Design System / Componentes**.
- Biblioteca de componentes reutilizáveis e estilos padrões.
- **`libs`**: **Bibliotecas Compartilhadas**.
- Código comum, serviços e utilitários compartilhados entre os apps.
## 🛠️ Instalação e Execução
### Pré-requisitos
- Node.js (versão compatível com Angular 19)
- NPM
### Instalação
```bash
npm install
```
### Rodando a Aplicação Principal (PraFrota / idt_app)
Para ambiente de desenvolvimento:
```bash
npm run serve:prafrota
# ou
npm run start-debug
```
Acesse: `http://localhost:4200`
### Rodando o Módulo Escala
```bash
npm run ESCALA_development
```
### Build
Para criar os artefatos de produção:
```bash
npm run build:prafrota
```
Os arquivos gerados estarão em `dist/`.
## 🧪 Notas de Desenvolvimento
- O projeto utiliza scripts customizados em `.mcp/` e `scripts/`, sugerindo automação avançada para criação de domínios (Domain Driven Design).
- Consulte `scripts/create-domain.js` para entender como gerar novos módulos de domínio.