Skip to content

Changelog

This page tracks important changes to the .pemr bundle format and internal database schema.

It is mainly intended for developers and advanced users who need to understand compatibility between different versions of CareFlow Kids and CareView Family.

Versioning principle

The .pemr bundle format evolves over time as new features are added.

To maintain compatibility:

  • the database schema version is tracked using:
PRAGMA user_version
  • migration helpers are included in the schema so older bundles can be safely upgraded when opened by newer versions of the application.

Current schema version

Current schema version:

user_version = 3

Key additions introduced up to this version include:

  • telemedicine support fields in sick visits
  • structured complaint duration fields
  • structured work-of-breathing evaluation
  • telemedicine documentation fields

Compatibility policy

The system follows a forward‑migration compatibility model.

This means:

  • newer applications can open older bundles
  • the application automatically applies safe schema upgrades when needed

However:

  • older applications may not be able to open bundles created by newer versions

Bundle format stability

The .pemr format is intentionally designed to remain stable.

Core components are expected to remain unchanged:

.pemr
├── db.sqlite
├── manifest.json
└── docs/

Future improvements should ideally extend the format rather than change its core structure.

Future evolution

Possible future changes may include:

  • richer vaccination data structures
  • improved document metadata
  • richer lab tests recording
  • additional AI capabilities (support for additional models, including local models)

These changes will always attempt to preserve backward readability whenever possible.