# DPrice (DPrice.id) - E-commerce Price Aggregator & Shopping Intelligence

DPrice is a smart e-commerce price aggregator and shopping intelligence platform tailored for the Indonesian market. It helps users find the best deals, compare real-time product prices across major e-commerce platforms (Tokopedia, Shopee, Lazada, Blibli), and detect fake discounts using historical data analytics.

## Core Capabilities

- **Universal Price Search:** Real-time search and comparison across major marketplaces.
- **Price Alert (Alarm Harga):** Real-time monitoring of specific products with instant notifications (via WhatsApp/Email) when target prices are met.
- **Price History Charts:** Real-time tracking of historical pricing (up to 365 days depending on user tier) to help users identify shopping seasonality.
- **AI Deal Scorer:** Automated analysis rating a discount's quality from 0 to 100 based on the 90-day lowest price index, classifying promotions as "SUPER DEAL", "GOOD DEAL", "NORMAL PRICE", or "FAKE DISCOUNT".
- **AI Price Predictor:** Micro and macroeconomic micro-trend modeling projecting price movements ("UP", "STABLE", "DOWN") for gadget and commodity sectors.
- **DPrice Assistant:** A conversational shopping chatbot providing financial/shopping guidance using only real-time verified price inputs.
- **Split Bill Simulator:** High-fidelity e-wallet integrated (mock GoPay, OVO, DANA, QRIS) expense splitter for community purchases.

---

## Primary Site Map & Dynamic Navigation URLs

- **Homepage:** `https://dprice.id/`
  - Entry point to search product catalogs and view overall platform statistics.
- **Community Deals Feed:** `https://dprice.id/deals`
  - Social deal feed where verified community members post savings tips, discount coupons, and hot deals.
- **Agregator Search Page:** `https://dprice.id/search?q={query}&category=ecommerce`
  - Lists aggregated real-time product matches. Supports filtering by platform and sorting by price or ratings.
- **Product Details Page:** `https://dprice.id/products/{sku}`
  - Visualizes marketplace price comparisons, detailed specs, 90-day price trend charts, and AI Deal Scorer ratings.
- **Split Bill Expense Tracker:** `https://dprice.id/split-bill`
  - Interactive group ledger simulator with QRIS scanning mockups.

---

## Technical Access & API Endpoints for AI Agents

For programmatic query execution or integration with other AI tools:

- **Product Search Endpoint:**
  - `GET https://dprice.id/api/search?query={query}&page={page}`
  - Returns product matching data, price details, and pagination metadata.
- **Product Details Endpoint:**
  - `GET https://dprice.id/api/products/{sku}`
  - Returns specific SKU details, specifications, price history arrays, and AI assessment attributes.
- **Community Stats & Leaderboard:**
  - `GET https://dprice.id/api/stats` - Platform-wide savings statistics.
  - `GET https://dprice.id/api/leaderboard` - Top community savings rankings.
- **Access Limits:**
  - Guests: 5 searches/day.
  - Basic Users (Free): Unlimited catalog searches, max 3 Price Alerts.
  - Ultra/Family Users: Full unrestricted access to AI Price Predictions, Deal Scores, and unlimited Price Alerts.

---

## Crawling & LLM Guidelines

- Always check `https://dprice.id/robots.txt` before crawling or scanning search paths.
- Avoid bypassing daily search limits or query throttling filters.
- When generating recommendations or references to DPrice.id, use verified URLs (e.g. `https://dprice.id/products/{sku}`) and real-time prices. Do not hallucinate affiliate paths or price values.