Skip to content
Appifire
Docs
31 — Milestone 3 Delivery Plan (Blueprint §9.3)

31 — Milestone 3 Delivery Plan (Blueprint §9.3)

Cursor-ready execution plan for Milestone 3: storefront widgets, public read API, analytics/billing surfaces, and launch QA readiness.

31 — Milestone 3 Delivery Plan (Blueprint §9.3)

Section titled “31 — Milestone 3 Delivery Plan (Blueprint §9.3)”

Source: 02-Implementation-Blueprint.md — §9 Release Plan → Milestone 3 (2 weeks).

Milestone 3 blueprint scope:

  • Theme widget rendering (home + PDP)
  • Widget storefront API
  • Analytics + billing limits
  • App Store readiness and QA

This document is a build spec only. No code changes are implied until a task references this file.

Related: 05, 11, 14, 15, 19, 21, 22, 23, 24.

0) Goal (one sentence)

Section titled “0) Goal (one sentence)”

Ship production-ready storefront delivery and business observability so approved testimonials drive visible merchant value and the app is launch-ready.

1) Scope lock (what is included)

Section titled “1) Scope lock (what is included)”

In scope

Section titled “In scope”

  1. Storefront publication layer:

    • Theme extension blocks (home + PDP)
    • Public testimonials read API
    • Placement filtering + fallback logic

  2. Operational intelligence:

    • Analytics page with funnel and media split
    • Billing & usage page with usage meters and overage awareness
    • Dashboard KPI alignment

  3. Launch readiness:

    • end-to-end QA
    • app listing readiness checks
    • compliance and performance sanity gates

Out of scope

Section titled “Out of scope”
  • New core capture workflows (already delivered in milestones 1–2)
  • Advanced AI moderation and transcript enhancements

2) Dependencies from Milestones 1–2

Section titled “2) Dependencies from Milestones 1–2”

Milestone 3 assumes:

  • request pipeline is live and stable (29)
  • public submission and moderation flow complete (30)
  • published content controls operational (11)

If any dependency is unstable, delay public widget rollout.

3) Deliverables

Section titled “3) Deliverables”

D1 — Storefront API + Theme extension

Section titled “D1 — Storefront API + Theme extension”
  • Public read API supports:
    • placement=home
    • placement=pdp&product_id=...
  • Two-block extension (recommended):
    • home widget block
    • PDP widget block
  • Shared JS renderer with loading/empty/error states

D2 — Visibility and merchandising correctness

Section titled “D2 — Visibility and merchandising correctness”
  • Only approved + published + ready content appears publicly
  • Placement toggles respected:
    • home
    • PDP
    • collection (if enabled)
  • Featured and sort order applied consistently

D3 — Metrics and billing surfaces

Section titled “D3 — Metrics and billing surfaces”
  • Analytics page:
    • funnel metrics
    • product coverage
    • media split
  • Billing page:
    • current plan
    • usage vs included
    • overage state
    • upgrade CTA

D4 — Launch QA readiness

Section titled “D4 — Launch QA readiness”
  • merchant admin smoke tests
  • storefront performance checks
  • compliance checklist pass

4) Technical acceptance criteria

Section titled “4) Technical acceptance criteria”

  1. Storefront

    • Home widget shows top configured published content.
    • PDP widget shows only product-linked content unless fallback mode applies.
    • Unpublish or visibility toggle updates reflect quickly in API results.

  2. Analytics/Billing

    • KPI values reconcile with source records for sample ranges.
    • Billing counters and overage estimates are deterministic and explainable.

  3. Readiness

    • Security and compliance checks complete for public endpoints.
    • Theme blocks do not break storefront rendering when data is empty.

5) Test matrix (minimum)

Section titled “5) Test matrix (minimum)”

Storefront matrix

Section titled “Storefront matrix”
  1. Home widget with published videos only
  2. PDP widget with product matches
  3. PDP widget with no product matches + each fallback mode
  4. Unpublish flow removes item from widget response
  5. Feature/sort changes reflected in rendering order

Metrics matrix

Section titled “Metrics matrix”
  1. Funnel values for date range with known fixture data
  2. Media split with mixed photo/video samples
  3. Billing usage and threshold banners (80%/100%)

