162 lines
5.8 KiB
Markdown
162 lines
5.8 KiB
Markdown
# Form Metacase
|
|
|
|
Portal interno da Metacase que centraliza conteúdos de formação e ferramentas de apoio operacional numa aplicação web autenticada.
|
|
|
|
O projeto disponibiliza um Learning Hub com cursos multimédia, um assistente de IA, tradução de textos, conversão de extratos bancários e consulta de um relatório Power BI.
|
|
|
|
## Funcionalidades
|
|
|
|
### Autenticação
|
|
|
|
- Login por email e palavra-passe.
|
|
- Sessões com validade de oito horas e opção para manter a sessão.
|
|
- Proteção das páginas privadas através de `authGuard`.
|
|
- Palavras-passe armazenadas com salt e hash PBKDF2-SHA256.
|
|
|
|
### Learning Hub
|
|
|
|
- Catálogo, detalhe e percurso de cursos.
|
|
- Conteúdos em texto, imagem, galeria, apresentação, vídeo, áudio e documentos.
|
|
- Navegação entre diapositivos, ampliação de imagens e indicador de progresso.
|
|
- Perguntas de validação com feedback de resposta.
|
|
|
|
### Ferramentas operacionais
|
|
|
|
- **Vitoria AI:** chat com histórico, fontes e integração com um backend de IA.
|
|
- **Conversor de extratos:** conversão de PDF para Excel para ABANCA e BIC através de Python, extração de tabelas e OCR.
|
|
- **Tradutor:** tradução através de LibreTranslate, inversão de idiomas e cópia do resultado.
|
|
- **Report Creator:** consulta de um relatório publicado no Power BI Service através de `reportEmbed`.
|
|
|
|
## Tecnologias
|
|
|
|
| Área | Tecnologia |
|
|
| --- | --- |
|
|
| Frontend | Angular 21, TypeScript 5.9, HTML e CSS |
|
|
| Estado e reatividade | Angular Signals e RxJS 7.8 |
|
|
| Backend | Node.js 22 e módulos nativos `http`, `crypto`, `fs` e `child_process` |
|
|
| Processamento de PDF | Python, Camelot, PyMuPDF, pytesseract, Pillow e pandas |
|
|
| Integrações | LibreTranslate, Power BI Service e backend Bot SIBS/LLM |
|
|
| Testes | Vitest e jsdom |
|
|
| Build e deployment | Angular CLI, npm, Docker, Docker Compose e Nginx |
|
|
|
|
## Arquitetura
|
|
|
|
```text
|
|
Utilizador
|
|
|
|
|
v
|
|
Angular SPA
|
|
|
|
|
+-- Learning Hub --------> conteúdos em public/
|
|
+-- Report Creator ------> Power BI Service
|
|
|
|
|
v
|
|
API Node.js (server.js)
|
|
|
|
|
+-- Autenticação --------> server/users.json
|
|
+-- Vitoria AI ----------> backend Bot SIBS / LLM
|
|
+-- Tradutor ------------> LibreTranslate
|
|
+-- Conversor -----------> scripts Python -> XLSX
|
|
```
|
|
|
|
Em desenvolvimento, o Angular é executado na porta `4200` e encaminha `/api` para o servidor Node.js na porta `3000`. Em produção, o servidor Node.js serve a aplicação compilada e a API no mesmo domínio.
|
|
|
|
## Estrutura do projeto
|
|
|
|
```text
|
|
form_metacase/
|
|
├── deploy/nginx/ # Configuração do reverse proxy
|
|
├── Metacase/ # Conversores Python ABANCA e BIC
|
|
├── public/ # Imagens, vídeos, áudio e documentos
|
|
├── server/
|
|
│ └── users.json # Utilizadores locais
|
|
├── src/app/
|
|
│ ├── auth/ # Autenticação e proteção de rotas
|
|
│ ├── conversor-extratos-page/
|
|
│ ├── course-detail-page/
|
|
│ ├── course-learning-page/
|
|
│ ├── data/ # Catálogo estático de cursos
|
|
│ ├── formacaometacase/ # Catálogo do Learning Hub
|
|
│ ├── login-page/
|
|
│ ├── pagina-principal/ # Hub principal
|
|
│ ├── report-creator-page/
|
|
│ ├── shared/ # Componentes reutilizáveis
|
|
│ ├── tradutor/
|
|
│ └── vitoria-ai-page/
|
|
├── angular.json
|
|
├── docker-compose.yml
|
|
├── Dockerfile
|
|
├── package.json
|
|
├── proxy.conf.json
|
|
└── server.js
|
|
```
|
|
|
|
## Rotas
|
|
|
|
| Rota | Página | Acesso |
|
|
| --- | --- | --- |
|
|
| `/` | Login | Público |
|
|
| `/pagina-principal` | Hub principal | Autenticado |
|
|
| `/formacoes` | Catálogo de cursos | Autenticado |
|
|
| `/cursos/:slug` | Detalhe do curso | Autenticado |
|
|
| `/cursos/:slug/percurso` | Percurso de aprendizagem | Autenticado |
|
|
| `/vitoria-ai` | Assistente Vitoria AI | Autenticado |
|
|
| `/conversor-extratos` | Conversor PDF para Excel | Autenticado |
|
|
| `/tradutor` | Tradutor | Autenticado |
|
|
| `/report-creator` | Relatório Power BI | Autenticado |
|
|
|
|
## Pré-requisitos
|
|
|
|
### Aplicação base
|
|
|
|
- Node.js 22 ou superior.
|
|
- npm 10 ou superior.
|
|
|
|
### Conversores de extratos
|
|
|
|
- Python 3.
|
|
- `pandas`, `camelot-py`, `PyMuPDF`, `pytesseract`, `Pillow` e `openpyxl`.
|
|
- Tesseract OCR e dependências de sistema requeridas pelo Camelot.
|
|
|
|
Exemplo:
|
|
|
|
```bash
|
|
python -m pip install pandas camelot-py PyMuPDF pytesseract Pillow openpyxl
|
|
```
|
|
|
|
### Integrações
|
|
|
|
- Instância LibreTranslate acessível pelo servidor.
|
|
- Backend compatível com a API da Vitoria AI.
|
|
- Acesso ao tenant e ao relatório configurado no Power BI Service.
|
|
|
|
## Instalação
|
|
|
|
```bash
|
|
git clone http://192.168.1.39:3001/kl3z/Metacase.git
|
|
cd form_metacase
|
|
npm ci
|
|
```
|
|
|
|
## Configuração (no meu Servidor aqui a Arquitetura e as configurações dependem da construções e das caracteristicas que quiserem colocar)
|
|
|
|
| Variável | Predefinição | Descrição |
|
|
| --- | --- | --- |
|
|
| `PORT` | `3000` | Porta do servidor Node.js. |
|
|
| `AUTH_TOKEN_SECRET` | valor de desenvolvimento | Segredo de assinatura das sessões. |
|
|
| `BOT_SIBS_API_URL` | `http://127.0.0.1:8000` | Backend da Vitoria AI. |
|
|
| `BOT_SIBS_TIMEOUT_MS` | `240000` | Timeout da Vitoria AI. |
|
|
| `LIBRETRANSLATE_URL` | endereço interno | Instância LibreTranslate. |
|
|
| `PYTHON_BIN` | `python` | Executável Python. |
|
|
| `CONVERTERS_DIR` | `./Metacase` | Diretório dos conversores. |
|
|
| `CONVERTER_TIMEOUT_MS` | `600000` | Timeout de conversão. |
|
|
| `CONVERTER_MAX_UPLOAD_BYTES` | `26214400` | Limite do PDF, por defeito 25 MB. |
|
|
|
|
|
|
|
|
## Utilizadores
|
|
|
|
Os utilizadores locais são mantidos em `server/users.json`, com nome, email, estado, salt e hash da palavra-passe. Não devem ser guardadas palavras-passe em texto simples.
|
|
|
|
Para produção ou utilização em maior escala, recomenda-se uma base de dados ou um fornecedor de identidade corporativo. Por exemplo weviate
|