Kappa Inspect Tool.md

Kappa Inspect Tool

Sistema Avançado de Análise de Concordância para Inspeção de Qualidade em Processos SMT

🎯 Visão Geral

Kappa Inspect Tool é uma aplicação web robusta, desenvolvida em Flask, projetada para revolucionar a gestão da qualidade em processos de manufatura de tecnologia de montagem em superfície (SMT). A plataforma permite que gestores de qualidade e engenheiros de processo meçam, analisem e melhorem a consistência das inspeções visuais realizadas por diferentes inspetores, utilizando o coeficiente de concordância Kappa de Cohen.

O sistema oferece uma solução completa para a indústria eletrônica, abordando desde a coleta de dados de inspeção dupla até a geração de dashboards interativos, relatórios detalhados e alertas automatizados de qualidade. Com uma arquitetura modular e escalável, o KappaInspect SMT é uma ferramenta indispensável para empresas que buscam a excelência operacional e a redução de custos associados a falhas de qualidade.

✨ Funcionalidades Principais

• 📊 Cálculo de Concordância Kappa: Medição precisa da concordância entre inspetores, corrigida para o acaso, com cálculo de intervalos de confiança.
• 📈 Dashboards Interativos: Visualização de dados em tempo real com gráficos de tendência, matrizes de confusão e análise por linha, produto e tipo de defeito.
• ⚙️ Gestão de Configurações: Cadastro e gerenciamento de linhas de produção, produtos (PCBs) e tipos de defeitos específicos do processo SMT.
• 👥 Controle de Acesso por Perfil: Sistema de autenticação com três níveis de acesso (Administrador, Gerente, Inspetor), garantindo a segurança e a integridade dos dados.
• 📥 Importação e Exportação de Dados: Facilidade para importar grandes volumes de dados de inspeção via arquivos CSV e exportar relatórios e análises.
• 🔔 Alertas de Qualidade Automatizados: Sistema proativo que notifica os gestores quando os níveis de concordância caem abaixo de limiares pré-definidos.
• 🤖 Previsão de Tendências (IA): Módulo de inteligência artificial que analisa dados históricos para prever futuras tendências de concordância, permitindo ações preventivas.
• 📄 Geração de Relatórios em PDF: Criação de relatórios profissionais e personalizados para auditorias e reuniões gerenciais.

🛠️ Arquitetura e Tecnologias

O Kappa Inspect Tool é construído sobre uma stack de tecnologias modernas e confiáveis, garantindo performance, escalabilidade e manutenibilidade.

Camada	Tecnologia	Descrição
Backend	/	Framework principal para a construção da API RESTful e renderização de templates.
Banco de Dados	/	Banco de dados relacional para persistência dos dados, com ORM SQLAlchemy para mapeamento objeto-relacional.
Frontend	/ /	Renderização de páginas dinâmicas com Jinja2.
Bibliotecas	/	Componentes de UI responsivos e gráficos interativos.
Análise de Dados	/	Bibliotecas para cálculos estatísticos e implementação dos modelos de IA.
Relatórios		Geração de documentos PDF dinâmicos.

Estrutura do Projeto

KappaInspect/
├── app.py                # Ponto de entrada da aplicação Flask
├── database.py           # Configuração da conexão com o banco de dados
├── models.py             # Definição dos modelos de dados (SQLAlchemy)
├── repository.py         # Camada de acesso aos dados
├── calculations.py       # Lógica para o cálculo do Kappa
├── routes.py             # Rotas da aplicação web (interface)
├── api_routes.py         # Rotas da API RESTful
├── data_seeder.py        # Script para popular o banco com dados iniciais
├── quality_alerts.py     # Lógica para monitoramento e envio de alertas
├── ai_predictions.py     # Módulo de previsão com IA
├── static/               # Arquivos estáticos (CSS, JS, Imagens)
└── templates/            # Templates HTML (Jinja2)

🚀 Guia de Instalação e Execução

Siga os passos abaixo para configurar e executar o ambiente de desenvolvimento localmente.

Pré-requisitos

• Python 3.11 ou superior
• PostgreSQL 15 ou superior
• Git

1. Clonar o Repositório

git clone https://github.com/seu-usuario/KappaInspect.git
cd KappaInspect

2. Configurar o Ambiente Virtual

python -m venv .venv
source .venv/bin/activate  # No Windows: .venv\Scripts\activate

3. Instalar as Dependências

O projeto utiliza o uv para gerenciamento de pacotes. As dependências estão listadas no arquivo pyproject.toml.

pip install uv
uv pip install -r pyproject.toml

4. Configurar o Banco de Dados

Crie um banco de dados no PostgreSQL e configure a variável de ambiente DATABASE_URL.

export DATABASE_URL="postgresql://user:password@host:port/database_name"
export SESSION_SECRET="sua-chave-secreta-aqui"

5. Executar a Aplicação

Com o ambiente configurado, execute a aplicação Flask.

flask run

A aplicação estará disponível em http://127.0.0.1:5000.

🐳 Execução com Docker (Alternativa)

Para facilitar a execução, você pode utilizar o Docker e o Docker Compose.

docker-compose up --build

🧪 Testes

O projeto inclui uma suíte de testes para garantir a qualidade e a estabilidade do código. Para executar os testes:

pytest

🤝 Como Contribuir

Contribuições são muito bem-vindas! Se você deseja melhorar o Kappa Inspect Tool, siga os passos:

1. Faça um Fork do projeto.
2. Crie uma Branch para sua funcionalidade (git checkout -b feature/nova-funcionalidade).
3. Faça o Commit de suas alterações (git commit -m 'Adiciona nova funcionalidade').
4. Faça o Push para a sua branch (git push origin feature/nova-funcionalidade).
5. Abra um Pull Request.

📄 Licença

Este projeto está licenciado sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.

---

Desenvolvido com ❤️ pela equipe QSM MAO BRASIL.