I Ching Divination

Digital divination tool based on the ancient Chinese Book of Changes (易經). Contains app specifications, data models, and UX documentation for building an interactive I Ching consultation experience.

Current State

The I Ching module currently contains specification and design documents. The structured hexagram database (64 hexagrams with trigrams, lines, and interpretations) is planned for future development.

Components

• Hexagram Database (planned): 64 hexagrams with upper/lower trigrams, line meanings, judgments, images, and multiple translation sources
• Divination Methods: Coin toss (3 coins), yarrow stalk (50 stalks), quick method
• Changing Lines: Moving yin/yang lines that transform the primary hexagram into a secondary one
• Reading History: User reading records with questions, timestamps, and notes

Structure

i-ching/
  data/                                  # Hexagram JSON database (planned)
  docs/schema/iching_models.py           # Pydantic data models (reference)
  docs/specifications/                   # 5 specification documents

Data Schema (from Pydantic models)

• Hexagram: number (1-64), name, description, image, judgment, 6 lines, upper/lower trigrams, interpretations by source, related hexagrams
• Trigram: name, element, attribute, symbol, 3 lines
• Line: type (yang/yin/moving_yang/moving_yin), position (1-6), interpretation
• Reading: id, timestamp, question, method, primary hexagram, changing hexagram, changing lines, notes, tags

HigherSelf Network — Enriching Holistic Learning