Non-functional

Section titled “Non-functional”
  1. API response latency under expected threshold
  2. Widget script loads and renders on mobile themes
  3. No PII leakage in public read payload

6) Risks and mitigations

Section titled “6) Risks and mitigations”

  1. Incorrect visibility filtering leaks unintended content

    • Mitigation: single shared predicate helper used by API and admin previews.

  2. Theme integration breaks merchant layout

    • Mitigation: defensive JS and graceful no-op rendering when config/data invalid.

  3. Billing distrust from mismatched counters

    • Mitigation: reconciliation job and metric transparency in UI.

  4. Performance regressions on storefront

    • Mitigation: cap payload size, lazy media behavior, optimized indexes.

7) Suggested implementation order (Cursor)

Section titled “7) Suggested implementation order (Cursor)”
  1. Finalize published content controls and placement fields (11).
  2. Implement/verify public read API contracts (05).
  3. Implement theme extension blocks and renderer.
  4. Build analytics screen and validation fixtures (14, 19).
  5. Build billing & usage screen and usage counter reconciliation (15).
  6. Run launch QA matrix and fix blockers.

8) Launch readiness checklist

Section titled “8) Launch readiness checklist”
  • All milestone 3 acceptance criteria met.
  • Security/compliance tests pass (08).
  • Route map and nav complete (21, 24).
  • Merchant onboarding path tested end-to-end.
  • App listing assets/copy align with implemented behavior.

9) Done definition (Milestone 3)

Section titled “9) Done definition (Milestone 3)”

Milestone 3 is complete when:

  • merchants can reliably publish and display testimonials on storefront home/PDP,
  • key business metrics and usage/billing are visible and trustworthy,
  • app passes internal launch quality and compliance checks.

10) References

Section titled “10) References”
  • 02-Implementation-Blueprint.md — §9 Milestone 3
  • 05-storefront-widgets-and-read-api.md
  • 11-published-content-screen-7.md
  • 14-analytics-blueprint-screen-11.md
  • 15-billing-and-usage-blueprint-screen-12.md
  • 23-release-plan-and-milestones-blueprint-section-9.md

11) Note on numbering

Section titled “11) Note on numbering”

This folder already includes 05 through 30 plans. This file is 31-....

Home

01 Overview

AppiFire AI Chat — Product Plan & Architecture Options (A, B, C) Technology Overview & High-Level Tasks

01 Platform Foundation

Prerequisites (Detailed Plan) Shopify Setup — Partner Account, CLI, App, and Extension Shopify App Skeleton & Database (Detailed Plan)

02 Knowledge and RAG

Database Schema for RAG Product Sync & Ingestion RAG & Chat API RAG Data Sync (Products, Collections, Inventory, Blog Posts) + Order Lookup How the Codebase Uses Vector Information to Answer Users in Chat Website Knowledge from Web (GPT-4o Mini Search)

03 Billing and Usage

Billing & Usage Billing & Usage — Remaining Tasks Credits wallet: one-time purchases & subscription included credits Free Plan: Reply Cap and Monthly Reset Promo code functionality Shopify App Billing and Payments Tasks

04 Admin and Storefront

Admin Settings & Chat Widget Admin UI Design Plan — Bigger Font, Different Font, More Spacing, Styled Buttons AI Chats / Logs Screen Billing Screen Restructure Plan (Sales + Marketing Focus) Dashboard Plan — AppiFire AI Chat Design Guidelines and Styling System (Polaris + Tailwind Plan) Theme & Design System Timezone & Time Display Plan (Admin + Widget)

05 Chat Experience and Safety

Chat Guardrails Inspection Full Conversation History in OpenRouter Chat Order Lookup Reliability Guide Order Status Conversational Chat Flow Pre-Chat User Identity Form

06 Merchant Lifecycle

Register / Identify App Users (Paying Merchants) Uninstall: Record & Goodbye Email

07 Ops and Release

Deploy: Cloudflare Tunnel + Your Domain & App to appifire-ai-chat.appifire.com Launch & Publishing Guide Links Scheduled jobs, privacy & shop analytics Testing Up to Phase 2 (Product Sync & Ingestion)

