System Requirements Document for resellscout

1. Introduction

ResellScout is a mobile-first application designed to assist resellers in determining the resale value of items. The app enables users to upload or take a photo of a product, which is then analyzed using the Gemini multimodal API to identify the product details. The app subsequently searches the web for real product listings, providing users with verified information to decide if an item is worth buying and reselling.

2. System Overview

ResellScout is built using Next.js and TypeScript, leveraging the Gemini multimodal API for product identification and Google Search grounding for retrieving real product listings. The app is designed with a modern, premium mobile-first interface, focusing on simplicity and usability. It does not include features like authentication, payments, subscriptions, history, or settings in its MVP version.

2a. Product Interpretation and Delivery Boundary

The application is accessible anonymously, allowing users to start on the Home page without authentication. The primary user interaction involves uploading or capturing a product photo, which is processed server-side to ensure the Gemini API key remains secure. The app focuses on providing verified product information without creating or displaying fake data, prices, or URLs.

2b. Source Content Inventory

Not applicable as no content source directive was provided.

2c. Page Content and Component Coverage

Home

• Logo/Name: Displays the ResellScout logo and name.
• Scan Product Button: A large button to initiate the product scanning process.
• Subtitle: "Check if an item is worth buying and reselling."

Analysis screen

• Uploaded Product Image: Displays the image uploaded or captured by the user.
• Identified Product Details:
  • Brand
  • Model
  • Identification Confidence
• Verified Market Results:
  • Price
  • Marketplace/Source
  • Condition
  • Direct Link (with "Direct product link unavailable" if not verified)
  • Exact/Similar Badge

3. Functional Requirements

• As a Reseller, I should be able to open the Home page and see the ResellScout logo, a "Scan Product" button, and a subtitle. (explicit)
• As a Reseller, I should be able to click "Scan Product" to upload or take a photo of a product. (explicit)
• As a Reseller, I should be able to have the product photo sent to the server-side Gemini multimodal API for identification. (explicit)
• As a Reseller, I should receive identification details including brand, product name, model, SKU/GTIN, readable text, category, and confidence level. (explicit)
• As a Reseller, I should see verified product listings with exact product title, price, currency, marketplace/store, condition, seller, and direct product URL. (explicit)
• As a Reseller, I should see a distinction between exact matches and similar products. (explicit)
• As a Reseller, I should see a message if a direct product URL cannot be verified: "Direct product link unavailable." (explicit)
• As a Reseller, I should see a message if no verified price is found: "No verified price found." (explicit)
• As a Reseller, I should see a message if the product cannot be confidently identified: "Not enough verified data to make a confident recommendation." (explicit)

4. User Personas

Reseller

• Context: Uses ResellScout to evaluate the resale potential of items by uploading or capturing product photos.
• Primary Goal: To determine if a product is worth buying and reselling based on verified market data.
• Responsibilities: Upload product photos, review identification and market results, and make informed purchasing decisions.
• Interactions: Engages with the Home and Analysis screens to complete the product evaluation process.
• Success: Successfully identifies products and receives accurate market data to inform resale decisions.

5. Core User Flows

5.1 Reseller Evaluates a Product

1. Start: Reseller opens the Home page.
2. Action: Reseller clicks the "Scan Product" button.
3. Action: Reseller uploads or captures a product photo.
4. System Process: Photo is sent to the server-side Gemini multimodal API.
5. System Process: Gemini identifies product details and sends them back.
6. System Process: Public web search is conducted using Google Search grounding.
7. System Process: Verified product listings are retrieved and displayed.
8. Decision: Reseller reviews the results, including price, condition, and direct URL.
9. Outcome: Reseller decides whether the item is worth buying and reselling.

6. Visuals Colors and Theme

• Muse: Tobias van Schneider
• Palette:
  • Background: #FFFFFF
  • Surface: #F9F9F9
  • Text: #000000
  • Primary: #FF453A
  • Accent: #FF9500
  • Muted: #D1D1D6
• Typography:
  • Headings: Playfair Display — Bold
  • Body: Neue Haas Grotesk Text Pro
  • Scale: 1.5 modular, 60/40/24/16/14
• Shape Language: Sharp corners with minimalistic UI elements.
• Layout: Asymmetric editorial grids with full-bleed imagery.
• Imagery: Large-scale editorial photography, monochrome treatments.

7. Signature Design Concept

The Home page features a full-width headline that commands attention, with a bold red 'Scan Product' button as the focal point. The editorial-style grid layout is used for displaying search results, with full-bleed imagery cropped generously for impact. Hover effects swap images to reveal more information.

8. Interaction Model & Motion Direction

• Interaction Model: Static
• Motion Tempo: Restrained
• Hero Dimensionality: Flat
• Landing Hero Motion Brief: The Home page features a full-width headline over a monochrome background with a bold red accent for the 'Scan Product' button. The restrained motion includes slow crossfades and type reveals.

9. Non-Functional Requirements

• The application must maintain a clean modular architecture to facilitate the addition of new marketplace providers.
• The Gemini API key must be securely stored server-side and never exposed to the browser.

10. Tech Stack

• Frontend: Next.js, TypeScript
• Backend: Node.js
• API: Google Gemini JavaScript SDK (@google/genai)
• Environment Management: .env for environment variables

11. Assumptions and Constraints

• The application will not include authentication, payments, subscriptions, history, or settings in the MVP.
• All URLs and prices must be verified and sourced; no placeholders or mock data are allowed.

12. Glossary

• Gemini API: A multimodal API used for product identification.
• Google Search Grounding: A method to search the web for real product listings.
• MVP: Minimum Viable Product, the initial version of the app with core functionalities.