Project Overview

Idol Shopping Network (ISN) was a Philippine social e-commerce platform launched in 2021 featuring celebrity endorsements and nationwide cash-on-delivery services. The mobile application was built using React Native compiled into Hermes bytecode.

When the original production infrastructure went offline, the mobile client ceased functioning. This open-source server emulator was engineered to reconstruct all expected REST API contracts, property structures, and SQLite schemas, bringing the app back to life for software preservation, research, and offline interoperability.

System Architecture

The server is designed with a lightweight, zero-dependency architecture:

Installation & Setup

Deploying your own ISN server takes less than 60 seconds.

1. Clone Repository

git clone https://github.com/ColtonSilvaonKnoxKontor/Idol-Shopping-Network-Server.git
cd Idol-Shopping-Network-Server

2. Configure Environment

cp .ske.example .ske
chmod 600 .ske

3. Run Automated CLI Installer

php setup.php

4. Start Built-in Development Server

php -S 0.0.0.0:8000 index.php

Configuration (.ske)

All secret keys, pepper values, and database paths are loaded from the private .ske (Silva Keys & Environment) configuration file.

# ISN Server Configuration
APP_NAME="Idol Shopping Network Server Emulator"
APP_ENV=production
APP_URL=https://isn.silvasystems.online

# Cryptographic Pepper for Password Hashing
SECURITY_PEPPER="YOUR_CUSTOM_SECRET_PEPPER_HERE"

# Admin Authentication
ADMIN_DEFAULT_PASSWORD=your_secure_admin_password_here
ADMIN_PASSWORD_FILE=

# SQLite Storage Path
DB_PATH=/path/to/your/database.sqlite

Database Engine & WAL Mode

The emulator connects via PHP PDO and configures Write-Ahead Logging (WAL) mode on every request:

PRAGMA journal_mode = WAL;
PRAGMA synchronous = NORMAL;
PRAGMA foreign_keys = ON;

Database Tables

Products & Catalog API

{
  "success": true,
  "status": 200,
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": 1,
        "name": "ISN Wireless Noise-Cancelling Headphones Pro",
        "price": 1299.00,
        "discount_price": 999.00,
        "is_idol_mall": 1,
        "latest_variety": { "price": 1299.00, "discounted": 999.00 }
      }
    ]
  }
}

Categories & Subcategories API

{
  "success": true,
  "status": 200,
  "length": 7,
  "data": [
    {
      "id": 1,
      "name": "Electronics & Gadgets",
      "image_url": "https://...",
      "sub_categories": [
        { "id": 1, "name": "Smartphones & Audio" }
      ]
    }
  ]
}

Authentication API

{
  "username": "buyer",
  "password": "password123"
}

Buyer & Cart API

Security & Threat Defense

The emulator includes built-in protection against automated vulnerability scanners:

• Dotfile & Key Isolation: Direct requests to .ske, .env, .git, or database.sqlite are blocked with HTTP 403 Forbidden.
• Directory Traversal Shield: Intercepts ../ and LFI attempts.
• Protected Admin Endpoint: Admin dashboard uses Argon2id with memory-hard hashing and private server-side pepper verification.
• Registered User Directory: Dedicated portal at /admin/users.php to manage buyer/seller accounts, inspect in-house OTP logs, reset credentials, and generate instant demo profiles.

Custom Error Handlers

The platform features dedicated error handlers modeled after the Wayback Machine archive and featuring our custom Anime Cat Girl Mascot:

Planned Development

Upcoming features and architecture enhancements designed to complete the full software preservation and emulation experience for the Idol Shopping Network platform:

1. In-House Self-Contained OTP Emulation Engine

Because official telecom carrier SMS gateways (Globe, Smart, Semaphore, Twilio) require paid subscriptions, external credentials, and active internet connectivity, the server emulator will feature a 100% self-contained, in-house OTP engine:

CREATE TABLE IF NOT EXISTS otp_verifications (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    phone TEXT NOT NULL,
    otp_code TEXT NOT NULL,
    is_verified INTEGER DEFAULT 0,
    expires_at DATETIME NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

2. In-House Customer Support & Live Chat System

Replaced defunct proprietary Intercom SaaS dependencies with a 100% self-hosted, in-house messaging architecture powered by SQLite and real-time polling:

3. Full Merchant Order & Fulfillment Lifecycle

Expanding the seller control plane to simulate real-time tracking updates, shipping waybill generation, and status progression from pending → preparing → shipped → delivered.

3. Interactive WebSocket Push Emulation

Replicating real-time order status toast notifications on the React Native mobile client using standard server-sent events (SSE) or local WebSocket streams.