(Working title: Date Aletho – “Where purpose forges the union, not the other way around.” A witty, nerdy, egalitarian platform for truth-seeking partners who date the mission first and discover each other in the shared endurance of building light against darkness.)

1. Core Philosophy & Value Proposition (the “why” that drives every feature)

• Not “dating a person” — users date a purpose.
• The platform’s fulcrum is endurance earned through shared endeavour, not instant consumption or superficial chemistry.
• Matches form when two (or more) people independently choose the same task; the “romantic” or “life-partner” possibility is a welcome byproduct of walking the same path in truth-seeking, divide-resolving, and peaceful wisdom work.
• Tone: witty & nerdy (quantum puns, sword-of-light metaphors, egalitarian language that never defaults to binary gender assumptions).
• Tagline options (pick one or rotate):
  • “Date the quest. The partner is the bonus level.”
  • “We don’t swipe on souls. We forge them together in the fire of purpose.”
  • “Quantum entanglement for real-world light-work.”

2. Technical Stack (explicitly as requested)

• Backend: PHP 8.2+ (Laravel or plain PHP + PDO for simplicity; modular so it can evolve).
• Database: JSON storage, encrypted.
• Caching user’s current “qualities vector” for instant re-matching without server round-trips.
• Saving temporary “favourite endeavour IDs” before login.
• Hosting: Any PHP-capable server (e.g., shared hosting or VPS). No heavy frameworks required at MVP.
• CAPTCHA: Custom quantum-physics questionnaire (not reCAPTCHA).
• No external auth (no Google/Facebook) — pure email + password + quantum quiz.

3. User Registration Flow (bot-proof & nerdy)

1. Email + password + optional username.
2. Quantum Physics Questionnaire CAPTCHA (10 randomized multiple-choice questions, 70 % threshold to pass).
   • Examples (witty explanations shown on hover):
     • “In the double-slit experiment, the particle behaves like a wave until…” (options with Schrödinger’s-cat puns).
     • “Entanglement means two particles remain connected even when light-years apart — much like…” (tie-in to purpose endurance).
     • “Heisenberg’s uncertainty principle teaches us that observing the dark too closely…” (links to “sword of light” metaphor).
   • Questions pulled from a 50-question pool; wrong answers give humorous “almost there, fellow seeker” feedback instead of “bot detected.”
3. Immediate profile skeleton created; user is dropped into the “Forge” (main dashboard).

4. Profile & “Qualities of Life” System (egalitarian core)

• No gender, age, or looks filters in matchmaking (explicitly egalitarian).
• Instead, every user maintains a Qualities Vector — 12 slider/select statements rated 1–10 (stored as JSON in DB and mirrored in localStorage).
  Examples (witty labels):
  • “I measure success by endurance, not applause”
  • “Resolving divides peacefully > winning arguments”
  • “Truth-seeking > comfort-seeking”
  • “I bring the sword of light (curiosity + wisdom) to darkness”
  • “Location commitment level: local / regional / global wanderer”
• Bio field: 500-word “Truth Odyssey” prompt — users describe their personal journey fighting suffering through wisdom.
• Location: City + optional radius (km) or “global but willing to travel for the right endeavour.” Stored with simple geohashing for fast matching.

5. The “Endeavour” System (the actual dating object)

• An Endeavour = a task / purpose / mission that one user plants.
  • Title (witty/nerdy): “Operation Schrödinger’s Divide: Quantum Dialogue Workshops in Chicago”
  • Description (Markdown, 200–2000 words)
  • Tags: #resolve-racial-divides #climate-wisdom #AI-ethics-lightwork #local-food-sovereignty etc.
  • Required commitment: duration (weeks/months), hours/week, skills needed (optional).
  • Location scope: same as user’s or specific (e.g., “Chicago South Side only”).
  • Visibility: public or “seekers-only” (after quantum quiz).
• Any registered user can create an Endeavour or browse & join existing ones.
• Once joined, the user appears in that Endeavour’s private “Forge Circle” (simple threaded discussion + optional private chat).

6. Matching Algorithm (task-first, person-second)

Primary match signal = shared Endeavour + Qualities Vector alignment + Location proximity.

Scoring formula (pseudo-code, runs in PHP or client-side JS via localStorage cache):

matchScore = (0.45 * qualitiesCosineSimilarity) 
           + (0.35 * endeavourJoinOverlap) 
           + (0.15 * locationKmProximityScore) 
           + (0.05 * enduranceCommitmentDelta)   // smaller delta = higher score

• Cosine similarity on the 12-dimensional qualities vector (PHP or simple JS).
• Only users who have joined the same Endeavour appear in each other’s “Potential Allies” list.
• Users can elect to join an Endeavour that the algorithm recommends based on their vector.
• No swiping on profiles — you browse Endeavours first, then discover co-seekers inside them.
• Weekly “Lumen Digest” email: “3 new endeavours in your vector radius that need light-bringers.”

7. Core User Flows

1. Home / Forge Dashboard → live feed of active Endeavours near you + “Your Vector suggests…” cards.
2. Create Endeavour → form with localStorage draft auto-save.
3. Browse Endeavours → filter by tags, location, commitment level (nerdy search with quantum-flavored placeholders).
4. Endeavour Detail → join button + current members list (avatars hidden until joined; only names + qualities snippet shown).
5. My Unions → list of joined Endeavours + private circle chat (simple PHP polling or long-polling).
6. Profile → edit qualities vector, truth-odyssey bio, location.

8. Additional Witty / Nerdy Touches

• Loading messages: “Entangling particles of purpose…”
• Empty states: “The void is dark. Plant a new endeavour to bring the sword of light.”
• Success modals quote Rumi, Sagan, or quantum physicists with light-hearted commentary.
• Dark-mode default with glowing “light” accents.

9. Security & Privacy (baseline)

• All passwords hashed (password_hash).
• Sessions via PHP native + localStorage JWT-like token for frontend.
• No public user search outside Endeavours.
• Data minimization: no photos required at MVP (optional later).
• GDPR-friendly: easy data export/delete.

10. MVP Scope & Iteration Roadmap

MVP (Iteration 1.0 launch): Registration + quantum CAPTCHA + profile + create/browse/join Endeavours + basic matching feed + simple circle chat.
Iteration 2.0: In-Endeavour video calls (WebRTC), endurance milestone tracker, “fruit harvest” reflection journal.
Iteration 3.0: Mobile PWA polish, advanced vector analytics, moderated “global light councils.”