HL7 Data Stream Project Guide

A detailed guide documenting the steps, tools, and lessons learned during the HL7 Data Stream Project.

Phase 1: Initial Data Recognition and Parsing

Timeline: ~40-50 hours

• Initial Exploration:
  • Goal: Understand the raw data and identify its structure.
  • Key Resource: HL7 Documentation.
  • Lessons Learned:
    • HL7 messages are delimited by |, ^, and ~.
• Discovery of HL7 Standard:
  • Recognized segment groups (e.g., MSH, PID, PV1, OBX).
  • Key Resource: HL7 Parsers on GitHub.

Phase 2: Establishing the WebSocket Server

Timeline: ~30-40 hours

• Setup of WebSocket Server:
  • Tool Used: Python’s WebSockets Library.
  • Lesson Learned: Ensure compatibility between WebSocket library and Python version.
• Testing Tools:
  • Browser Console: Test WebSocket connections using JavaScript:

    const socket = new WebSocket("ws://localhost:9000");
    socket.onmessage = (event) => console.log(event.data);

  • CLI Tool: Use wscat to test WebSocket communication:

    npm install -g wscat
    wscat -c ws://localhost:9000

Phase 3: Integrating with Odoo

Timeline: ~40-50 hours

• Module Creation:
  • Reference: Odoo Developer Documentation.
  • Commands:

    odoo-bin scaffold hl7_data_stream /opt/odoo/odoo-custom-addons
    systemctl restart odoo

• Lessons Learned:
  • XML parsing errors were resolved by replacing deprecated directives like t-raw with t-out.
  • Reference: Odoo XML Syntax.

Phase 4: Advanced Features and Optimizations

Timeline: ~30-40 hours

• Real-Time Data Updates:
  • Displayed SpO2, Heart Rate, and Blood Pressure.
  • Reference: MDN JSON Handling.
• Blood Pressure Calculation:
  • Derived systolic/diastolic from separate OBX fields.

Key Tools and Commands

• Odoo Development:

  systemctl restart odoo
  odoo-bin -u all

• Debugging Tools:
  • Browser DevTools: Monitor WebSocket communication.
  • VSCode Extensions: Python, JavaScript (ES6), and XML Tools.

Future Reference Materials

• HL7 Standards: Understand HL7 version differences and segment definitions.
• Python WebSocket Documentation.
• Odoo Developer Documentation.

Estimated Hours

Total Hours: ~140-180 hours