Team Documentation

Plan & architecture

• AppiFire AI Chat — plan & architecture options (A, B, C) — Product summary, free/paid tiers, admin config, RAG + OpenRouter; three architecture options for vector storage. Start here to compare paths.
• Technology overview & high-level tasks — Stack and build checklist for the app we ship; states that we implemented architecture Option A from the options page (pgvector + OpenRouter).
• Database schema for RAG — Production RAG schema (shops, products, chunks, embeddings, chat, OpenRouter billing).
• 20 paid feature gaps — roadmap — Monetizable feature gaps and a phased roadmap.

Delivery plans (by topic; each may bundle several features)

Section folders use numbered titles with spaces in the repo (e.g. 00 Team documentation, 01 Platform Foundation). URLs use kebab-case derived from those names (spaces → hyphens, lowercased). Page filenames stay kebab-case (e.g. billing-and-usage.md).

Step	Doc	Status
0	Prerequisites	Done
1	Shopify app skeleton & database	Done
2	Product sync & ingestion	Done
3	RAG & chat API	Done
4	Admin settings & chat widget	Done
5	Billing & usage · Billing — remaining tasks	In progress
6	Launch & publishing guide	Pending
7	Deploy: Cloudflare Tunnel & AppiFire AI Chat	Pending
8	AI chats / logs	Pending
9	Theme & design system	Pending
—	Register / identify app users	Done (store contact + Settings; phone manual)
—	Uninstall: record & goodbye email	Done (Brevo + uninstall snapshot)
—	Welcome email & install notifications	Done (Brevo welcome + REGISTRATION_NOTIFY_BCC)
12	RAG data sync	Plan
13	Website knowledge from web	Done (Knowledge Hub + FAQ + sanitizer)
—	Store currency & product prices	Done
—	RAG retrieval — published products & history	Done
—	Appearance & custom avatar	Done
14	Dashboard plan	Plan
15	Admin UI design plan	Plan
16	Order status chat flow	Plan
17	Conversation history & context	Done (CHAT_HISTORY_MESSAGES + CHAT_RAG_HISTORY_MESSAGES)
18	Pre-chat user identity	Plan
—	Storefront product cards & chat UX	Done

Other

• Shopify setup (partner, CLI, app, extension) — Step-by-step Shopify-side setup; uses Part 1 / Part 2 sections (not old “phase” doc naming).
• Testing up through product sync — Local run, sync, DB and webhooks.
• Top 30 Shopify app ideas — Market ideas reference.
• R&D notes (my-rnd) — Research notes.
• Shopify App Pricing — Managed recurring plans, plan picker, top-level upgrade redirect, paid vs free detection.
• Shopify app billing & payments — How Shopify billing maps to credits.
• Credits wallet: one-time & subscription — Buy packs, balance updates, reconcile, included monthly credits, cancel/resubscribe rules.
• Free plan credits — Caps and resets.
• Vector RAG chat call stack — Pipeline walkthrough.
• Storefront product cards & chat UX — Product card slider, Get More Info / View Product, focusProduct, reply cleanup.
• RAG retrieval — published products & history — CHAT_RAG_HISTORY_MESSAGES, published-only catalog, link follow-ups.
• Recent storefront & admin changes — Changelog index (billing, knowledge/FAQ, currency, custom avatar, welcome BCC, RAG).
• App Store review prompt — Side nav + dashboard CTA, 3-day auto modal, snooze and permanent opt-out.
• Appearance & custom avatar — Upload, Sharp WebP, storefront avatarUrl.
• Store currency & product prices — currency_code, RAG chunks, chat, product cards.
• Welcome email & install notifications — Brevo welcome + registration BCC.
• Referral program (30% revenue share) — Implemented MVP: admin Referral console, subscription commission accrual, merchant code entry on Billing.
• Chat guardrails — Where behavior is constrained.
• Operational links — URL scratchpad.
• Scheduled jobs, privacy & shop analytics — Free-plan reset cron URL, GDPR /webhooks/compliance, shops_installed_stats / shops_uninstalled snapshots.
• SQL dumps — Monorepo databases/ — see databases/README.md.

Where things live

• How documentation is organized — Folder map (ReorganizeDocuments.md); lives under 9 Archive.
• Free reply monthly reset & paid included credits (plan) — Archive: whether you need a cron for FREE_PLAN_REPLIES_CAP; how PAID_PLAN_INCLUDED_CREDITS_USD is applied (webhook / confirm / Billing loader, no cron).