# Project Roadmap

## Mental Health Specialists in Iberoamerica — Development Roadmap

**Repository:** juanmoisesd/mental-health-specialists-iberoamerica  
**Last Updated:** May 2026

---

## Vision

Transform from a descriptive open dataset into a **comprehensive scientific observatory** for mental health workforce policy in Ibero-America — comparable to IHME, WHO Observatory, or PAHO PLISA in analytical depth.

---

## Completed ✅

### Phase 1: Foundation (2025 Q1)
- [x] Core dataset: specialist density for 22 countries (2000–2026)
- [x] FAIR compliance: schema.json, datapackage.json, CITATION.cff, PROVENANCE.md
- [x] Interactive dashboard (GitHub Pages)
- [x] Zenodo archival (DOI: 10.5281/zenodo.18984813)
- [x] Country-level HTML mini-papers (22 countries)
- [x] Hugging Face dataset card

### Phase 2: Scientific Depth (2025 Q2–2026 Q2)
- [x] Central CSV dataset (`data/specialists_data.csv`)
- [x] Socioeconomic overlay (`data/external_indicators.csv`)
- [x] Workforce Gap Index (WGI) calculation
- [x] Advanced analysis notebook (`notebooks/02_advanced_analysis.ipynb`)
- [x] Executive Summary Dashboard (`executive_summary.html`)
- [x] Policy Brief (`POLICY_BRIEF.md`)
- [x] Methodology document (`METHODOLOGY.md`)
- [x] Data Sources inventory (`DATA_SOURCES.md`)
- [x] Multilingual support (EN/ES/PT)
- [x] Choropleth map (Leaflet.js)
- [x] Policy impact simulator
- [x] OECD benchmarking radar charts

---

## In Progress 🔄

### Phase 3: Analytical Observatory (2026 Q3–Q4)
- [ ] **Predictive dashboard**: 2030–2035 forecasting visualization
- [ ] **Sub-national data**: State/province level for Mexico, Brazil, Argentina
- [ ] **Burden overlay**: DALYs vs workforce availability heatmap
- [ ] **API endpoint**: Programmatic access to dataset (REST API)
- [ ] **Python SDK**: `pip install mental-health-iberoamerica`
- [ ] **R package**: CRAN submission planned Q4 2026

---

## Planned 📋

### Phase 4: Policy Integration (2027)
- [ ] **Policy simulation engine**: Model impact of investment scenarios
- [ ] **COVID-19 impact module**: Pre/post pandemic workforce analysis
- [ ] **Migration analysis**: "Brain drain" quantification
- [ ] **Preprint publication**: medRxiv/SSRN working paper
- [ ] **PAHO collaboration**: Integration with PLISA platform
- [ ] **Machine learning models**: Demand forecasting with socioeconomic regressors

### Phase 5: Global Scale (2027–2028)
- [ ] **LAC expansion**: 33 countries (add Guyana, Suriname, French Guiana)
- [ ] **Global comparison**: Full WHO region coverage
- [ ] **Real-time updates**: Annual data refresh automation
- [ ] **Interactive API**: GraphQL endpoint
- [ ] **Peer review**: Submission to Scientific Data or PLOS ONE

---

## How to Contribute

We welcome contributions in:
- **Data**: Additional years, countries, or specialist types
- **Analysis**: New analytical modules (see `notebooks/`)
- **Visualization**: Dashboard improvements
- **Translation**: Additional language support
- **Documentation**: Methodology, usage examples

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

---

## Milestones

| Milestone | Target Date | Status |
|-----------|-------------|--------|
| Core dataset published | March 2025 | ✅ Complete |
| Advanced analytics v2 | May 2026 | ✅ Complete |
| Forecasting module | Q3 2026 | 🔄 In progress |
| API v1 | Q4 2026 | 📋 Planned |
| Peer-reviewed paper | Q2 2027 | 📋 Planned |

---

*This roadmap is updated quarterly. Community input welcome via GitHub Issues.*