Skip to content

agourakis82/darwin-MFC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

231 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Darwin-MFC

Interactive Global Guide for Family and Community Medicine / Guia Interativo Global para Medicina de Família e Comunidade

Comparative analysis of population screening guidelines with Q1 academic rigor, multilingual (9 languages), and health-system-specific adaptation.

Análise comparativa de diretrizes de rastreamento populacional com rigor acadêmico Q1, multilíngue (9 idiomas) e adaptação específica por sistema de saúde.

Next.js TypeScript License Version DOI


🌍 Vision / Visão

Open tool to strengthen primary care worldwide, comparing official guidelines (SUS, USPSTF, NHS, NP-NCD India, WHO) with localized critical analysis.

Ferramenta aberta para fortalecer a atenção primária mundialmente, comparando diretrizes oficiais (SUS, USPSTF, NHS, NP-NCD Índia, OMS) com análise crítica localizada.


✨ Key Features / Funcionalidades Principais

  • Dual View: Descriptive vs. Critical Analysis / Visão Dual: Descritivo vs. Análise Crítica
  • Visual traffic-light comparisons / Comparações visuais semafóricas
  • Integrated clinical calculators / Calculadoras clínicas integradas
  • Interactive genogram/ecomap / Genograma/ecomapa interativos
  • Academic export (PDF, BibTeX, CSV) / Exportação acadêmica (PDF, BibTeX, CSV)
  • 9 languages: Portuguese, English, Spanish, French, Russian, Arabic, Chinese, Greek, Hindi / 9 idiomas: Português, Inglês, Espanhol, Francês, Russo, Árabe, Chinês, Grego, Hindi
  • Offline-ready (future PWA) / Pronto para offline (PWA futuro)

🚀 Live Demo / Demonstração ao Vivo

🌐 https://mfc.agourakis.med.br


📊 Graphical Abstracts / Abstracts Gráficos

Graphical abstracts for core modules are available in public/graphical-abstracts/:

Os abstracts gráficos para os módulos principais estão disponíveis em public/graphical-abstracts/:

  1. Breast Cancer Screening Global Comparison / Comparação Global de Rastreamento de Câncer de Mama
  2. Cervical Cancer Screening / Rastreamento de Câncer de Colo do Útero
  3. Oral Cancer Screening (India priority) / Rastreamento de Câncer Oral (prioridade Índia)
  4. Hypertension Management in Primary Care / Manejo de Hipertensão na Atenção Primária
  5. Interactive Genogram/Ecomap / Genograma/Ecomapa Interativo
  6. Platform Overview / Visão Geral da Plataforma

🛠 Installation / Instalação

Prerequisites / Pré-requisitos

  • Node.js 18+ (recommended 20+) / Node.js 18+ (recomendado 20+)
  • npm, yarn or pnpm / npm, yarn ou pnpm

Steps / Passos

# 1. Clone the repository / Clone o repositório
git clone https://github.com/agourakis82/darwin-mfc.git
cd darwin-mfc

# 2. Install dependencies / Instale as dependências
npm install

# 3. Run in development mode / Execute em modo de desenvolvimento
npm run dev

# 4. Access in browser / Acesse no navegador
# http://localhost:3000

Available Scripts / Scripts Disponíveis

  • npm run dev - Development server (port 3000) / Servidor de desenvolvimento (porta 3000)
  • npm run build - Production build / Build de produção
  • npm run start - Production server / Servidor de produção
  • npm run lint - Static analysis (ESLint) / Análise estática (ESLint)

📚 How to Cite / Como Citar

This project uses FORCE11-compliant citation metadata. Use the CITATION.cff file in the repository root.

Este projeto usa metadados de citação compatíveis com FORCE11. Use o arquivo CITATION.cff na raiz do repositório.

Quick Citation / Citação Rápida

Agourakis, D. C. (2025). Darwin-MFC: Interactive Global Guide for Family and Community Medicine Screening Guidelines (Version 0.7.0) [Software]. Zenodo. https://doi.org/10.5281/zenodo.17987610

DOI: 10.5281/zenodo.17987610


🤝 Contributing / Contribuindo

This project is part of the Darwin Medical Foundation Cluster (Darwin-MFC) platform and is under active development. Contributions are welcome!

