{"id":28754419,"url":"https://github.com/tech-preta/fintelli","last_synced_at":"2025-08-23T02:05:57.359Z","repository":{"id":298995253,"uuid":"1001076372","full_name":"Tech-Preta/fintelli","owner":"Tech-Preta","description":"Aplicação full-stack de finanças com IA com observabilidade nativa.","archived":false,"fork":false,"pushed_at":"2025-06-14T03:17:27.000Z","size":142,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-14T03:32:16.484Z","etag":null,"topics":["autoprefixer","axios","css","docker","docker-compose","fastapi","gemini","helm","html","nginx","opentelemetry-collector","postcss","postgresql","python","react","redis","tailwind","typescript","uvicorn","vite"],"latest_commit_sha":null,"homepage":"https://www.nataliagranato.xyz/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Tech-Preta.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"nataliagranato","ko_fi":"nataliagranato","buy_me_a_coffee":"nataliagranato","pix":"fada126d-7311-495f-bda2-55ec79b0a39b"}},"created_at":"2025-06-12T19:28:29.000Z","updated_at":"2025-06-14T03:17:31.000Z","dependencies_parsed_at":"2025-06-14T03:32:25.928Z","dependency_job_id":"8d9e5bd6-1589-463f-a62b-c07272d380a8","html_url":"https://github.com/Tech-Preta/fintelli","commit_stats":null,"previous_names":["tech-preta/fintelli"],"tags_count":0,"template":false,"template_full_name":"Tech-Preta/repository_sample","purl":"pkg:github/Tech-Preta/fintelli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tech-Preta%2Ffintelli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tech-Preta%2Ffintelli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tech-Preta%2Ffintelli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tech-Preta%2Ffintelli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tech-Preta","download_url":"https://codeload.github.com/Tech-Preta/fintelli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tech-Preta%2Ffintelli/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260269457,"owners_count":22983648,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autoprefixer","axios","css","docker","docker-compose","fastapi","gemini","helm","html","nginx","opentelemetry-collector","postcss","postgresql","python","react","redis","tailwind","typescript","uvicorn","vite"],"created_at":"2025-06-17T01:09:17.365Z","updated_at":"2025-06-17T01:09:39.000Z","avatar_url":"https://github.com/Tech-Preta.png","language":"Python","funding_links":["https://github.com/sponsors/nataliagranato","https://ko-fi.com/nataliagranato","https://buymeacoffee.com/nataliagranato","fada126d-7311-495f-bda2-55ec79b0a39b"],"categories":[],"sub_categories":[],"readme":"# 🧠 Fintelli - Finanças Inteligentes com IA\n\n## 🎉 **Versão 1.0.0 - Stack Completo de Observabilidade Fintech**\n\nEsta é uma aplicação full-stack para gerenciamento de finanças pessoais com inteligência artificial, totalmente containerizada com Docker e instrumentada com **OpenTelemetry** para observabilidade completa. Inclui **Service Performance Monitoring (SPM)** avançado, alertas inteligentes e documentação técnica abrangente.\n\n## 🏗️ Diagrama de Arquitetura\n\n```mermaid\ngraph TD\n    subgraph External[\"🌐 AMBIENTE EXTERNO\"]\n        User[\"👤 Usuário via Browser\"]\n    end\n\n    subgraph Docker[\"🐳 DOCKER ENVIRONMENT\"]\n        subgraph FrontendLayer[\"📱 FRONTEND LAYER\"]\n            Frontend[\"🌐 Frontend\u003cbr/\u003e(React + Nginx)\"]\n        end\n\n        subgraph BackendLayer[\"⚙️ BACKEND LAYER\"]\n            Backend[\"🔧 Backend\u003cbr/\u003e(FastAPI + Python)\"]\n        end\n\n        subgraph DataLayer[\"💾 DATA LAYER\"]\n            Postgres[\"🗄️ PostgreSQL\u003cbr/\u003e(Database)\"]\n            Redis[\"⚡ Redis\u003cbr/\u003e(Cache)\"]\n        end\n\n        subgraph ObsStack[\"📊 OBSERVABILITY STACK\"]\n            OTel[\"📡 OTel Collector\u003cbr/\u003e(Telemetry)\"]\n            \n            subgraph Monitoring[\"📈 MONITORING TOOLS\"]\n                Jaeger[\"🔍 Jaeger\u003cbr/\u003e(Traces)\"]\n                Grafana[\"📊 Grafana\u003cbr/\u003e(Dashboards)\"]\n                Prometheus[\"📈 Prometheus\u003cbr/\u003e(Metrics)\"]\n            end\n        end\n    end\n\n    %% User Flow\n    User --\u003e|HTTP Request| Frontend\n    Frontend --\u003e|API Calls| Backend\n    \n    %% Data Flow\n    Backend --\u003e|Read/Write| Postgres\n    Backend --\u003e|Cache| Redis\n    \n    %% Telemetry Flow\n    Frontend -.-\u003e|Traces| OTel\n    Backend -.-\u003e|Traces \u0026 Metrics| OTel\n    OTel --\u003e|Export Traces| Jaeger\n    OTel --\u003e|Export Metrics| Prometheus\n    \n    %% SPM Flow (Service Performance Monitoring)\n    OTel -.-\u003e|SpanMetrics| Prometheus\n    Prometheus --\u003e|SPM Queries| Grafana\n\n    %% High Contrast Styles\n    classDef userStyle fill:#ffffff,stroke:#000000,stroke-width:3px,color:#000000\n    classDef frontendStyle fill:#c8e6c9,stroke:#1b5e20,stroke-width:3px,color:#000000\n    classDef backendStyle fill:#ffcc80,stroke:#bf360c,stroke-width:3px,color:#000000\n    classDef dataStyle fill:#ce93d8,stroke:#4a148c,stroke-width:3px,color:#000000\n    classDef obsStyle fill:#f8bbd9,stroke:#880e4f,stroke-width:3px,color:#000000\n    \n    class User userStyle\n    class Frontend frontendStyle\n    class Backend backendStyle\n    class Postgres,Redis dataStyle\n    class OTel,Jaeger,Grafana,Prometheus obsStyle\n```\n\n## 📋 Arquitetura\n\n- **Frontend**: Nginx servindo um site estático (HTML, CSS, JS) instrumentado com OTel JS SDK\n- **Backend**: API RESTful com FastAPI (Python), instrumentada com OTel Python SDK\n- **Banco de Dados**: PostgreSQL\n- **Cache**: Redis\n- **Orquestração**: Docker Compose\n\n### 🔍 Pilha de Observabilidade\n\n- **OTel Collector**: Recebe telemetria do frontend e backend\n- **Jaeger**: Armazena e visualiza traces distribuídos\n- **Prometheus**: Coleta e armazena métricas\n- **Grafana**: Cria dashboards para visualizar as métricas\n\n## 📁 Estrutura de Diretórios\n\n```\nfintelli/\n├── src/\n│   ├── backend/\n│   │   ├── app/\n│   │   │   ├── instrumentation.py  # Configuração do OpenTelemetry\n│   │   │   └── main.py\n│   │   ├── Dockerfile\n│   │   └── requirements.txt\n│   └── frontend/\n│       ├── index.html\n│       ├── telemetry.js            # Instrumentação OTel do Frontend\n│       ├── package.json\n│       ├── vite.config.ts\n│       ├── Dockerfile\n│       ├── nginx.conf\n│       └── src/\n│           ├── App.tsx\n│           ├── main.tsx\n│           ├── components/\n│           └── services/\n├── charts/\n│   └── fintelli/               # Helm Chart para Kubernetes\n├── config/\n│   ├── otel-collector-config.yml     # Configuração do Collector\n│   ├── prometheus.yml                # Configuração do Prometheus\n│   ├── spm-alerts.yml                # Regras de alerta SPM\n│   ├── fintelli-enhanced-alerts.yml  # Alertas avançados\n│   ├── alertmanager.yml              # Configuração Alertmanager\n│   └── grafana-spm-dashboard.json    # Dashboard SPM\n├── docs/\n│   ├── EBOOK_TECNOLOGIAS_FINTELLI.md # E-book técnico completo\n│   ├── SPM_USER_GUIDE.md             # Guia do usuário SPM\n│   ├── TESTING_GUIDE.md              # Guia de testes\n│   ├── SECURITY_RECOMMENDATIONS.md   # Recomendações de segurança\n│   └── IMPLEMENTACAO_COMPLETA_RESUMO.md\n├── scripts/\n│   ├── generate_secrets.sh           # Geração de credenciais\n│   ├── security_check.sh             # Verificação de segurança\n│   └── validate_spm.sh               # Validação do stack SPM\n├── tests/\n│   ├── backend/                      # Testes Python/FastAPI\n│   ├── frontend/                     # Testes React/TypeScript\n│   └── integration/                  # Testes de integração\n├── .env\n├── .env.example\n├── CHANGELOG.md\n└── docker-compose.yml\n```\n\n## 🛠️ Pré-requisitos\n\n- **Docker**\n- **Docker Compose**\n\n## 🚀 Como Configurar e Executar\n\n### 1. Crie os arquivos e diretórios\nGaranta que a estrutura de diretórios e todos os arquivos abaixo estejam criados.\n\n### 2. Crie e configure o arquivo `.env`\nNa raiz do projeto, crie o arquivo `.env` com suas credenciais ou use o script de geração automática:\n\n```bash\n# Gerar credenciais seguras automaticamente\n./scripts/generate_secrets.sh\n\n# OU criar manualmente\n# Credenciais do Banco de Dados Postgres\nPOSTGRES_DB=finance_db\nPOSTGRES_USER=finance_user\nPOSTGRES_PASSWORD=your_strong_password\n\n# Chave da API do Gemini (Google AI) - OBRIGATÓRIO\nGEMINI_API_KEY=\"SUA_CHAVE_API_AQUI\"\n```\n\n### 3. Construa e inicie os contêineres\nNo terminal, na raiz do projeto, execute:\n\n```bash\ndocker-compose up --build\n```\n\n### 4. Acesse os Serviços\n\n| Serviço                   | URL                    | Descrição                       |\n| ------------------------- | ---------------------- | ------------------------------- |\n| **Aplicação de Finanças** | http://localhost:8080  | Interface principal             |\n| **Backend API**           | http://localhost:8001  | API FastAPI + Documentação      |\n| **Jaeger (Traces)**       | http://localhost:16686 | Visualização de traces + SPM    |\n| **Prometheus (Métricas)** | http://localhost:9090  | Coleta de métricas              |\n| **Grafana (Dashboards)**  | http://localhost:3000  | Dashboards (login: admin/admin) |\n| **Alertmanager**          | http://localhost:9093  | Gestão de alertas               |\n\n## 📊 Como Usar a Observabilidade\n\n### 1. Use a aplicação\nAdicione e remova algumas transações para gerar dados.\n\n### 2. Visualize Traces no Jaeger\n\n1. Abra o **Jaeger**\n2. No menu \"Service\", selecione `finance-backend` ou `finance-frontend`\n3. Clique em \"Find Traces\"\n4. Você verá as requisições, desde o clique no navegador até a consulta no banco de dados\n\n### 3. Explore Métricas no Grafana\n\n1. Abra o **Grafana** e faça login\n2. Vá em \"Connections\" \u003e \"Data sources\" e adicione o Prometheus (URL: `http://prometheus:9090`)\n3. Vá em \"Dashboards\" \u003e \"New dashboard\" para criar painéis com as métricas disponíveis\n   - Exemplos: `http_server_duration_seconds`, `transactions_created_total`\n\n## 🎯 Service Performance Monitoring (SPM)\n\nO Fintelli possui **Service Performance Monitoring (SPM)** avançado habilitado no Jaeger 1.51, que deriva automaticamente métricas de performance dos traces distribuídos coletados pelo OpenTelemetry.\n\n### 🚀 Benefícios do SPM\n\n- **📊 Métricas Automáticas**: Rate, Errors, Duration (RED) geradas dos traces\n- **🔍 Visibilidade Completa**: Performance por endpoint, método HTTP e status\n- **⚡ Alertas Inteligentes**: 55+ regras de alerta categorizadas\n- **🎨 Dashboards Ricos**: Visualizações automáticas no Grafana\n- **🛡️ SLA Monitoring**: Monitoramento contínuo de disponibilidade e latência\n- **🔧 Detecção de Anomalias**: Identificação proativa de degradação\n\n### 📈 Métricas SPM Disponíveis\n\n```promql\n# Taxa de requisições por segundo\nrate(calls_total{service_name=\"fintelli-backend\"}[5m])\n\n# Latência P95\nhistogram_quantile(0.95, rate(duration_bucket{service_name=\"fintelli-backend\"}[5m]))\n\n# Taxa de erro\nrate(calls_total{status_code=~\"5..\"}[5m]) / rate(calls_total[5m])\n\n# Disponibilidade do serviço\n(1 - rate(calls_total{status_code=~\"5..\"}[5m]) / rate(calls_total[5m])) * 100\n```\n\n### 🎛️ Como Usar o SPM\n\n1. **Acesse o Jaeger**: http://localhost:16686\n2. **Vá para \"Monitor\"**: Seção Service Performance Monitoring\n3. **Explore Métricas**: Visualize latência, throughput e erros por serviço\n4. **Configure Alertas**: Use as regras em `config/spm-alerts.yml`\n5. **Dashboard Grafana**: Importe `config/grafana-spm-dashboard.json`\n\n### 📚 Documentação Completa\n\n- **[Guia do Usuário SPM](docs/SPM_USER_GUIDE.md)** - Tutorial completo\n- **[E-book Tecnologias](docs/EBOOK_TECNOLOGIAS_FINTELLI.md)** - Documentação técnica\n- **[Resumo da Implementação](docs/IMPLEMENTACAO_SPM_RESUMO.md)** - Visão executiva\n\n### 🔧 Validação do SPM\n\n```bash\n# Validar stack completo incluindo SPM\n./scripts/validate_spm.sh\n\n# Verificar coleta de métricas SPM\ncurl \"http://localhost:9090/api/v1/query?query=calls_total\"\n\n# Gerar traces para teste\ncurl -X POST http://localhost:8001/transactions/ \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"amount\": 100.0, \"description\": \"Test SPM\"}'\n```\n\n## 🛠️ Tecnologias Utilizadas\n\n### 🎯 **FRONTEND**\n#### **Framework \u0026 Biblioteca Principal**\n- ![React](https://img.shields.io/badge/React-18.2.0-61dafb?logo=react\u0026logoColor=white) - Biblioteca para interfaces de usuário\n- ![TypeScript](https://img.shields.io/badge/TypeScript-5.2.2-3178c6?logo=typescript\u0026logoColor=white) - Superset do JavaScript com tipagem estática\n- ![Vite](https://img.shields.io/badge/Vite-6.3.5-646cff?logo=vite\u0026logoColor=white) - Build tool e bundler moderno\n\n#### **UI \u0026 Estilização**\n- ![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.3.5-06b6d4?logo=tailwindcss\u0026logoColor=white) - Framework CSS utility-first\n- ![PostCSS](https://img.shields.io/badge/PostCSS-8.4.31-dd3a0a?logo=postcss\u0026logoColor=white) - Processador CSS\n- ![React Icons](https://img.shields.io/badge/React_Icons-5.5.0-e91e63?logo=react\u0026logoColor=white) - Biblioteca de ícones\n\n#### **Gráficos \u0026 HTTP**\n- ![Chart.js](https://img.shields.io/badge/Chart.js-4.4.0-ff6384?logo=chartdotjs\u0026logoColor=white) - Biblioteca de gráficos\n- ![Axios](https://img.shields.io/badge/Axios-1.6.0-5a29e4?logo=axios\u0026logoColor=white) - Cliente HTTP para chamadas de API\n\n### 🔧 **BACKEND**\n#### **Framework \u0026 Runtime**\n- ![FastAPI](https://img.shields.io/badge/FastAPI-latest-009688?logo=fastapi\u0026logoColor=white) - Framework web moderno para Python\n- ![Python](https://img.shields.io/badge/Python-latest-3776ab?logo=python\u0026logoColor=white) - Linguagem de programação principal\n- ![Uvicorn](https://img.shields.io/badge/Uvicorn-standard-499848?logo=uvicorn\u0026logoColor=white) - Servidor ASGI de alta performance\n\n#### **Banco de Dados \u0026 Cache**\n- ![PostgreSQL](https://img.shields.io/badge/PostgreSQL-14-336791?logo=postgresql\u0026logoColor=white) - Banco de dados relacional\n- ![Redis](https://img.shields.io/badge/Redis-7-dc382d?logo=redis\u0026logoColor=white) - Cache em memória e broker de mensagens\n\n#### **Inteligência Artificial**\n- ![Google AI](https://img.shields.io/badge/Google_Gemini-AI-4285f4?logo=google\u0026logoColor=white) - API do Gemini para análise de documentos\n\n### 📊 **OBSERVABILIDADE \u0026 MONITORAMENTO**\n#### **OpenTelemetry Stack**\n- ![OpenTelemetry](https://img.shields.io/badge/OpenTelemetry-latest-425cc7?logo=opentelemetry\u0026logoColor=white) - Observabilidade unificada\n- ![Jaeger](https://img.shields.io/badge/Jaeger-1.51-66d9ef?logo=jaeger\u0026logoColor=white) - Distributed tracing + SPM\n- ![Prometheus](https://img.shields.io/badge/Prometheus-v2.45-e6522c?logo=prometheus\u0026logoColor=white) - Coleta de métricas\n- ![Grafana](https://img.shields.io/badge/Grafana-10.0-f46800?logo=grafana\u0026logoColor=white) - Dashboards e visualizações\n- ![Alertmanager](https://img.shields.io/badge/Alertmanager-0.25-e6522c?logo=prometheus\u0026logoColor=white) - Gestão de alertas\n\n### 🐳 **CONTAINERIZAÇÃO \u0026 DEPLOY**\n- ![Docker](https://img.shields.io/badge/Docker-latest-2496ed?logo=docker\u0026logoColor=white) - Containerização de aplicações\n- ![Docker Compose](https://img.shields.io/badge/Docker_Compose-latest-2496ed?logo=docker\u0026logoColor=white) - Orquestração de múltiplos containers\n- ![Nginx](https://img.shields.io/badge/Nginx-1.21.3-009639?logo=nginx\u0026logoColor=white) - Servidor web e proxy reverso\n\n### ☸️ **KUBERNETES (OPCIONAL)**\n- ![Kubernetes](https://img.shields.io/badge/Kubernetes-latest-326ce5?logo=kubernetes\u0026logoColor=white) - Orquestração de containers\n- ![Helm](https://img.shields.io/badge/Helm-latest-0f1689?logo=helm\u0026logoColor=white) - Gerenciador de pacotes Kubernetes\n\n### 🔐 **SEGURANÇA \u0026 CONFIGURAÇÃO**\n- ![Environment Variables](https://img.shields.io/badge/Environment_Variables-Security-green) - Configuração segura\n- ![CORS](https://img.shields.io/badge/CORS-Enabled-blue) - Cross-Origin Resource Sharing\n\n---\n\n### 📊 **RESUMO POR CATEGORIA:**\n\n| **Categoria**         | **Tecnologias Principais**                        |\n| --------------------- | ------------------------------------------------- |\n| **🎨 Frontend**        | React + TypeScript + Tailwind + Vite              |\n| **⚙️ Backend**         | FastAPI + Python + PostgreSQL + Redis             |\n| **🤖 IA**              | Google Gemini AI                                  |\n| **📊 Observabilidade** | OpenTelemetry + Jaeger SPM + Prometheus + Grafana |\n| **🚨 Alertas**         | Alertmanager + 55+ regras de alerta               |\n| **🐳 Containerização** | Docker + Docker Compose + Nginx                   |\n| **☸️ Deploy**          | Kubernetes + Helm (opcional)                      |\n| **🔒 Segurança**       | Scripts de validação + Credenciais seguras        |\n\n**Total: 35+ tecnologias** integradas em uma aplicação completa de fintech! 🚀\n\n---\n\n## 🧪 Testes e Validações\n\nO Fintelli possui uma suíte completa de testes automatizados que garante a qualidade e confiabilidade do sistema.\n\n### 🚀 Execução Rápida de Todos os Testes\n\n```bash\n# Executar TODOS os testes (frontend + backend + integração)\n./run_all_tests.sh\n\n# Execução rápida (para no primeiro erro)\n./run_all_tests.sh --quick\n\n# Apenas testes específicos\n./run_all_tests.sh --skip-frontend    # Apenas backend e integração\n./run_all_tests.sh --skip-backend     # Apenas frontend e integração\n./run_all_tests.sh --skip-integration # Apenas unit tests\n```\n\n### 📋 Tipos de Testes Disponíveis\n\n#### 🎨 **Testes de Frontend**\n```bash\ncd tests/frontend\nnpm install\nnpm test                # Todos os testes\nnpm run test:coverage   # Com relatório de coverage\nnpm run test:e2e        # Testes end-to-end (Cypress)\n```\n\n**Cobertura**: Componentes React, utilitários JavaScript, integração com APIs\n\n#### ⚙️ **Testes de Backend**\n```bash\ncd tests/backend\npip install -r requirements.txt\npytest                  # Todos os testes\npytest --cov=app        # Com coverage\npytest test_api.py      # Testes específicos\n```\n\n**Cobertura**: APIs FastAPI, PostgreSQL, Redis, Prometheus, Jaeger, OpenTelemetry\n\n#### 🔗 **Testes de Integração**\n```bash\n./tests/integration/run_tests.sh\n```\n\n**Cobertura**: Docker Compose, networking, endpoints, observabilidade, logs\n\n### 📊 Validações por Componente\n\n| Componente         | Comando                                                          | URL de Verificação         |\n| ------------------ | ---------------------------------------------------------------- | -------------------------- |\n| **Frontend**       | `curl http://localhost:8080`                                     | http://localhost:8080      |\n| **Backend API**    | `curl http://localhost:8001/health`                              | http://localhost:8001/docs |\n| **PostgreSQL**     | `docker exec -it fintelli_db psql -U finance_user -d finance_db` | -                          |\n| **Redis**          | `docker exec -it fintelli_cache redis-cli`                       | -                          |\n| **Prometheus**     | `curl http://localhost:9090/api/v1/query?query=up`               | http://localhost:9090      |\n| **Jaeger**         | `curl http://localhost:16686/api/services`                       | http://localhost:16686     |\n| **Grafana**        | `curl http://localhost:3000`                                     | http://localhost:3000      |\n| **Alertmanager**   | `curl http://localhost:9093/api/v1/status`                       | http://localhost:9093      |\n| **OTel Collector** | `curl http://localhost:8889/metrics`                             | -                          |\n\n### 🛡️ Validação de Segurança\n\n```bash\n# Verificar configurações de segurança\n./scripts/security_check.sh\n\n# Validar credenciais e ambiente\n./scripts/validate_spm.sh\n\n# Gerar novas credenciais seguras\n./scripts/generate_secrets.sh\n```\n\n### 📖 Documentação Completa\n\n- **[CHANGELOG](CHANGELOG.md)** - Histórico completo da versão 1.0.0\n- **[Guia de Testes](tests/README.md)** - Documentação detalhada de todos os testes\n- **[E-book Completo](docs/EBOOK_TECNOLOGIAS_FINTELLI.md)** - Guia técnico abrangente\n- **[Guia SPM](docs/SPM_USER_GUIDE.md)** - Service Performance Monitoring\n- **[Guia de Validações](docs/TESTING_GUIDE.md)** - Procedimentos de validação\n- **[Recomendações de Segurança](docs/SECURITY_RECOMMENDATIONS.md)** - Boas práticas\n- **[Resumo da Implementação](docs/IMPLEMENTACAO_COMPLETA_RESUMO.md)** - Visão executiva\n\n### 🎯 Qualidade Garantida\n\n- ✅ **Unit Tests**: Jest (Frontend) + Pytest (Backend)\n- ✅ **Integration Tests**: APIs, banco de dados, cache\n- ✅ **End-to-End Tests**: Fluxo completo da aplicação\n- ✅ **Performance Tests**: Latência e throughput\n- ✅ **Observability Tests**: Métricas e traces\n- ✅ **Docker Tests**: Containers e networking\n- ✅ **Security Tests**: Validações de segurança básicas\n- ✅ **SPM Tests**: Service Performance Monitoring\n- ✅ **Alert Tests**: Validação de regras de alerta\n\n## 📋 **Alertas e Monitoramento Avançado**\n\n### 🚨 Sistema de Alertas\n\nO Fintelli possui **55+ regras de alerta** categorizadas para monitoramento completo:\n\n#### 📊 **Categorias de Alertas**\n- **🏢 Negócio**: Volume de transações, taxas de conversão, SLA\n- **🔒 Segurança**: Tentativas de acesso, anomalias, compliance\n- **🛡️ Compliance**: Auditoria, retenção de dados, regulamentações\n- **🖥️ Infraestrutura**: CPU, memória, disco, rede, containers\n\n#### ⚙️ **Configuração de Alertas**\n\n```bash\n# Configurações de alerta\nconfig/spm-alerts.yml              # Regras SPM específicas\nconfig/fintelli-enhanced-alerts.yml # Regras avançadas de negócio\nconfig/alertmanager.yml           # Configuração do Alertmanager\n\n# Testar alertas\ncurl -X POST http://localhost:9093/api/v1/alerts\n```\n\n#### 📈 **Dashboards Inclusos**\n- **Dashboard SPM**: Métricas de performance por serviço\n- **Métricas de Sistema**: CPU, memória, rede\n- **Métricas de Negócio**: Transações, conversões\n- **Alertas Ativos**: Status e histórico de alertas\n\n## 🔒 **Segurança e Boas Práticas**\n\n### 🛡️ **Recursos de Segurança**\n\n- **🔐 Geração Automática de Credenciais**: Script `generate_secrets.sh`\n- **🔍 Auditoria de Segurança**: Script `security_check.sh`\n- **📝 Recomendações Documentadas**: `docs/SECURITY_RECOMMENDATIONS.md`\n- **🚨 Alertas de Segurança**: Monitoramento de tentativas de acesso\n- **🔄 Rotação de Credenciais**: Procedimentos documentados\n\n### 📋 **Checklist de Segurança**\n\n```bash\n# Executar auditoria completa\n./scripts/security_check.sh\n\n# Gerar credenciais seguras\n./scripts/generate_secrets.sh\n\n# Validar configurações\n./scripts/validate_spm.sh\n```\n\n---\n\n## 🎯 **Próximos Passos e Roadmap**\n\n### 🚀 **V2.0 Planejado**\n- **🤖 Machine Learning**: Detecção de anomalias com IA\n- **📱 APM Mobile**: Instrumentação React Native\n- **🔄 CI/CD Integration**: Observabilidade no pipeline\n- **🏢 Multi-tenancy**: Arquitetura SaaS\n- **📊 Advanced Analytics**: Análises preditivas\n\n### 📈 **Melhorias Contínuas**\n- **Performance**: Otimização de latência \u003c 100ms P95\n- **Escalabilidade**: Suporte a milhões de transações\n- **Compliance**: Certificações PCI-DSS, SOX\n- **Integração**: APIs de terceiros (bancos, fintechs)\n\n---\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftech-preta%2Ffintelli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftech-preta%2Ffintelli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftech-preta%2Ffintelli/lists"}