{"id":30358618,"url":"https://github.com/jpaullopes/CIP-Monitoring","last_synced_at":"2025-12-30T21:42:43.606Z","repository":{"id":310076987,"uuid":"1027199003","full_name":"jpaullopes/sensorflow-server-ethernet","owner":"jpaullopes","description":"sensorFlow Server: Backend IoT com suporte WiFi e Ethernet.","archived":false,"fork":false,"pushed_at":"2025-08-15T14:35:37.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-15T16:27:23.476Z","etag":null,"topics":["backend","docker","ethernet","fastapi","grafana","iot","postgresql","wifi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jpaullopes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-27T14:23:27.000Z","updated_at":"2025-08-15T14:35:41.000Z","dependencies_parsed_at":"2025-08-16T13:45:35.490Z","dependency_job_id":null,"html_url":"https://github.com/jpaullopes/sensorflow-server-ethernet","commit_stats":null,"previous_names":["jpaullopes/sensorflow-server-ethernet"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/jpaullopes/sensorflow-server-ethernet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpaullopes%2Fsensorflow-server-ethernet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpaullopes%2Fsensorflow-server-ethernet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpaullopes%2Fsensorflow-server-ethernet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpaullopes%2Fsensorflow-server-ethernet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jpaullopes","download_url":"https://codeload.github.com/jpaullopes/sensorflow-server-ethernet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpaullopes%2Fsensorflow-server-ethernet/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271143306,"owners_count":24706340,"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","status":"online","status_checked_at":"2025-08-19T02:00:09.176Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["backend","docker","ethernet","fastapi","grafana","iot","postgresql","wifi"],"created_at":"2025-08-19T11:01:50.991Z","updated_at":"2025-12-30T21:42:43.595Z","avatar_url":"https://github.com/jpaullopes.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SensorFlow API\n\nAPI backend para coleta de dados de processos CIP (Clean-in-Place). Recebe dados dos sensores via REST e disponibiliza.\n\n## O que faz\n\nEsta API coleta dados de **temperatura**, **concentração** e **fluxo** de processos CIP e:\n\n- Detecta automaticamente quando um processo CIP começa e termina\n- Mantém o último dado recebido em memória para consulta rápida\n- Indica se o processo está ativo ou não (campo `active`)\n- Persiste o estado em arquivo para não perder dados se o sistema cair\n- **Autenticação JWT**: Protege endpoints com tokens JWT\n- **Rate Limiting**: Limite de 20 requisições/minuto por dispositivo\n- **Validação de Payload**: 3 níveis de proteção contra buffer overflow\n- **Logging Estruturado**: Logs JSON com rastreamento de eventos\n\n## Como usar\n\n1. Sensores enviam dados via POST para `/api/sensor_data`\n2. Consulta dados via GET em `/api/sensor_data` \n3. Se `active: true` → processo CIP rodando\n4. Se `active: false` → processo terminou\n\n## Tecnologias\n\n### Backend \u0026 Framework\n- **Python**: 3.11+\n- **FastAPI**: Framework moderno e rápido com documentação automática\n- **Uvicorn**: Servidor ASGI de alta performance\n\n### Containerização \u0026 Orquestração\n- **Docker**: Containerização da aplicação\n\n\n3. **Execute com Docker Compose**\n```bash\ndocker-compose up -d\n```\n\n4. **Acesse os serviços**\n\n| Serviço    | URL                                        | Credenciais      |\n|------------|--------------------------------------------|------------------|\n| **API**    | [http://localhost:8000](http://localhost:8000) | JWT Bearer Token |\n\n\n## Segurança\n\n### Autenticação JWT\n\nTodos os endpoints de escrita (`POST`) requerem autenticação via JWT Bearer Token.\n\n**1. Obter Token (POST `/api/token`)**\n\n```bash\ncurl -X POST \"http://localhost:8000/api/token\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"device_id\": \"sensor_001\"}'\n```\n\n**Resposta:**\n```json\n{\n  \"access_token\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...\",\n  \"token_type\": \"bearer\"\n}\n```\n\n**2. Usar Token em Requisições**\n\n```bash\ncurl -X POST \"http://localhost:8000/api/sensor_data\" \\\n  -H \"Authorization: Bearer \u003caccess_token\u003e\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"temperature\": 75.5, \"concentration\": 0.8, \"flow\": 1.2}'\n```\n\n### Rate Limiting\n\n- **Limite**: 20 requisições por minuto por dispositivo\n- **Resposta ao exceder**: HTTP 429 com header `Retry-After`\n- **Rastreamento**: Por device_id extraído do token JWT\n\n### Proteção contra Buffer Overflow\n\n3 níveis de validação:\n1. **FastAPI**: Máximo 10 MB por requisição\n2. **Middleware**: Validação customizada de tamanho\n3. **Schema Pydantic**: Validação por campo (máx 1 KB)\n\n### Logging Estruturado\n\n- **Formato**: JSON estruturado com timestamp\n- **Eventos**: Autenticação, rate limit, erros de validação\n- **Proteção**: Sensores nunca são logados em produção\n- **Armazenamento**: Rotação automática de logs (100 MB)\n\n\n## API Endpoints\n\n\n### Recepção de Dados dos Sensores\n\n**POST** `/api/sensor_data`\n\nEnvia dados dos sensores CIP para o sistema. Requer autenticação JWT. O sistema gerencia automaticamente o CIP ID e detecta quando processos terminam.\n\n**Requer:** `Authorization: Bearer \u003ctoken\u003e`\n\n```bash\ncurl -X POST \"http://localhost:8000/api/sensor_data\" \\\n  -H \"Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"temperature\": 75.5,\n    \"concentration\": 0.8,\n    \"flow\": 1.2\n  }'\n```\n\n**Respostas:**\n- `201 Created`: Dados processados com sucesso\n- `401 Unauthorized`: Token ausente ou inválido\n- `429 Too Many Requests`: Limite de requisições excedido\n- `413 Payload Too Large`: Tamanho da requisição excede 10 MB\n\n### Consulta de Dados Mais Recentes\n\n**GET** `/api/sensor_data`\n\nRetorna os dados mais recentes com status do processo CIP. O campo `active` indica se o processo está em andamento.\n\n```bash\ncurl -X GET \"http://localhost:8000/api/sensor_data\"\n```\n\n**Resposta:**\n```json\n{\n  \"temperature\": 75.5,\n  \"concentration\": 0.8,\n  \"flow\": 1.2,\n  \"cip_id\": 3,\n  \"timestamp\": \"2025-10-09T15:30:00-03:00\",\n  \"active\": true\n}\n```\n\n## Funcionalidades Avançadas\n\n### Sistema Antifail\n\nO sistema mantém persistência do estado em arquivo JSON para recuperação após falhas:\n\n- **Arquivo de estado**: `data/cip_state.json`\n- **Recuperação automática**: Restaura CIP ID e status na inicialização\n\n### Detecção Automática de Processos\n\n- **Início**: Primeiro dado recebido inicia novo processo CIP\n- **Fim**: Timeout sem receber dados marca processo como finalizado\n- **Incremento automático**: CIP ID incrementa automaticamente a cada novo processo\n\n## Desenvolvimento\n\n### Executar Localmente\n\n1. **Instalar dependências**\n```bash\npip install -r requirements.txt\n```\n\n2. **Executar a aplicação**\n```bash\nuvicorn app.main:app --host 0.0.0.0 --port 8000 --reload\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpaullopes%2FCIP-Monitoring","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjpaullopes%2FCIP-Monitoring","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpaullopes%2FCIP-Monitoring/lists"}