# Product Scope Document: CK-QR Platform

**Project Name:** CK-QR
**Document Version:** 1.0
**Prepared by:** Cavin Infotech Pvt. Ltd.

## 1. Executive Summary
**Product Objective:** To develop and deploy a comprehensive, scalable SaaS platform that allows users to generate, customize, manage, and track Static and Dynamic QR codes.
**Target Audience:** Individual users, marketers, and enterprise businesses requiring centralized QR code management, custom branding, and real-time scan analytics.
**Monetization Strategy:** A freemium model where basic and dynamic generation is free (ad-supported routing), driving conversions to paid tiers for ad-free scanning, custom domains, and advanced analytics.

## 2. Core Functional Modules (In-Scope)

### A. User Management & Authentication
* **Authentication:** Registration/Login via Email, Google SSO, and Apple SSO.
* **Role-Based Access:** System must support Guest (unregistered), Free, Trial, Pro, and Enterprise user states.
* **Team Workspaces:** Multi-seat management for Enterprise tiers to collaborate on shared QR campaigns.

### B. QR Code Generation Engine
* **Dynamic QR Codes:** URL routing system allowing users to update destination content post-generation without altering the printed QR image.
* **Supported Data Types:** 
  * *Standard/Open-Source:* URL, vCard/MeCard, Text, Email (`mailto:`), SMS (`sms:`), Phone Call (`tel:`), Wi-Fi (WPA/WEP/Hidden), Location (Geo URI), Event (vCalendar/iCalendar), and GS1 Digital Link.
  * *Dynamic/Custom:* PDF/Document (including Excel/PPTX), App Store routing (OS-dependent), Image Galleries, Social Media (Link in Bio), Audio/Video (YouTube/MP3), Crypto Wallet addresses, Messaging (WhatsApp/Telegram/Line), Payments (UPI/PayPal), Forms & Surveys (Google Forms/Microsoft Forms), and Multi-URL/Conditional Routing (routing based on OS, time, location, or scan limits).

### C. QR Customization Studio
* **Design Templates:** Library of pre-configured multiple design templates for various industries and use-cases (e.g., sleek, playful, corporate).
* **Visual Editor (Patterns & Eyes):** Advanced interface for modifying data patterns (e.g., dots, squares, rounded, liquid) and customizing corner eye/frame shapes (outer and inner eye styling).
* **Color & Branding:** Support for single colors, linear/radial gradients, background colors, and transparent backgrounds.
* **Custom Logo Integration:** Central logo placement with support for custom image uploads, social media presets (Facebook, Instagram, LinkedIn, etc.), automatic background removal behind the logo, and logo resizing/scaling.
* **Frames & Call-To-Action:** Pre-designed customizable frames with integrated call-to-action text (e.g., "Scan Me", "View Menu", "Get Wi-Fi") and editable fonts/colors.

### D. QR Management Dashboard
* **Asset Organization:** Folders and tagging systems for campaign management.
* **Dynamic Controls:** Update destination URLs, temporarily pause campaigns (routes to a "Campaign Ended" holding page), or archive codes.
* **Bulk Operations:** Delete, categorize, or download multiple QR codes simultaneously.

### E. Scan Analytics & Tracking
* **Metrics:** Total scans, unique devices, operating system breakdown, and location tracking (Country/City).
* **Visualization:** Time-based charts (day/week/month).
* **Data Export:** CSV exports for external reporting.
* **Integrations:** Advanced tracking integration via Google Analytics and Meta Pixel for retargeting and deeper user insights.

### F. Web-Based QR Scanner
* **In-Browser Scanning:** A dedicated web interface utilizing device cameras (webcam/smartphone) to scan QR codes without requiring a native mobile app download.
* **Scan History:** Keeping a session or local log of recently scanned codes for the user.

## 3. Account Tier & Subscription Architecture
The platform operates on a tiered structure, utilizing a robust downgrade logic to ensure dynamic links remain functional even if subscriptions lapse.

| Feature / Capability | Guest / Free | Free Trial (14-Day) | Pro / Enterprise Paid |
| :--- | :--- | :--- | :--- |
| **Static QR Codes** | Unlimited | Unlimited | Unlimited |
| **Dynamic QR Codes** | Up to 5 | Unlimited | Unlimited |
| **Scan Interstitial Ads** | Yes (Ad-supported) | No Ads | No Ads |
| **Custom Domains** | CK-QR domain only | Custom subdomains | Custom domain / White-label |
| **Export Formats** | PNG, JPEG | PNG, JPEG, SVG, PDF | All + Bulk zip export |
| **File Storage Limit** | 5 MB per upload | 20 MB per upload | 100 MB - 1 GB+ per upload |

**Trial Expiration Logic:**
When a 14-day Pro Trial expires without payment, the account is downgraded to the Free Tier. Dynamic links do not break. Instead, the routing behavior reverts to ad-supported mode (serving a 3–5 second interstitial ad before redirecting) and vector exports are locked.

## 4. Technical Architecture & Infrastructure
To handle high-volume concurrent scans, rapid URL redirection, and secure data handling, the system will utilize a modern, highly available stack.

* **Frontend UI:** React.js / Next.js for a responsive dashboard and SEO-optimized landing pages.
* **Backend API:** Node.js backend executing asynchronous, non-blocking requests for rapid link routing and QR generation.
* **Process Management:** PM2 will be utilized for Node.js process management, clustering, and ensuring backend zero-downtime restarts.
* **Deployment & Networking:** The application will be containerized using Docker. Nginx will serve as the reverse proxy and load balancer to manage incoming scan traffic and route it to the appropriate backend containers.
* **Database Engine:** PostgreSQL for relational user and billing data, paired with a Redis caching layer for active dynamic URLs to ensure sub-second redirection latency.
* **Storage & CDN:** AWS S3 or Cloudflare R2 for storing user-uploaded assets (logos, PDFs) and serving them globally.

## 5. Development Phases

* **Phase 1: Foundation & Core Engine (Weeks 1-4)**
  Database schema design, Node.js API setup, authentication workflows, and the core QR generation and routing logic.
* **Phase 2: Customization Studio & Dashboard (Weeks 5-8)**
  Frontend development of the React.js dashboard, visual QR customization studio, folder management, and user asset storage.
* **Phase 3: Subscription & Analytics (Weeks 9-11)**
  Integration of the payment gateway (e.g., Stripe), trial expiration logic, ad-interstitial middleware, and scan analytics tracking.
* **Phase 4: Optimization & Launch (Weeks 12-14)**
  Docker containerization, Nginx configuration, PM2 load testing for high-concurrency scans, QA testing, and production deployment.

## 6. Out of Scope (Phase 1)
* Native iOS and Android mobile applications.
* Public API access for third-party developers.
* Complete white-labeling of the dashboard for enterprise resellers.

## 7. Assumptions & Risks
* **Link Spam & Abuse:** Malicious actors may use free dynamic QRs for phishing.
  * *Mitigation:* Implement automated URL scanning (e.g., Google Safe Browsing API) upon creation and enforce email verification for dynamic creation.
* **Ad-Blocker Interference:** Browser ad-blockers may prevent the ad-supported redirect logic from firing.
  * *Mitigation:* Server-side routing delays rather than client-side ad rendering for free tiers.
