🌱 SeedIQ — Painel + API Central

Plataforma web de gestão e API central do ecossistema SeedIQ. Orquestra a comunicação entre o app mobile, o serviço de classificação por visão computacional e o painel administrativo.

---

📸 Preview

Dashboard	Lista de Classificações

Lista de Categorias	Perfil do Usuário

Resultado da Análise

---

📌 Sobre o projeto

O SeedIQ é um projeto acadêmico desenvolvido no último semestre do curso de Sistemas de Informação (2025.2), integrando três disciplinas: Programação para Dispositivos Móveis, Segurança e Auditoria de Sistemas e Computação Gráfica e Processamento de Imagens.

Este repositório contém o Painel Administrativo (React + Inertia.js) e a API Central (Laravel), responsáveis por orquestrar todo o ecossistema:

• Receber imagens enviadas pelo app mobile
• Enfileirar jobs para o serviço de classificação via webhook
• Persistir e servir os resultados
• Prover gestão de usuários, permissões e auditoria

O ecossistema completo é dividido em três repositórios:

Parte	Repositório	Descrição
🖥️ Painel + API Central	este repositório	Gestão, dashboard e orquestração
🔬 API de Classificação	SeedIQ-AI	Visão computacional com Python + OpenCV
📱 App Mobile	seediq_app	App Flutter para operadores em campo

---

⚙️ Tecnologias

• Backend: PHP 8.x, Laravel
• Frontend: React + Inertia.js, Vite
• Banco de dados: MySQL / PostgreSQL
• Orquestração: Docker + Docker Compose (Laravel Sail)
• Armazenamento: Supabase / S3

---

🔒 Segurança

O projeto segue práticas de Secure SDLC com:

• Controle de acesso baseado em papéis (RBAC) — Operador, Administrador e Suporte
• Modelagem de ameaças com STRIDE
• Conformidade com a LGPD
• Rate limiting nos endpoints
• Validação de tipo MIME em uploads
• Bcrypt para senhas
• Trilhas de auditoria completas com registro de IP, evento e timestamp

---

🔁 Fluxo de funcionamento

┌─────────────┐        ┌─────────────────┐        ┌──────────────────────┐
│  App Mobile │───────▶│   API Central   │───────▶│  API Classificação   │
│  (Flutter)  │        │    (Laravel)    │        │  (Python + OpenCV)   │
└─────────────┘        └────────┬────────┘        └──────────┬───────────┘
                                │         ◀─ webhook ────────┘
                                │
                       ┌────────▼────────┐
                       │     Painel      │
                       │  Administrativo │
                       │  (React+Inertia)│
                       └─────────────────┘

1. Operador captura foto no app e envia para a API Central
2. API Central persiste os metadados e enfileira o job para o serviço de classificação
3. Serviço de classificação processa a imagem e retorna o resultado via webhook
4. API Central grava o resultado e disponibiliza para o painel e o app
5. Painel exibe resultados, estatísticas e permite reanálises

---

🚀 Rodando localmente

Pré-requisitos: Docker e Docker Compose

# 1. Clonar o repositório
git clone https://github.com/CyberNomads404/SeedIQ.git
cd SeedIQ

# 2. Executar o script de setup
./dev-setup.sh

# 3. Subir os containers
./vendor/bin/sail up -d

# 4. Instalar dependências PHP
./vendor/bin/sail composer install

# 5. Rodar migrations e seeders
./vendor/bin/sail artisan migrate --seed

# 6. Instalar dependências JS e rodar o frontend
./vendor/bin/sail npm install --prefix resources
./vendor/bin/sail npm run dev --prefix resources

Acesse em: http://localhost

---

📖 Documentação da API

A documentação completa dos endpoints está disponível no Postman:

👉 Acessar documentação

---

👥 Equipe

Desenvolvido pela equipe CyberNomads404 como Projeto Integrador do curso de Sistemas de Informação — 2025.2

• @Erikli999 – Erikli999
• @piedro404 – Pedro Henrique Martins Borges
• @thayna-bezerra – Thayna Bezerra

---

📬 Contato

pedro.henrique.martins404@gmail.com