{"id":26059977,"url":"https://github.com/seanwevans/fhir-department","last_synced_at":"2026-04-27T05:05:23.147Z","repository":{"id":278942826,"uuid":"937222425","full_name":"seanwevans/fhir-department","owner":"seanwevans","description":"🔥A system for converting unstructured medical information into the Fast Healthcare Interoperability Resources (FHIR) format.","archived":false,"fork":false,"pushed_at":"2025-03-03T18:00:54.000Z","size":475,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-03T18:45:34.445Z","etag":null,"topics":["fhir","fhir-api","hl7-fhir","json","medical","xml"],"latest_commit_sha":null,"homepage":"https://fhir.house","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seanwevans.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-22T16:18:32.000Z","updated_at":"2025-03-03T18:00:57.000Z","dependencies_parsed_at":"2025-02-22T18:31:48.405Z","dependency_job_id":null,"html_url":"https://github.com/seanwevans/fhir-department","commit_stats":null,"previous_names":["seanwevans/fhir-department"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanwevans%2Ffhir-department","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanwevans%2Ffhir-department/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanwevans%2Ffhir-department/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanwevans%2Ffhir-department/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seanwevans","download_url":"https://codeload.github.com/seanwevans/fhir-department/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242559203,"owners_count":20149326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fhir","fhir-api","hl7-fhir","json","medical","xml"],"created_at":"2025-03-08T13:48:47.577Z","updated_at":"2026-04-27T05:05:23.118Z","avatar_url":"https://github.com/seanwevans.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"![License](https://img.shields.io/github/license/seanwevans/fhir-department)\n![CI](https://github.com/seanwevans/fhir-department/actions/workflows/c-cpp.yml/badge.svg)\n![Issues](https://img.shields.io/github/issues/seanwevans/fhir-department)\n![Pull Requests](https://img.shields.io/github/issues-pr/seanwevans/fhir-department)\n\n# FHIR 🔥 Department\n\nThe FHIR Department is a comprehensive system for processing and converting\nunstructured medical information into standardized FHIR (Fast Healthcare\nInteroperability Resources) format. The system employs a pipeline architecture\nwith multiple specialized components working together to ensure accurate and\nreliable data transformation.\n\n## 🏗️ Architecture Overview\n![🏗️ Architecture Overview](docs/FHIR-dept.png \"The Plan\")\nThe system consists of six main components, each handling specific aspects of\nthe FHIR conversion process:\n\n### 🚰 FHIR Hydrant (Thin Passthrough Layer)\n- Functions as the initial entry point for unstructured medical information\n- Manages initial data routing\n- Ensures consistent data flow into the processing pipeline\n- Creates shortest possible feedback loop ensuring quickest response\n\n### 🌊 FHIR Hose (Structuring Pipeline)\nConsists of four major processing stages:\n\n1. **Ingestion Processing**\n   - Classify: Identifies document types and content\n   - Clean: Removes noise and standardizes input\n   - Convert: Transforms data into processable format\n   - Validate: Ensures data quality before further processing\n\n2. **Natural Language Processing**\n   - Tokenize: Breaks down text into analyzable units\n   - Entity Extraction: Identifies medical terms and concepts\n   - Semantic Analysis: Understands context and relationships\n   - Validate: Verifies extracted information\n\n3. **Entity Mapping**\n   - Templates: Applies standardized FHIR templates\n   - ML Model: Uses machine learning for entity mapping\n   - Relational Model: Maps relationships between entities\n   - Validate: Ensures correct mapping\n\n4. **Construction**\n   - Reduce: Consolidates mapped information, deduplicates\n   - Reuse: Leverages existing FHIR resources and outside validations\n   - Recycle: Optimizes resource usage\n   - Validate: Final validation before output\n\n### 🥊 FHIR Fighter (ML Models)\n- Central ML processing hub\n- Handles complex pattern recognition\n- Provides confidence scoring for validations\n- Continuously learns from processed data\n- Interfaces with version control system\n\n### 🏠 FHIR House (Data Management)\n- Manages data storage and versioning\n- Maintains original copies and metadata\n- Handles backup and recovery\n- Provides process control mechanisms\n- Tracks performance metrics\n\n### 🔍 FHIR Watch (Human Intervention)\n- Manages cases requiring manual review\n- Handles low-confidence predictions\n- Provides reconciliation interface\n- Feeds corrections back to training data\n- Ensures quality control\n\n### 📊 FHIR Engine (Admin Dashboard)\n- Provides system monitoring and control\n- Displays performance metrics\n- Manages system configuration\n- Enables administrative oversight\n\n## 🔄 Data Flow\n\n1. Unstructured medical information enters through FHIR Hydrant\n2. FHIR Hose processes the data through its pipeline stages\n3. FHIR Fighter provides ML support throughout processing\n4. FHIR House manages storage and versioning\n5. FHIR Watch handles exceptions and manual review\n6. Final structured FHIR data is produced and validated\n\n## 🛡️ Validation \u0026 Quality Control\n\nThe system implements multiple validation layers:\n- Stage-specific validation after each processing step\n- Confidence scoring for ML predictions\n- Version control for all processed data\n- Human review for low-confidence cases\n- Performance metrics tracking\n- Automated backup and recovery\n\n## 📈 Performance Monitoring\n\nPerformance is tracked through:\n- Processing metrics at each pipeline stage\n- ML model accuracy metrics\n- System throughput measurements\n- Error rates and types\n- Manual intervention frequency\n- Resource utilization statistics\n\n## 🚀 Getting Started\n\n1. `make`\n\n## 📚 Documentation\n\n[This will be useful soon](https://FHIR.house)\n\n## 🤝 Contributing\n\n- Don't be a jerk\n- Submit a pull request\n\n## 📄 License\n\n[MIT](https://github.com/seanwevans/fhir-department/blob/main/LICENSE)\n\n## 🔗 Related Projects\n[FHIR v5](https://www.hl7.org/fhir/overview.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseanwevans%2Ffhir-department","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseanwevans%2Ffhir-department","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseanwevans%2Ffhir-department/lists"}