Skip to content

Changelog

All notable changes to ccdakit will be documented here.

[0.1.0-alpha] - 2025-10-23

Added - Hospital & Surgical Sections (October 2025)

10 New Sections for discharge summaries, operative notes, and hospital workflows:

  1. Admission Diagnosis Section (2.16.840.1.113883.10.20.22.2.43)
  2. Documents patient diagnoses at time of admission
  3. Supports problem observations with SNOMED/ICD codes
  4. Includes effective times and status tracking

  5. 35 tests with 100% coverage

  6. Discharge Diagnosis Section (2.16.840.1.113883.10.20.22.2.24)

  7. Final diagnoses at hospital discharge
  8. Full problem observation support
  9. Narrative table generation

  10. 35 tests with 100% coverage

  11. Hospital Course Section (1.3.6.1.4.1.19376.1.5.3.1.3.5)

  12. Narrative description of entire hospital stay
  13. Key events and interventions
  14. Patient progress over time

  15. 34 tests with 100% coverage

  16. Instructions Section (2.16.840.1.113883.10.20.22.2.45)

  17. Patient care instructions
  18. Discharge instructions
  19. Follow-up guidance

  20. 33 tests with 100% coverage

  21. Anesthesia Section (2.16.840.1.113883.10.20.22.2.25)

  22. Anesthesia type and details for procedures
  23. Medications and dosages
  24. Monitoring data

  25. 29 tests with 100% coverage

  26. Postoperative Diagnosis Section (2.16.840.1.113883.10.20.22.2.35)

  27. Diagnoses determined after surgical procedure
  28. Links to operative findings
  29. Problem observation entries

  30. 28 tests with 100% coverage

  31. Preoperative Diagnosis Section (2.16.840.1.113883.10.20.22.2.34)

  32. Diagnoses before surgical procedure
  33. Reason for surgery
  34. Problem observation entries

  35. 27 tests with 100% coverage

  36. Complications Section (2.16.840.1.113883.10.20.22.2.37)

  37. Procedure and hospital complications
  38. Problem observations for complications
  39. Severity and outcomes

  40. 31 tests with 100% coverage

  41. Hospital Discharge Studies Summary Section (2.16.840.1.113883.10.20.22.2.16)

  42. Diagnostic studies performed before discharge
  43. Results and interpretations
  44. Pending studies

  45. 32 tests with 100% coverage

  46. Medications Administered Section (2.16.840.1.113883.10.20.22.2.38)

    • Medications given during hospitalization/encounter
    • Administration times and routes
    • Dosage information
    • 35 tests with 100% coverage

Total Impact: - 319 new tests added (100% coverage) - All sections support both R2.1 and R2.0 - Full narrative HTML table generation - Comprehensive protocol definitions

Added - MVP Complete (Initial Release)

Core Features: - Protocol-oriented design system - Multi-version support (C-CDA R2.1, R2.0) - Global configuration management - Type-safe implementation with full type hints

29 Complete Clinical Sections:

Core Sections (9): - Problems Section (SNOMED/ICD-10 codes) - Medications Section (RxNorm codes) - Allergies Section (RxNorm/UNII/SNOMED codes) - Immunizations Section (CVX codes) - Vital Signs Section (LOINC codes with organizers) - Procedures Section (CPT/SNOMED codes) - Results/Labs Section (LOINC codes with panels) - Social History Section (smoking status) - Encounters Section

Extended Sections (9): - Family History Section - Functional Status Section - Medical Equipment Section - Payers Section - Plan of Treatment Section - Health Concerns Section - Goals Section - Advance Directives Section - Mental Status Section

Specialized Sections (11): - Assessment and Plan Section - Chief Complaint and Reason for Visit Section - Reason for Visit Section - Nutrition Section - Past Medical History Section - Physical Exam Section - Hospital Discharge Instructions Section - Admission Medications Section - Discharge Medications Section - Health Status Evaluations and Outcomes Section - Interventions Section

Validation: - XSD schema validation - Schematron validation framework with auto-download and cleaning - Automatic download of official HL7 C-CDA R2.1 Schematron files - Automatic cleaning to fix IDREF errors (lxml compatibility) - Removes ~60 invalid pattern references while preserving all validation rules - Creates both original and cleaned versions for transparency - Custom validation rules - Common validation rule library

Utilities: - Code system registry (SNOMED, LOINC, RxNorm, etc.) - Value set registry with validation - Test data generator with Faker - Simple builder API - Dictionary to CDA converter - Template system

Development: - 2,222 comprehensive tests - 95% code coverage - Ruff for linting - Pyright for type checking - pytest with parallel execution - Complete documentation site

Documentation: - MkDocs Material documentation - API reference with mkdocstrings - User guides and tutorials - Examples and recipes - Contributing guide

Roadmap

[0.2.0] - Planned

  • Additional sections (Care Plan, Immunization Refusal Reason)
  • Enhanced Schematron support
  • ONC C-CDA Validator integration
  • Performance optimizations

[1.0.0] - Future

  • Plugin system for custom sections
  • Bulk generation utilities
  • Complete API stability
  • Production-ready release
  • Repository: https://github.com/Itisfilipe/ccdakit
  • Documentation: https://Itisfilipe.github.io/ccdakit
  • Issues: https://github.com/Itisfilipe/ccdakit/issues