> ## Documentation Index > Fetch the complete documentation index at: https://helloluciallc.com/llms.txt > Use this file to discover all available pages before exploring further. # START HERE - Infrastructure **At a glance** Lucia’s infrastructure layer supports public web access, controlled environments, real-world intake, observability, storage, authentication, and model execution. *** ## Infrastructure Purpose The infrastructure layer exists to make Lucia: ```text theme={"dark"} reachable observable recoverable testable upgradeable safe to operate ``` It is not just deployment plumbing. It is part of the product. *** ## Current Core Stack ```text theme={"dark"} Render → application hosting Cloudflare → DNS / edge control GitHub → source control OpenAI → model execution Twilio → SMS / MMS / WhatsApp Postmark → email inbound Resend → waitlist and guest verification outbound email Bunny → media storage and CDN Sentry → error observability Supabase → data platform Clerk → authentication Netlify → Guest Agent live-development lab ``` Current Lucia Core development data addition: ```text theme={"dark"} Lucia Core Supabase dev project → durable Stripe financial ledger Project: lucia-core-dev Project ref: jgnxomyzqotnqsmlxlsz Eval Labs Supabase → separate and untouched ``` *** ## Current Environment Model ```text theme={"dark"} Development → active live intake and dev-baseline validation Staging → validation / pre-production behavior after promotion Production → future Marketing / waitlist surface → live public surface Guest Agent lab → live-development public concierge surface ``` Development is currently the live intake surface for external providers. Staging is capable of handling intake but external providers do not target it unless manually switched. Lucia v0.1.3.6 is the first clean development baseline where Engine behavior, Admin UI, CI gates, Codex project identity, and Eval Labs target routing all align around the live internet workflow. Do not promote v0.1.3.6 to Staging until Eval Labs captures and reviews the Development behavior baseline. *** ## Current Version Stack ```text theme={"dark"} Engine: engine-v0.1.3.6 Admin: admin-v0.1.3.6 Guest Agent: lucia-guest-agent ``` Development surfaces: ```text theme={"dark"} https://dev.hellolucia.ai https://api-dev.hellolucia.ai ``` Marketing / waitlist surface: ```text theme={"dark"} https://hellolucia.ai https://hellolucia.ai/api/waitlist ``` Staging surfaces: ```text theme={"dark"} https://staging.hellolucia.ai https://api-staging.hellolucia.ai ``` Eval Labs v0.1.3.6 target: ```text theme={"dark"} https://api-dev.hellolucia.ai/admin/operator-focus ``` Guest-facing Lucia lab: ```text theme={"dark"} https://guest.hellolucia.ai/ https://lucia-guest-agent.netlify.app/lucia-lab/ ``` *** ## Waitlist Email Infrastructure Current Resend waitlist outbound status: ```text theme={"dark"} implemented: yes configured: yes tested: yes sending domain: send.hellolucia.ai runtime owner: hello-lucia/lucia-marketing runtime file: functions/api/waitlist.js route: POST /api/waitlist ``` Service split: ```text theme={"dark"} Postmark = inbound operational/system email intake Resend = outbound waitlist welcome email and guest verification email ``` Known gap: ```text theme={"dark"} Resend message id and send status are returned by the endpoint but not yet persisted to Supabase. ``` *** ## Render Environment Names Project: ```text theme={"dark"} Lucia AI ``` Development environment: ```text theme={"dark"} lucia-admin-dev lucia-booking-engine ``` Staging environment: ```text theme={"dark"} lucia-admin-staging lucia-engine-staging ``` *** ## Payment Truth Infrastructure Current Development status: ```text theme={"dark"} Implemented: Stripe sandbox payment foundation in Engine dev Implemented: durable Lucia Core Supabase Stripe ledger tables Configured: Engine dev service-role-only access to Lucia Core Supabase Configured: Render Engine dev durable ledger mode is dual and durable-required Tested: Harper Quinn #29110012 payment truth survived Render Engine restart Deferred: durable property payment policy persistence Not yet implemented: Admin payment writes, policy persistence, charge/refund/mark-paid UI ``` Durable ledger tables: ```text theme={"dark"} stripe_financial_records stripe_financial_events ``` Access boundary: ```text theme={"dark"} RLS enabled on both durable ledger tables No anon/auth read policies Engine uses service-role-only access Admin never talks directly to Supabase Admin renders Engine payment truth only ``` See [Lucia Payment Truth Foundation](/lucia/system-architecture/lucia-payment-truth-foundation) and [03 - Supabase](/lucia/infrastructure/supabase). *** ## Operating Loop Lucia is moving away from localhost-first. ```text theme={"dark"} Live internet development infrastructure → real operating loop localhost → isolated debugging only ``` Localhost should not be treated as the default proof path for integrated behavior. *** ## GitHub Organization Current repositories live under: ```text theme={"dark"} hello-lucia/lucia-admin hello-lucia/lucia-booking-engine ``` *** ## Branch Discipline ```text theme={"dark"} dev → active development stage → promoted validation branch ``` Stage should be protected. Direct stage pushes should be avoided. Admin Development CI must pass before Admin dev deploy: ```text theme={"dark"} npm ci npm run lint npm run build ``` *** ## Infrastructure Rule Every infrastructure claim in the Canon must specify whether it is: ```text theme={"dark"} implemented configured tested deferred future ``` No pretending. *** ## See Also * [01 - Render](/lucia/infrastructure/render) * [11 - Domains and Live Routing](/lucia/infrastructure/domains-and-live-routing) * [06 - Twilio (SMS WhatsApp Voice)](/lucia/infrastructure/twilio-sms-whatsapp-voice) * [07 - Postmark (Email Inbound)](/lucia/infrastructure/postmark-email-inbound) * [Email Services](/lucia/infrastructure/email-services) * [05 - Bunny CDN and Storage](/lucia/infrastructure/bunny-cdn-and-storage) * [08 - Sentry Observability](/lucia/infrastructure/sentry-observability) * [09 - OpenAI Model Layer](/lucia/infrastructure/openai-model-layer) * [10 - GitHub and Branch Discipline](/lucia/infrastructure/github-and-branch-discipline) *** ## Upstream / Downstream ### Upstream This layer is fed by: * [02 - Current System State](/lucia/start-here-lucia-ai/current-system-state) * [00 - START HERE - System Architecture](/lucia/system-architecture/start-here-system-architecture) ### Downstream This layer affects: * [00 - START HERE - Operations](/lucia/operations/start-here-operations) * [00 - START HERE - Evaluation System](/lucia/evaluation/start-here-evaluation-system) * [Lucia Decision Log](/lucia/decisions/lucia-decision-log)