Skip to content

understand-project.md

Latest commit

 

History

History
148 lines (116 loc) · 6.8 KB

understand-project.md

File metadata and controls

148 lines (116 loc) · 6.8 KB

Asper Beauty Shop — Master Project Intelligence (understand-project)

Status: Live Flagship Reference Brain ID: qqceibvalkoytafynwoc Last Updated: March 2026

1. Project DNA: Medical Luxury & Identity

Asper is not just e-commerce; it is Luxury Medical-Commerce. It blends medical authority with a premium boutique experience.

  • Pillars: 40% Medical Authority, 30% Luxury Boutique, 30% Smart Tech.
  • Visuals: Clinical but warm, ivory palette, gold accents, breathing whitespace.
  • Mission: Provide pharmacy-grade skincare recommendations through an AI-first "Digital Flagship."

2. Technical Ecosystem (The Stack)

  • Frontend: React 18, TypeScript, Vite, Tailwind CSS, Radix UI/shadcn.
  • Backend: Supabase (Auth, PostgreSQL, 20+ Edge Functions).
  • Commerce: Shopify (Storefront API for catalog & checkout).
  • AI Engine: Google Gemini (via Supabase Edge Functions & Lovable).
  • Deployment: Lovable / Vercel.

3. Master Connections & Project IDs

System Value
Supabase Project ID qqceibvalkoytafynwoc
Shopify Domain lovable-project-milns.myshopify.com
Production URL https://www.asperbeautyshop.com
Staging URL https://www.asperbeautyshop.com
GitHub Repo �sperpharma/understand-project

4. Dr. Bot — The AI Beauty Assistant

Dr. Bot is the clinical AI agent managing customer consultations, product discovery, and support.

  • Logic: Uses Gemini for medical-beauty reasoning.
  • Omnichannel: Unified backend for Website, Gorgias, and ManyChat (WhatsApp/Instagram).
  • Core Functions:
    • �eauty-assistant: Primary AI engine.
    • �ulk-product-upload: Shopify catalog sync.
    • get-digital-tray: Personalized product routines.
    • gemini-tts: Voice interface proxy.

5. Critical Environment Variables (.env)

env VITE_SUPABASE_PROJECT_ID="qqceibvalkoytafynwoc" VITE_SUPABASE_URL="https://qqceibvalkoytafynwoc.supabase.co" VITE_SHOPIFY_STORE_DOMAIN="lovable-project-milns.myshopify.com" VITE_SHOPIFY_STOREFRONT_TOKEN="79d7870bb2e8b940752bdee2af19edbb"

6. Project Roadmap & Structure

  • Organization: Products are categorized by Category, Skin Concern (Acne, etc.), and Routine.
  • Integration Map: Found in docs/MASTER_CONNECTIONS.md.
  • Health Checks: Monitor at https://www.asperbeautyshop.com/health.

7. Visual Identity Signature (The "Asper Shine")

  • Active Hover State: Clinical Guide cards feature a distinct white shimmering diagonal light beam.
  • Animation: A smooth sweep across the card.
  • Background: Soft Ivory.
  • Symbolism: Signals a bright, sterile, "clinical clean" reflection, reinforcing the medical authority.

8. Brand Square Strategy (Medical Luxury)

  • UI Rule: Pure White (#FFFFFF) cards on Soft Ivory background.
  • Composition: Minimalist logo centered + single iconic hero product.
  • Lighting: "Clean Science" high-key lighting.
  • Hover Interaction: 1px Shiny Gold border illumination ("Seal of Authenticity").

9. The Expanded 15-Brand Clinical Catalog

  1. La Roche-Posay (Thermal Water focus)
  2. Eucerin (Anti-Pigment dual serum focus)
  3. Bioderma (Sensibio clarity focus)
  4. CeraVe (Ceramide molecular focus)
  5. Vichy (Minéral 89 hydration focus)
  6. Sesderma (Amber glass dropper/prescription focus)
  7. COSRX (Snail Mucin/glossy reflection focus)
  8. Heliocare (Medical sun protection)
  9. Avène (Thermal spring water)
  10. ISDIN (Photo-aging focus)
  11. Uriage (Barrier repair)
  12. Filorga (Medical-spa bridge)
  13. Beauty of Joseon (Traditional-modern K-Beauty)
  14. Skin1004 (Centella/Gold packaging focus)
  15. Medicube (High-tech clinic/devices)

10. Catalog Categorization (The Virtual Mall)

  • Layer 1 (Browsing): 5 Departments (Dermocosmetics, Makeup, Luxury Fragrance, Mom & Baby, Lifestyle & Travel).
  • Layer 2 (AI Intelligence):
    • By Concern: Acne, Anti-Aging, Dryness, Sensitivity.
    • By Persona:
      • Dr. Sami: Clinical/Medical brands (Vichy, Eucerin, Omron).
      • Ms. Zain: Aesthetic/Luxury brands (YSL, L'Oréal, K-Beauty).

11. The Virtual Mall: Departmental Hierarchy

  • Dermocosmetics (The Core): Vichy, La Roche-Posay, CeraVe. (Managed by Dr. Sami).
  • Makeup & Essentials: Maybelline, L'Oréal, Essence. (Managed by Ms. Zain).
  • Luxury Fragrance: YSL, Memo Paris, Niche perfumery.
  • Mom & Baby: Chicco, Lionelo, Daily Care.
  • Lifestyle & Travel: Samsonite, American Tourister.

12. Intelligent Meta-Categorization (3-Click Solution)

  • Concern Mapping: Products tagged with Acne, Aging, etc., trigger automatic regimen builders.
  • Persona Mapping:
    • Dr. Sami: Activates for Clinical/Medical items (Eucerin, Omron).
    • Ms. Zain: Activates for Aesthetics/Lifestyle (Makeup, Fragrance).

13. Security Knowledge & Context

  • Project Context: Asper Beauty Shop is a production-bound, public-facing e-commerce application handling real customer data and transactions.
  • Data Sensitivity: The application processes potentially sensitive customer data, including health/skin concerns (medical history context), order details, and personal contact information.
  • User Context: The storefront is accessible to public users, while the admin/backend (Supabase/Shopify) is strictly for trusted, authenticated staff and Edge Functions.
  • Environment Context: This repository represents the production-ready architecture. Any future development should assume a high-security posture, especially concerning Supabase Row Level Security (RLS) and the exposure of Shopify/Gemini API keys.

14. AI Sales & Marketing Mandate

  • AOV Optimization: Dr. Bot is programmed to upsell complementary items using the "Clinical 3-Step Regimen."
  • Conversion Focus: The bot utilizes "Closing" logic to guide users toward the Shopify checkout.
  • Logistics Marketing: Every consultation highlights Asper's shipping advantages (Amman same-day, Free > 50 JOD).
  • Social Proof Integration: The bot leverages brand authority to validate customer choices.

15. Brand Integrity & Realistic Media Mandate

  • Media Policy: ABS uses only realistic, high-fidelity brand assets. AI-generated imagery must follow the "Asper Shine" guidelines and represent actual physical product packaging accurately. No broken URLs or placeholder images are permitted in production.
  • SEO Strategy: Every product and brand page is optimized for Jordan/MENA beauty search intents (e.g., "Best Acne treatment Amman", "Pharmacy-grade skincare Jordan").

16. Google Cloud / Gemini Project Info

  • Project Name: Asper Beauty Shop
  • Project Number: 147143724210
  • Project ID: gen-lang-client-0019655668