# Mifan Course Marketplace — Comprehensive LLMs Full Documentation

> Full specification, curriculum outlines, financial models, API contracts, and security rules for Mifan Course.

## Table of Contents
1. [Platform Overview](#platform-overview)
2. [Marketplace Economics & Revenue Split](#marketplace-economics--revenue-split)
3. [Course Catalog & Detailed Curricula](#course-catalog--detailed-curricula)
4. [Contributor Accreditation & Quality Review](#contributor-accreditation--quality-review)
5. [Certificate Verification System](#certificate-verification-system)
6. [API Specifications](#api-specifications)
7. [Security & Anti-Abuse Controls](#security--anti-abuse-controls)

---

## 1. Platform Overview
Mifan Course is built on three distinct role workspaces:
- **Student**: Purchase courses with single-order checkout, learn via self-paced mixed-media player, take time-stamped notes, and earn verifiable credentials.
- **Contributor**: Complete KYC onboarding, subscribe to creator tiers, build multi-section courses, submit for quality review, monitor gross/net earnings via real-time double-entry ledgers, and execute bank payouts.
- **Administrator**: Approve or request changes on contributor applications and course submissions, adjust dynamic commission rules, audit financial orders and refunds, and inspect immutable system logs.

---

## 2. Marketplace Economics & Revenue Split

Every student transaction generates an immutable ledger split:
- **Gross Sales Price**: The final amount paid by the student in IDR.
- **Platform Fee (Commission)**: 10% (Studio), 15% (Pro), or 20% (Starter).
- **Payment Processing Fee**: 3% gateway deduction.
- **Net Contributor Share**: Automatically credited to the contributor's pending balance, becoming available for withdrawal after payment settlement.

### Contributor Subscription Plans
1. **Starter Plan** (IDR 149,000 / month):
   - 2 Published Courses limit
   - 10 GB Secure Media Storage
   - 20% Platform Commission
   - Standard Review Queue (48h turnaround)
2. **Pro Plan** (IDR 349,000 / month):
   - 10 Published Courses limit
   - 100 GB Secure Media Storage
   - 15% Platform Commission
   - Priority Review Queue (24h turnaround)
   - Student Analytics & Roster Messaging
3. **Studio Plan** (IDR 3,499,000 / year):
   - Unlimited Courses
   - 500 GB Secure Media Storage
   - 10% Platform Commission
   - Dedicated Partner Manager & Fast-Track Review

---

## 3. Course Catalog & Detailed Curricula

### Course 1: UI Design Foundations
- **Slug**: `ui-design-foundations`
- **Instructor**: Arif Rahman (Senior Product Designer)
- **Category**: UI & UX Design
- **Price**: IDR 499,000
- **Duration**: 4h 30m
- **Curriculum Structure**:
  - *Section 1: Foundations & Spatial Rhythm*
    - Lesson 1.1: Welcome & Design Mindset (Video, 6m, Preview enabled)
    - Lesson 1.2: Core Principles of Interface Architecture (Text, 10m)
    - Lesson 1.3: Spatial Rhythm & Spacing Cheatsheet (PDF Workbook, 8m)
  - *Section 2: Component Engineering & Audio Deep-Dive*
    - Lesson 2.1: Audio Walkthrough: Design System Components (Audio, 15m)
    - Lesson 2.2: Building the Complete Mobile Flow (Video, 20m)

### Course 2: Modern React & TypeScript Architecture
- **Slug**: `react-typescript-mastery`
- **Instructor**: Reza Firmansyah (Senior Fullstack Engineer)
- **Category**: Development
- **Price**: IDR 599,000
- **Duration**: 5h 30m
- **Curriculum Structure**:
  - *Section 1: Strict TypeScript in React*
    - Lesson 1.1: Why Strict Types Matter in Modern Web (Video, 12m)
    - Lesson 1.2: Component Props & Discriminated Unions (Text, 15m)
    - Lesson 1.3: TypeScript React Architecture Cheatsheet (PDF, 10m)
  - *Section 2: High Performance State & Hooks*
    - Lesson 2.1: State Management Pitfalls & Context Boundaries (Audio, 18m)
    - Lesson 2.2: Building an Optimistic Workspace Table (Video, 23m)
    - Lesson 2.3: Module Knowledge Check & TypeScript Rules (Interactive Quiz, 10m)

### Course 3: AI Engineering & Practical LLM Prompting
- **Slug**: `practical-ai-engineering`
- **Instructor**: Reza Firmansyah
- **Category**: Development / AI
- **Price**: IDR 699,000
- **Duration**: 4h 00m
- **Curriculum Structure**:
  - *Section 1: LLM Foundations & Tool Orchestration*
    - Lesson 1.1: Structured Outputs & Function Calling (Video, 14m)
    - Lesson 1.2: Prompt Engineering Patterns & Guidelines (Text, 11m)
  - *Section 2: Real-time Streaming & Fallbacks*
    - Lesson 2.1: Streaming Server-Sent Events to Client (Video, 16m)
    - Lesson 2.2: AI Architecture Reference Spec (PDF, 8m)

### Course 4: Brand Systems Basics
- **Slug**: `brand-systems-basics`
- **Instructor**: Arif Rahman
- **Category**: Brand & Marketing
- **Price**: IDR 399,000
- **Duration**: 2h 00m
- **Curriculum Structure**:
  - Lesson 1: Brand Geometry & Palette (Video, 40m)
  - Lesson 2: Identity Guidelines Document (Text, 40m)
  - Lesson 3: Asset Package Spec (PDF, 40m)

### Course 5: Product Metrics & Growth Strategy
- **Slug**: `product-metrics-growth-strategy`
- **Instructor**: Diana Kusuma (VP of Product)
- **Category**: Business & Management
- **Price**: IDR 549,000
- **Duration**: 3h 30m
- **Curriculum Structure**:
  - Lesson 1: The Input vs Output Metrics Matrix (Video, 11m)
  - Lesson 2: Retention Curves & Churn Prevention Guide (Text, 13m)
  - Lesson 3: Pricing Strategy Deep-Dive (Audio, 15m)
  - Lesson 4: Growth Experimentation Template (PDF, 7m)

---

## 4. Contributor Accreditation & Quality Review
Before publishing courses, contributors must satisfy the 100% Quality Checklist:
- Identity document and bank account verification.
- Minimum 3 sections with distinct lesson formats.
- High-definition video with synchronized captions (.vtt) and clean audio levels (< -14 LUFS).
- High-contrast visual graphics and downloadable reference cheat sheets.
- Administrative review by authorized staff before the course can be published.

---

## 5. Certificate Verification System
When a student completes 100% of required lessons, the system generates a tamper-evident Certificate:
- **Format**: `EC-{YEAR}-{SLUG_PREFIX}-{ALPHANUMERIC_HASH}` (e.g. `EC-2026-BRAND-7K2M`).
- **Verification Endpoint**: `https://ais-dev-n5pd7gv2ne3j7peqvxegtz-753885977842.asia-east1.run.app/certificates/verify/{code}`
- **Security**: The public lookup checks the immutable server record snapshot containing recipient name, course title snapshot, instructor name snapshot, and issuance timestamp without revealing private student emails or payment details.

---

## 6. API Specifications
- `GET /api/health` -> System health check
- `GET /api/courses` -> Published courses metadata array
- `GET /api/llms` -> Structured LLMS JSON specification
- `GET /llms.txt` -> High-level Markdown overview
- `GET /llms-full.txt` -> This complete documentation file
- `GET /sitemap.xml` -> XML sitemap for search crawlers

---

## 7. Security & Anti-Abuse Controls
- **Noindex on Dashboard Routes**: All `/learn/*`, `/contributor/*`, and `/admin/*` routes contain `robots: noindex, nofollow` headers and meta tags.
- **Server-Authoritative Fulfillment**: Course unlocking is strictly triggered by server-verified payment confirmations, never client-side URL redirects.
- **Atomic Balance Withdrawals**: Withdrawal requests reserve funds immediately to prevent double-spending.
