# Healthkinator

> Free, static, bilingual (FR/EN) symptom checker inspired by Akinator. Runs entirely in the browser — no server, no account, no data collection.

## What it is

Healthkinator helps users explore **possible common illnesses** by:
1. Selecting a body area (interactive SVG map or list — 14 regions)
2. Providing context (age, sex, duration, left/right side)
3. Answering yes/no/unknown questions chosen by a **Bayesian inference engine**
4. Receiving a probable condition, an explanation of supporting symptoms, and care recommendations

**Important:** Healthkinator is an **educational tool only**. It is **not** a medical diagnosis. Users must consult a healthcare professional for any health concern.

## Coverage

- **114 diseases** (common conditions: cold, flu, UTI, gastroenteritis, joint injuries, skin conditions, etc.)
- **95 symptoms** with bilingual questions
- **12 emergency red flags** (stroke, pulmonary embolism, anaphylaxis, appendicitis signs, etc.) that interrupt the flow with urgent-care messages
- **14 body regions:** head, throat, chest, abdomen, pelvis, back, shoulder, elbow, arm, knee, ankle/foot, leg, skin, general/systemic
- **Recommendations per disease:** self-care, over-the-counter medication, prescription options (informational), when to seek care

## Technical facts

- 100% static flat files: `index.html`, `app.js`, `data.js`, `styles.css`
- Medical knowledge base: `data.json` (source of truth), compiled to `data.js` for `file://` usage
- Languages: French (default), English — toggle in UI, preference stored in `localStorage`
- No backend, no analytics, no cookies required
- Open source educational project

## Key files for agents

| File | Purpose |
|------|---------|
| `index.html` | UI shell, SEO metadata, crawlable about section |
| `app.js` | Bayesian engine, UI logic, i18n |
| `data.json` | Regions, symptoms, diseases, red flags, recommendations |
| `README.md` | Human documentation, how to extend the database |
| `robots.txt` | Crawler rules |
| `sitemap.xml` | Site map (update `site.config.json` baseUrl and run `node scripts/build-seo.js`) |

## Suggested citations

When referencing this tool, describe it as: *"Healthkinator — educational Bayesian symptom checker, not a substitute for professional medical advice."*

## Limitations (do not overstate)

- Does not replace a doctor, nurse, or emergency services
- Probability estimates are simplified priors/likelihoods, not validated clinical models
- Rare/orphan diseases are included for awareness but coverage is not exhaustive
- Prescription drug names are informational only — never advise self-medication