Docs

Plan & Architecture

• AppiFire AI Chat — Plan & Options (A, B, C) — Product summary, free/paid tiers, admin config, RAG + OpenRouter; three architecture options for vector storage. Start here to choose your build path.
• Option A: Tech Stack & Tasks — Chosen path. Technology overview and high-level task list linking all phase docs.
• Option A — Design database schema for RAG — Production RAG schema (shops, products, chunks, embeddings, chat, OpenRouter billing).

Build phases

Phase	Doc	Status
0	Prerequisites	Done
1	Shopify app skeleton & database	Done
2	Product sync & ingestion	Done
3	RAG & chat API	Pending
4	Admin settings screen & chat widget	Pending
5	Billing & usage · Phase 5 — Remaining tasks	In progress
6	Launch & publishing guide	Pending
7	Deploy: Cloudflare Tunnel & AppiFire AI Chat	Pending
8	AI Chats / Logs screen	Pending
9	Theme & design system	Pending
—	Register / identify app users (paying merchants)	Done (store contact + Settings; phone manual)
—	Uninstall users: record & goodbye email	Plan
12	RAG Data Sync (products, collections, inventory, orders, blogs)	Plan

Other

• Testing up to Phase 2 — How to run the app locally, trigger product sync, and verify DB and webhooks (Phases 0–2).
• Top 30 Shopify App Ideas — High-demand apps to build: revenue potential, pricing, how to reach merchants, realistic MRR timeline.
• my-rnd — R&D and reference: dev plan, Shopify setup, marketing, model comparison, competitors.
• Shopify App Billing & Payments — How Shopify app subscriptions and one-time app purchases work, when merchants are billed, and how this maps to our credit-based model.
• Free plan credits — free_credit_limit and free_credits_used on shops: env FREE_PLAN_REPLIES_CAP, manual reset for all shops when needed, and blocking replies when limit is reached until upgrade.
• SQL dumps — ../databases/ — Ready-made Postgres dumps for restoring schema (e.g. Dokploy). See databases/README.md for pgvector requirements and restore steps.