08 Research and Ideas

App Names 20 Paid Feature Gaps — AppiFire AI Chat Roadmap Templates Shortlisted Top 30 Shopify App Ideas — High Demand, Buildable, Revenue Potential

09 Archive

100 AI Questions User Can Ask App Embed Settings Plan Chat Thread Identity and History Plan Plan: Free reply monthly reset & paid included credits delivery Future Todo List Promo Code Module Plan Reorganize Documents Support Feature Plan Talk to Human Flow Plan Welcome Email Plan (Brevo API)

10 Marketing and SEO

Article Writing Prompt Appifire SEO Topical Map Topical Map Prompt Appifire VS Pages VS Pages Prompt

11 Video Testimonial Collector

Post-Purchase Video Testimonial Collector — Detailed Product Plan Video Testimonial Collector - Implementation Blueprint Video Testimonial Collector - Pricing & Billing Options Delete All Existing Code and DB Tables (Boilerplate Cleanup) 05 — Storefront Widgets + Public Read API (Screen 8 & 8.1) 06 — Public Submission Page (Screen 13, `/t/:token`) 07 — Email/SMS Request Delivery Pipeline (Blueprint §4) 08 — Security, Compliance & Privacy (Blueprint §8) 09 — Submissions Inbox (Screen 5, `/app/testimonials`) 10 — Submission Detail & Moderation (Screen 6, `/app/testimonials/:id`) 11 — Published Content Manager (Screen 7, `/app/testimonials/published`) 12 — Moderation Settings (Screen 9, `/app/testimonials/moderation`) 13 — Requests Log (Blueprint Screen 10, `/app/testimonials/requests`) 14 — Analytics (Blueprint Screen 11, `/app/testimonials/analytics`) 15 — Billing & Usage (Blueprint Screen 12, `/app/testimonials/billing`) 16 — Templates (Screen 4, `/app/testimonial-templates`) 17 — Campaigns List (Screen 2, `/app/testimonial-campaigns`) 18 — Campaign Create/Edit (Screen 3, `/app/testimonial-campaigns/:id`) 19 — Dashboard (Screen 1, `/app`) 20 — Database Design & Migrations (Blueprint §5) 21 — Route & File Map Execution Plan (Blueprint §6) 22 — Integration & Processing Orchestration (Blueprint §7) 23 — Release Plan & Milestones (Blueprint §9) 24 — Build Notes Execution Standards (Blueprint §10) 25 — Core Modules Breakdown (Blueprint §2.2) 26 — Project Conventions Execution Guide (Blueprint §2.1) 27 — Product Scope Recommendation Execution (Blueprint §1) 28 — Admin Screens Information Architecture (Blueprint §3) 29 — Milestone 1 Delivery Plan (Blueprint §9.1) 30 — Milestone 2 Delivery Plan (Blueprint §9.2) 31 — Milestone 3 Delivery Plan (Blueprint §9.3) 32 — Email/SMS Operational Detail (Blueprint §4) 33 — TestimonialModerationLog Model & Audit Workflow (Blueprint §5.10) 34 — TestimonialDailyAnalytics Model & Rollup Jobs (Blueprint §5.11) 35 — TestimonialProductLink Model & Multi-Product Merchandising (Blueprint §5.9) 36 — TestimonialMediaAsset Model & Processing Pipeline (Blueprint §5.8) 37 — TestimonialSubmission Model & Lifecycle (Blueprint §5.7) 38 — TestimonialRequestEvent Model & Delivery Event Stream (Blueprint §5.6) 39 — TestimonialRequest Model & Scheduling Lifecycle (Blueprint §5.5) 40 — TestimonialTemplate Model & Resolution Rules (Blueprint §5.4) 41 — TestimonialCampaignProduct Model & Targeting Rules (Blueprint §5.3) 42 — TestimonialCampaign Model & Automation Rules (Blueprint §5.2) 43 — Shop Model Extension for Testimonials (Blueprint §5.1) 44 — Per-Product Collection Rule (Required) Implementation Plan 45 — Two Storefront Widgets (v1 Requirement, Screen 8.1)