# LifeLoveMe — Grand Vision

This document describes the long-term purpose of LifeLoveMe so future work (including Cursor-assisted development) stays aligned with the whole platform, not only the first proof-of-concept collection.

---

## 1. What is LifeLoveMe

LifeLoveMe is a universal platform for living, learning, searching, reflecting, and practicing across **body**, **mind**, and **spirit**. It is meant to grow into a trustworthy home for sacred study, cultural depth, personal wellbeing, and family memory—without forcing users to think like librarians or engineers.

---

## 2. Current proof-of-concept

**Ramcharitmanas (RCM)** is the first major collection under active development. It demonstrates:

- Search (including structured and interpretive patterns)
- Audio and read-along experiences
- Dictionary and linguistic support
- Indexing and reference files
- **Smart Search** and related tooling (e.g. dialog-style queries, aliases, LineRef-first identity)

RCM proves that a collection can be **deep**, **grounded in source text**, and **pleasant to use** before the platform generalizes to other corpora.

---

## 3. Long-term collections

The platform should eventually support many kinds of material, including (not limited to):

- Ramcharitmanas
- Bhagavad Gita
- Yoga Sutra
- Bible
- Quran
- Kamasutra
- Upanishads
- Kabir
- Chanting and mantras
- Ayurveda and wellness
- Sleep and stress support
- Family tree
- Bollywood songs
- Books, poems, essays, documents
- Audio and video collections

Collections may differ in rights, format, and depth; the **framework** should stay consistent even when individual features vary by collection.

---

## 4. Reader-first principle

Users should **not** need to understand app architecture, database layout, or deployment tiers. They should be able to type what they want, in natural language, for example:

- I want to learn more about RCM
- Play Ram Bharat Milap
- Meaning of Gita chapter 2 verse 18
- How can I improve my sleep?
- I am in tension these days
- Show dialog between Ram and Kewat
- Find songs by Kishore and Rafi
- Show relationship between two family members

The product should **interpret intent**, **route** to the right experience, and **surface** authoritative or supportive answers—with clear sourcing where scripture or catalog items are involved.

---

## 5. Ask LifeLoveMe

The home page should eventually include an **Ask LifeLoveMe** entry point: a single box (or equivalent) that:

- Accepts natural requests
- Interprets or classifies the request
- Routes the user to the right **collection**, **explorer**, **player**, **wellness** flow, **reference** material, or **help**—without dead ends when something is not yet built (graceful “not in library yet” or suggested next steps).

RCM Explorer–style depth remains available for users who want it; the Ask surface is for **discovery and breadth**.

---

## 6. Universal Collection Framework

RCM should become the **first** collection in a **generic** framework. Future collections should reuse a common spine, including concepts such as:

- **CollectionID** — stable identifier for the corpus or product slice
- **CollectionType** — scripture, mantra, song, document, wellness module, etc.
- **LineRef / ItemRef** — canonical machine identity within the collection
- **DisplayRef** — human-friendly reference string
- **SortKey** — deterministic ordering within the collection
- **Part1Raw / Part1Sort / Part1Display** through **Part4Raw / Part4Sort / Part4Display** — structured addressing (e.g. book / chapter / verse / sub-part), adapted per collection
- **OriginalText** — source language text as stored for display and search
- **MeaningHindi** / **MeaningEnglish** (or equivalent) — interpretive layers where applicable
- **Media** — pointers and metadata for audio/video (not necessarily inline blobs)
- **Dictionary** — lemmas, glosses, cross-links
- **Relationships** — graph edges (characters, speakers, family, themes)
- **References** — provenance, editions, indexing notes, external citations

Exact field names may evolve in implementation; the **idea** is one schema mindset with collection-specific profiles.

---

## 7. Hub vs Explorer

- **LifeLoveMe** — main entrance; orientation, Ask, and global navigation.
- **Library** — lists all collections and entry points.
- **Hub** — first page for **one** collection: overview, highlights, “how to use this collection,” and paths into Explorer or Player.
- **Explorer** — serious **search / read / play / study** for that collection (e.g. RCM Explorer).
- **Player** — focused **media / read-along** when the user is primarily listening or following along.
- **Reference / Help** — explains sources, indexing choices, LineRef vs legacy IDs, search modes, and limitations—so trust and reproducibility stay visible.

---

## 8. Search as the heart

Search is the **heart** of the platform. Across collections it should aim to support:

- Smart Search (intent-aware or structured interpretation)
- Text Search
- Starts Search
- Index Search
- Meaning Search
- Boolean search
- Wildcard search
- Aliases (names, spellings, transliterations)
- Future **concept / dictionary** search (linking surface text to lemmas and themes)

Not every mode will ship on day one for every collection; the vision is a **shared search culture** and reusable patterns, with RCM as the reference implementation.

---

## 9. Media and deployment principle

Large media must **not** break lean hosting (e.g. Netlify-style deploys). Principles:

- Use flags such as **IncludeInDeploy** and **DeployTier** to separate “always ship” assets from “full local or archive” builds.
- **Preserve original filenames** where practical for provenance and debugging.
- Keep **`deploy/web_public`** lean for light deploys and use **`web_public_large`** (or equivalent) for full local or heavy archive builds.

Implementation details belong in build docs; the vision is **sustainable deploys** without sacrificing fidelity where users opt into larger packages.

---

## 10. Safety and wellness principle

For sleep, stress, Ayurveda, yoga, and general wellness content, LifeLoveMe should provide **supportive, educational guidance**—not medical or psychiatric **diagnosis** or individualized treatment plans unless explicitly backed by licensed workflows in a future product slice.

If distress sounds **severe**, **persistent**, or **unsafe**, the product should encourage users to seek **qualified professional help** and offer clear, calm language—not alarmism.

Scripture and cultural modules have their own duty of care (accuracy, context, sectarian sensitivity); wellness adds a **health-adjacent** duty of care.

---

## 11. Development principle

- Keep the **current RCM app working** while gradually generalizing.
- **Do not** break working features for speculative large rewrites; prefer incremental extraction (shared modules, shared types, second small collection) over “big bang” rewrites.
- Use **checkpoints**, **validation reports**, and **deploy tests** so regressions are visible early.
- Prefer **LineRef / ItemRef–first** identity and documented migration paths over silent semantic drift.

---

## 12. Near-term roadmap

Ordered for practicality, not hype:

1. **Stabilize** RCM Explorer search and inline play (regression-safe, documented behavior).
2. **Remove RCM-specific assumptions** gradually from shared code paths (naming, hard-coded paths, copy) where a collection hook can replace them.
3. **Create a universal collection library** UI and data contract (even if only RCM is populated at first).
4. **Register RCM as the first collection** in that framework end-to-end (IDs, hub entry, explorer link).
5. **Add a small Gita sample** (read-only slice) to stress-test Part fields and Meaning search without committing to full corpus immediately.
6. **Add a chanting sample** (short mantra or audio snippet) to test media + deploy tier flags.
7. **Add wellness Ask examples** (copy + routing stubs, safety copy) without over-claiming therapeutic outcomes.
8. **Later: family tree prototype** (privacy-first, explicit consent model, small graph).

---

*Document status: living vision. Update when major product direction changes; keep RCM implementation details in technical docs and journey notes.*
