Org File Structure¶

The file structure in Org Mode closely follows the core abstractions documented here. To start with, a profile is stored in a single Org Mode file that starts like this:

:PROPERTIES:
:ID:       9a62f510-fa55-424a-87e1-e12fd7aeb12f
:HARP_NAME: Caterpillar
:HARP_TYPE: cat
:END:
#+TITLE: Caterpillar Health Record

The HARP_* properties are optional. Important is to have the ID property and document #+TITLE.

Journals¶

Any level 2 heading under * Journals is considered a journal with the title of heading as the journal name. For example, here are a few journals:

* Journals
** General

...


** Another Journal

...

Journal Entry¶

Entries are level 3 headings under journal sections. Here are a few example entries under General journal:

* Journals
** General
*** Entry                       :ATTACH:
:PROPERTIES:
:ID: 07ff094a-139e-44e9-8f0e-865bd9472f31
:DATETIME: <2025-11-18 14:05>
:PRIVATE: nil
:END:

#some-metric(1.2) checked from that place

[[attachment:filename.jpg][filename.jpg]]


*** Entry
:PROPERTIES:
:ID: 4251cd5a-8201-4bde-8bc5-377aee47f34a
:DATETIME: <2025-11-05 21:04>
:PRIVATE: nil
:END:

I got some pain in my legs starting today #physio

Note that tags could also go in the entry org section like usual org tags. While collecting tags for an entry, we take heading tags as well as inline tags.

Documents¶

Similar to journal, documents are stored as org headings under the parent level 1 heading called * Documents:

* Documents
** Blood Test    :ATTACH:
:PROPERTIES:
:SOURCE:  Some source
:FILES:  IMG20250519225314.jpg, IMG20250519225339.jpg
:ID:  b43f23d3-913e-4883-8d5e-c17b11637e37
:DATETIME:  [2025-05-09 19:00]
:END:

Annotation goes here like any other journal entry text.

** Neutering Note    :surgery:ATTACH:
:PROPERTIES:
:SOURCE: Some source
:FILES:  IMG20250519225536.jpg
:ID:  c06d3f14-6bd4-4655-8b40-b45b4883fab7
:DATETIME:  [2025-05-11 15:30]
:END:

#surgery

Note that a document entry always contains a FILES property listing attached file names as comma separated values.

Metadata¶

Warning

This section is a work in progress.

Metric Definitions¶

* Metadata
** Metrics    

*** Weight    
:PROPERTIES:
:TAG_ID:  weight
:UNIT:  kg
:RANGE:  50-85
:HEALTHY_RANGE:  56.7-76.6
:END:

*** Cholesterol LDL
:PROPERTIES:
:TAG_ID:  ldl
:UNIT:  mg/dL
:RANGE:  0-300
:HEALTHY_RANGE:  0-100
:END:

*** Triglycerides
:PROPERTIES:
:TAG_ID:  tg
:UNIT:  mg/dL
:RANGE:  0-800
:HEALTHY_RANGE:  0-150
:END:

File Attachments¶

Any attachment, either in journal or document entries, is stored using the default org attach approach with files stored under ./data/ directory under sub directories paths using the ID of entry.