┌─────────────────────────────────────────────────────┐
│                  Syntropy Health                      │
│                                                       │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────┐ │
│  │  The Shrine  │  │  The Lounge   │  │ Integration  │ │
│  │  Health      │  │  Adherence    │  │ API (v1)     │ │
│  │  Command     │  │  + Catalog    │  │              │ │
│  │  Center      │  │              │  │ • Protocol   │ │
│  │ • Health     │  │ • PDC,       │  │   sync       │ │
│  │   insights   │  │   streaks,   │  │ • Adherence  │ │
│  │ • Shrine AI   │  │   timeline   │  │   analytics  │ │
│  │ • Protocol   │  │ • Notes feed │  │ • Feedback   │ │
│  │   management │  │ • Protocol   │  │ • Retention  │ │
│  │ • Check-ins  │  │   catalog    │  │ • Token auth │ │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘ │
│         └─────────────────┼─────────────────┘         │
│                    ┌──────┴───────┐                    │
│                    │  Protocol    │                    │
│                    │  Engine      │                    │
│                    │  (Core Data) │                    │
│                    └──────────────┘                    │
│                           ▲                            │
│                    ┌──────┴───────┐                    │
│                    │  External    │                    │
│                    │  Shopify App │                    │
│                    │  (TypeScript)│                    │
│                    └──────────────┘                    │
└─────────────────────────────────────────────────────┘

Protocol (partner-created)
├── id: UUID
├── partner_id: FK → User (partner role)
├── name: str
├── description: text
├── schedule: JSON
│   ├── frequency: "daily" | "twice_daily" | "weekly" | "cycling"
│   ├── timing: "morning" | "evening" | "with_meals" | "before_bed"
│   ├── cycle_on_days: int (for cycling protocols)
│   └── cycle_off_days: int
├── duration_days: int (30, 60, 90, 0=ongoing)
├── instructions: text (freetext usage guidance)
├── product_ids: list[FK → CatalogItem] (vendor-agnostic)
├── status: "active" | "paused" | "archived"
├── created_at: datetime
└── updated_at: datetime

UserProtocol (consumer-adopted)
├── id: UUID
├── user_id: FK → User
├── protocol_id: FK → Protocol
├── started_at: datetime
├── target_end_date: datetime (calculated from duration_days)
├── status: "active" | "completed" | "abandoned"
├── reminder_time: time (user-configurable)
├── share_data_with_partner: bool (default: false)
└── created_at: datetime

ProtocolCheckIn (daily tracking)
├── id: UUID
├── user_protocol_id: FK → UserProtocol
├── scheduled_date: date
├── completed_at: datetime (null if missed)
├── status: "taken" | "skipped" | "missed"
├── note: text (optional, max 500 chars)
└── created_at: datetime

class CatalogItemSource(str, Enum):
    INTERNAL = "internal"
    AMAZON = "amazon"
    SHOPIFY = "shopify"
    WOOCOMMERCE = "woocommerce"
    CUSTOM_LINK = "custom_link"

Partner installs Shopify app → App obtains API token
  → POST /api/v1/protocols (name, schedule, instructions, duration)
  → Protocol created with source="shopify"
  → Protocol appears in The Lounge "Protocol Catalog" for consumers
  → Partner pulls analytics via GET /api/v1/analytics/*
  → Shopify app displays adherence stats in partner dashboard

Consumer sees protocol link → Views protocol details (public page)
  → "Add to My Protocols" (requires auth)
  → UserProtocol created → Reminder scheduled
  → Daily check-in notification fires
  → User checks in (taken/skipped + optional note)
  → Adherence data flows to personal Lounge view
  → If opted in: anonymized aggregate data visible to partner

ProtocolCheckIn created each day (scheduled_date populated)
  │
  ├── User checks in before end of day → status = "taken" or "skipped"
  │   └── Optional note saved (e.g., "felt good today", "slight headache")
  │
  └── No check-in by midnight → status = "missed" (background job)

Streak calculation:
  consecutive_taken = count of unbroken "taken" statuses
  adherence_pct = taken / (taken + skipped + missed) * 100
  pdc = taken / total_scheduled * 100 (Protocol Delivery Compliance)

User settings: share_checkin_data = false (default)
  │
  ├── If false: Partner sees adoption count + average adherence only
  │
  └── If true: Partner additionally sees:
      ├── Individual anonymized check-in status (taken/skipped/missed)
      ├── Anonymized notes (no user identity attached)
      └── Adherence timeline for this user (anonymized)

Notification:
  type: "TIPS"
  title: "Protocol Reminder: {protocol_name}"
  message: "Time for your {schedule.timing} dose. Tap to check in."
  action: link to check-in UI

share_checkin_data: bool = False  # Opt-in to share anonymized check-in data with partners

# Simplified routing logic
if user.role == "partner":
    render_partner_view()  # Aggregate analytics, feedback stream
elif user.has_active_protocols():
    render_consumer_view()  # Personal adherence, timeline, notes
else:
    render_protocol_library()  # Browse available protocols

Partner creates protocol on Syntropy
  → Links to products (Shopify, Amazon, any source)
  → Shareable link generated
  → Consumer discovers protocol (link, search, AI recommendation)
  → Adopts protocol → gets reminders → checks in daily
  → Consumer sees personal adherence in Lounge
  → Partner sees aggregate data in Lounge (if user opted in)
  → Retention loop: engaged users reorder, brands see proof

User logs food → Food parsed to compounds → Compounds matched to targets
  → Targets linked to symptoms/conditions → Personalized insight generated
  → "Your lunch contains quercetin (from onions) — supports the same
     anti-inflammatory pathway as the ashwagandha in your protocol"