# ClinicHall — Complete Technical, Security & Clinical Platform Specification (`/llms-full.txt`) > Canonical Origin: https://clinichall.com > Editions: FR (`/` · `/accueil`), EN (`/en`), ES (`/es`) > Legal Operator: ANTICA, SLU — Principat d'Andorra | Merchant of Record: HAM Ireland (Dublin) > Official Mailboxes: contact@clinichall.com · admin@clinichall.com · security@clinichall.com · press@clinichall.com ## 1. Mission & Positioning ClinicHall unifies consumer wearables, medical IoT devices, laboratory blood biomarkers, nutrition logs, strength training tonnage, and official health portal exports under one sovereign encrypted longitudinal ledger: **"Tous vos capteurs. Une seule vérité biologique."** Target cohorts served: 1. **High-level Athletes & Endurance Performers**: HRV, VO2max, lactate threshold, MyFitnessPal macros, MuscleWiki anatomical volume & recovery scores aggregated in real time. 2. **Aging Parents & Caregiving Adult Children**: Continuous SpO2, ECG/AFib, nocturnal BP reverse-dipping, and glucose trend surveillance with consented family/caregiver visibility and automated alerts. 3. **Working Adults & Preventive Health Seekers**: Unified longitudinal T0-vs-Today baseline comparisons and clinician-ready PDF reports. 4. **Teens & Young Athletes (Family Offer)**: Supervised underage profiles protected by multi-jurisdiction parental consent controls (GDPR Art. 8, COPPA, Andorran Llei 29/2021, Canadian PIPEDA, Chinese PIPL). 5. **Preventive-Conscious Families**: Multi-member household compartmentalization with strict cryptographic key separation and verifiable access journals. 6. **Board-Verified Physicians (`/physician` · `/medecin`)**: Verified medical-order practitioners (CNOM RPPS FR, Collège Médical LU, INAMI BE, FMH/MedReg CH, BÄK DE, COMA AD, OMC ES, GMC GB, NPI US, LMCC CA) running remote preventive cabinet monitoring with patient-consented dossiers and automated degradation alerts. ## 2. Cryptographic Architecture & Anti-Bot Protection - **Database Isolation**: PostgreSQL 17 with strict Row-Level Security (`FORCE ROW LEVEL SECURITY`) driven by transactional `hh.begin_ctx(member_uuid)` visibility policies. - **Attribute-Level AEAD**: Sensitive medical fields, OAuth credentials, and clinical annotations are encrypted with AES-256-GCM bound to Contextual Additional Authenticated Data (`Aad { table, column, row_id, member_id }`) and integrity-sealed via SHA-256 / SHA-512. - **Identity & Anti-Bot Defense**: Fail-closed Cloudflare Turnstile verification (`Managed` mode) across login, patient registration, physician board registration, and account recovery; mandatory Argon2id password hashing (12+ chars), RFC 6238 HMAC TOTP 2FA with replay lock, and WebAuthn/Passkey support. - **Electronic Mandates & Seals**: Cryptographic mandates and patient data-sharing releases signed via sovereign self-hosted DocuSeal (`templates 26–29`) and verified via fail-closed HMAC-SHA256 webhooks (`/webhooks/docuseal`). ## 3. Primary Care Physician & Board-Verified Cabinet Ecosystem - Patients can designate their **Médecin traitant** inside `/famille` (`PUT /api/members/{id}/primary-physician`) with granular scope switches (`vitals`, `labs`, `wearables`, `medications`, `documents`, `alerts`) and instant revocation (`DELETE /api/members/{id}/primary-physician`). - Physicians enroll at `/physician` (`/medecin`, `/en/physician`, `/es/medico`) by providing verified national medical board credentials + signing the ClinicHall Practitioner Charter via DocuSeal. - Any `critical` or `emergency` clinical threshold alert triggers anonymized cabinet notifications in `hh.physician_patient_alerts` and instant alerting from `contact@clinichall.com` to the supervising consented physician. ## 4. Compatibility Matrix & API / MCP Interfaces - **25+ Ecosystems**: Apple HealthKit, Google Health Connect, Withings, Oura Ring, WHOOP, Garmin, Polar, Suunto, COROS, Fitbit, Samsung Health, Eight Sleep, Peloton, Strava, MyFitnessPal, MuscleWiki, Abbott FreeStyle Libre, Dexcom, Omron, Hilo/Aktiia, Lumen, Muse, Fourth Frontier X2, Flowbio. - **Official Portal & Clinical Interoperability**: HL7 FHIR R4 Bundle export/import (`/api/members/{id}/fhir-bundle`, `/api/members/{id}/fhir-import`), Open mHealth export (`/api/members/{id}/open-mhealth`), Mon Espace Santé / Ameli / Blue Button / NHS compatibility roadmap. - **Personal Model Context Protocol (MCP)**: Authenticated JSON-RPC endpoint (`/api/mcp/manifest`, `/api/mcp/rpc`) ready for Claude, Codex, Cursor, Antigravity, and Mistral.