Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/neemiasborges/advpl_totvs_clientmanager
Sistema de gerenciamento de clientes desenvolvido para integrar TOTVS Protheus com tecnologias web modernas. Este projeto full-stack, com frontend em Angular e backend integrado ao Protheus, oferece recursos avançados como notificações automatizadas por email e uma API RESTful, desenvolvida em Node.js,
https://github.com/neemiasborges/advpl_totvs_clientmanager
advpl angular totvs totvs-protheus
Last synced: about 1 month ago
JSON representation
Sistema de gerenciamento de clientes desenvolvido para integrar TOTVS Protheus com tecnologias web modernas. Este projeto full-stack, com frontend em Angular e backend integrado ao Protheus, oferece recursos avançados como notificações automatizadas por email e uma API RESTful, desenvolvida em Node.js,
- Host: GitHub
- URL: https://github.com/neemiasborges/advpl_totvs_clientmanager
- Owner: NeemiasBorges
- License: mit
- Created: 2024-10-10T00:19:52.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-11-13T21:09:00.000Z (about 2 months ago)
- Last Synced: 2024-11-13T22:18:44.992Z (about 2 months ago)
- Topics: advpl, angular, totvs, totvs-protheus
- Language: TypeScript
- Homepage:
- Size: 1.23 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cliente360 - Sistema de Gerenciamento de Clientes
Sistema full-stack para gerenciamento de clientes integrando Angular Material no frontend com API TOTVS Protheus, incluindo notificações por email automatizadas.
---
## 🚀 Tecnologias Utilizadas
### Frontend
- Angular 16+
- Angular Material
- RxJS
- TypeScript
- SCSS
### Backend
- TOTVS Protheus REST API
- Node.js (Serviço de Email)
- Express
- Nodemailer
## 📋 Pré-requisitos
- Node.js 18+
- Angular CLI 16+
- TOTVS Protheus configurado e rodando localmente
- NPM ou Yarn
- Banco de dados configurado no Protheus
## 🔧 Instalação e Configuração
### Frontend (Angular)
1. Clone o repositório e entre no diretório do frontend.
2. Instale as dependências.
3. Inicie o servidor de desenvolvimento.
### Serviço de Email (Node.js)
1. Entre no diretório do serviço de email e instale as dependências.
2. Configure as variáveis de ambiente.
3. Inicie o serviço.
### Configuração do arquivo .env para o serviço de email
Configure os valores de `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASS`, e `TOTVS_API_URL` conforme necessário.
## 📐 Estrutura do Projeto
```
cliente360/
├── frontend/
│ ├── src/
│ │ ├── app/
│ │ │ ├── components/
│ │ │ ├── services/
│ │ │ ├── models/
│ │ │ └── shared/
│ │ ├── assets/
│ │ └── environments/
├── email-service/
│ ├── src/
│ │ ├── controllers/
│ │ ├── services/
│ │ └── utils/
└── README.md
```
---
## 🔌 Endpoints da API TOTVS
### Clientes
- `GET /v1/clientes/listar` - Lista todos os clientes
- `GET /v1/clientes/:codigo` - Obtém detalhes de um cliente específico
- `POST /v1/clientes/incluir` - Cadastra novo cliente
- `PUT /v1/clientes/atualizar/:codigo/:loja` - Atualiza dados do cliente
- `DELETE /v1/clientes/deletar/:codigo/:loja` - Remove cliente
- `GET /v1/clientes/ultimoCodigo` - Obtém último código cadastrado
- `GET /v1/clientes/municipiosporestado/:estado` - Lista municípios por estado
- `GET /v1/clientes/codigomunicipio/:estado/:municipio` - Obtém código do município
## 📨 Serviço de Email
O serviço de email é um microsserviço Node.js que:
1. Monitora alterações na API TOTVS através de polling
2. Envia emails automáticos quando detecta alterações em clientes
3. Mantém um log de notificações enviadas
## 🔒 Segurança
- Implementação de JWT para autenticação
- Sanitização de inputs
- Validação de dados no frontend e backend
- Proteção contra CSRF
- Rate limiting na API
## 📦 Build e Deploy
### Frontend
1. Gerar build de produção.
### Serviço de Email
1. Gerar build de produção.
## 🛠️ Desenvolvimento
### Adicionando Novos Componentes
Para novos componentes, utilize `ng generate component` e `ng generate service` para novos serviços.
---
### Padrões de Código
- Utilize TypeScript strict mode
- Siga o style guide do Angular
- Mantenha componentes pequenos e reutilizáveis
- Implemente lazy loading para módulos
- Use interceptors para tratamento de erros
---
# 📝 Autores
---
## 📄 Licença
Este projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.