🧬 GenoTrack - Genomic & Phenotypic Data Validation System

GenoTrack é um sistema teste para controle, validação e visualização de dados genéticos e fenotípicos de pacientes, voltado para estudos de genômica.

Funcionalidades Principais

• Registro Seguro: Captura de dados genômicos e fenotípicos com múltiplas validações automáticas.
• Consulta Eficiente: Busca por gene, ID e fenótipo com navegação intuitiva.
• Validação HPO: Compatível com a Human Phenotype Ontology (HPO).
• Integração Genótipo-Fenótipo: Checagem cruzada de genes, cromossomos e fenótipos.
• Testes Automatizados: Cobertura de testes ≥80% com validação em tempo real.

Caso de Uso Destacado

Paciente: BR-PACIENTE-0321
Pesquisadora: Ana Silva
Gene: LDLR (localizado no cromossomo 19)
Fenótipo: HP:0003124 (hipercolesterolemia familiar)
Fluxo Validado:
Cadastro → Validação de Código → Gene ↔ Cromossomo ↔ Fenótipo → Visualização

Stack Tecnológica

Backend

Ruby on Rails – API REST
RSpec – Testes unitários
PostgreSQL – Banco de dados

Frontend

HTML5 / CSS3 / JavaScript – Interface responsiva
Cypress – Testes ponta a ponta (E2E)

Qualidade e Testes

Postman/Newman – Testes de API
Robot Framework – Testes BDD
SimpleCov – Cobertura de código

Execução Rápida

# Backend
cd backend && bundle install && rails server

# Frontend
cd frontend && npm install && npm start

# Testes
bundle exec rspec                    # Testes unitários
npm run cypress:run                  # Testes E2E
robot tests/robot/                   # Testes BDD

Validações Implementadas

• Código HPO com formato HP:000XXXX
• Paciente deve ter ao menos um gene e um fenótipo
• Consistência gene ↔ cromossomo
• Prevenção de duplicidade de fenótipos
• Várias regras de tipagem e integridade relacional

Cobertura e Métricas de Teste

• Testes BDD – Robot Framework
• Testes de API – Newman/Postman
• Testes End-to-End – Cypress
• Testes Unitários – RSpec

Testes RSpec

Testes API NewmanPostman

Testes BDD Robot Framework

Testes E2E Cypress

Métricas de Qualidade

• Cobertura de código: ≥ 80%
• Resposta média da API: < 200ms
• Testes automatizados e rastreáveis
• Interface com validações em tempo real