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	Pending
4	Admin settings & chat widget	Pending
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)
12	RAG data sync	Plan
13	Website knowledge from web	Plan
14	Dashboard plan	Plan
15	Admin UI design plan	Plan
16	Order status chat flow	Plan
17	Conversation history & context	Plan
18	Pre-chat user identity	Plan

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 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.
• 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).