Este projeto faz parte da plataforma Darwin Medical Foundation Cluster (Darwin-MFC) e está sob desenvolvimento ativo. Contribuições são bem-vindas!

  1. Fork the repository / Faça fork do repositório
  2. Create a branch / Crie uma branch (git checkout -b feature/nova-funcionalidade)
  3. Commit your changes / Faça commit das suas mudanças (git commit -m 'Adiciona nova funcionalidade')
  4. Push to the branch / Faça push para a branch (git push origin feature/nova-funcionalidade)
  5. Open a Pull Request / Abra um Pull Request

📄 License / Licença

  • Code: MIT License / Código: Licença MIT
  • Clinical Content: CC-BY-4.0 / Conteúdo Clínico: CC-BY-4.0

See LICENSE and CONTENT_LICENSE files for details.

Veja os arquivos LICENSE e CONTENT_LICENSE para detalhes.


👨‍⚕️ Authors / Autores

Demetrios Chiuratto Agourakis, MD

Physician and Resident in Family and Community Medicine (PUC-SP, Brazil). Interdisciplinary researcher focused on computational psychiatry, open science infrastructure, and primary care tools.

Médico e Residente em Medicina de Família e Comunidade (PUC-SP, Brasil). Pesquisador interdisciplinar focado em psiquiatria computacional, infraestrutura de ciência aberta e ferramentas de atenção primária.

Isadora Casagrande Amalcaburio

Medical Student (Final Year), Faculdade São Leopoldo Mandic, Brazil.

Estudante de Medicina (Último Ano), Faculdade São Leopoldo Mandic, Brasil.


📧 Contact / Contato

For questions, suggestions, or collaborations / Para dúvidas, sugestões ou colaborações:


🎯 Project Goals / Objetivos do Projeto

  1. Complete Descriptive Content / Conteúdo Descritivo Completo: Protocols, target populations, periodicity, diagnostic methods / Protocolos, populações-alvo, periodicidade, métodos diagnósticos
  2. Systemic Critical Analysis / Análise Crítica Sistêmica: Second and third-order insights, controversies, operational challenges / Insights de segunda e terceira ordem, controvérsias, desafios operacionais
  3. Academic Reference System / Sistema de Referências Acadêmico: Inline Vancouver citations, tooltips, completeness validation / Citações inline Vancouver, tooltips, validação de completude
  4. Interactive Comparisons / Comparações Interativas: Side-by-side comparisons with convergence status / Comparações lado a lado com status de convergência
  5. Analytical Visualizations / Visualizações Analíticas: Coverage charts, convergence charts, temporal evolution / Gráficos de cobertura, convergência, evolução temporal
  6. Advanced Search / Busca Avançada: Fuzzy search + filters by category, convergence, year / Busca fuzzy + filtros por categoria, convergência, ano

🚀 Technologies / Tecnologias

  • Next.js 15 + React 19 + TypeScript 5
  • Tailwind CSS 4 - Responsive academic design system / Design system acadêmico responsivo
  • Zustand - Global state management / Gerenciamento de estado global
  • Recharts - Charts and data visualizations / Gráficos e visualizações de dados
  • Fuse.js - Intelligent fuzzy search / Busca fuzzy inteligente
  • Lucide Icons - Modern iconography / Iconografia moderna

📈 Roadmap

Version 0.7.0 (Current) / Versão 0.7.0 (Atual)

  • Complete Hindi (hi) locale support / Suporte completo ao locale Hindi (hi)
  • NP-NCD 2023-2030 Indian guidelines integration / Integração de diretrizes indianas NP-NCD 2023-2030
  • FORCE11-compliant CITATION.cff / CITATION.cff compatível com FORCE11
  • Professional bilingual README / README bilíngue profissional
  • About the Author page / Página Sobre o Autor
  • Graphical abstracts (6 modules) / Abstracts gráficos (6 módulos)

Version 1.0 (Next) / Versão 1.0 (Próximo)

  • Complete all 16 screenings / Completar todos os 16 rastreamentos
  • Expand critical analyses / Expandir análises críticas
  • Full PDF export implementation / Implementação completa de exportação PDF
  • Functional clinical calculators / Calculadoras clínicas funcionais
  • Favorites system with localStorage / Sistema de favoritos com localStorage

Version 2.0 (Future) / Versão 2.0 (Futuro)

  • Backend API (Next.js API routes) / API Backend (rotas API Next.js)
  • User authentication / Autenticação de usuários
  • Collaborative notes / Notas colaborativas
  • Zotero/Mendeley integration / Integração com Zotero/Mendeley
  • PWA (Progressive Web App) / PWA (Aplicativo Web Progressivo)
  • Offline mode / Modo offline

Last Update / Última Atualização: February 2026 / Fevereiro 2026 Version / Versão: 1.7.1