# CONTEXT.md - Of The Soul

Dokumentasi arsitektur dan spesifikasi desain web esai editorial "Of The Soul".

---

## 1. Visi & Karakteristik Desain

- **Nama**: Of The Soul
- **Fungsi**: Web penerbitan & arsip tulisan esai mendalam
- **Tema Visual**: Gelap, eksistensial, melankolis, puitis (estetika band Hindia: *Menari Dengan Bayangan*, *Lagipula Hidup Akan Berakhir*)
- **Simbol Utama**: Gagak hitam (Raven) - siluet tajam, sayap, bulu, kesendirian
- **Palet Warna**:
  - Background: Pitch black `#070708`, Charcoal deep `#0f1012`, Card surface `#16171a`
  - Teks: Bone white `#ece8e1` (utama), Ash gray `#8e8c89` (meta/waktu baca)
  - Aksen: Crimson / Oxblood red `#931b1b` (hover, kutipan, aksen distopia)
  - Garis: Subdued border `rgba(255, 255, 255, 0.08)`
- **Tipografi**:
  - Judul & Body esai: Editorial Serif (Playfair / Cormorant / Garamond self-hosted)
  - Metadata & Label: Monospace (JetBrains Mono / Space Mono)
- **Tekstur**: Analog Film Grain (SVG noise filter lokal)
- **Atmosfer**: Ambient sound player opsional (suara hujan/tape hiss lokal, default mute)

### Dials (taste-skill)
- `DESIGN_VARIANCE: 7` (Editorial asimetris, stark, non-generic)
- `MOTION_INTENSITY: 4` (Atmospheric reveal halus, transisi tenang)
- `VISUAL_DENSITY: 3` (Spacious editorial, fokus kenyamanan membaca)

---

## 2. Kendala Teknis & Infrastruktur

1. **Akses China (Great Firewall Resilient)**:
   - Zero eksternal CDN (larang Google Fonts CDN, cdnjs, unpkg luar yang berisiko diblokir atau lambat di China).
   - Seluruh font, ikon SVG, CSS, dan JS disimpan 100% lokal di server.
2. **Hosting & Lingkungan**:
   - Server: Self-hosted LAMP/LEMP (cPanel / Apache / Nginx)
   - Runtime: PHP (>= 7.4 / 8.x)
   - Database: MySQL / MariaDB (dikelola lewat phpMyAdmin)

---

## 3. Arsitektur Komponen

```
/
├── config.php            # Koneksi database MySQL & kredensial admin
├── db.php                # Helper PDO & query helper
├── schema.sql            # Script skema tabel untuk phpMyAdmin
├── index.php             # Landing page utama (Hero, Featured, Archive, Reader)
├── essay.php             # Halaman baca esai tunggal (permalink/SEO)
├── admin.php             # Panel admin (Login, Buat, Edit, Hapus esai)
├── assets/
│   ├── css/
│   │   ├── style.css     # Design system, grain, typography, dark theme
│   │   └── admin.css     # Styling admin dashboard
│   ├── js/
│   │   ├── main.js       # Interaksi reader modal, filter, audio ambience
│   │   └── admin.js      # Pratinjau esai live & auto-slug
│   ├── fonts/            # Self-hosted webfonts
│   ├── audio/            # File ambience audio lokal (rain/tape hiss)
│   └── img/              # SVG siluet gagak & artwork
```

---

## 4. Skema Database (`schema.sql`)

```sql
CREATE TABLE IF NOT EXISTS essays (
    id INT AUTO_INCREMENT PRIMARY KEY,
    slug VARCHAR(120) NOT NULL UNIQUE,
    title VARCHAR(255) NOT NULL,
    excerpt TEXT NOT NULL,
    quote VARCHAR(255) DEFAULT NULL,
    content MEDIUMTEXT NOT NULL,
    category VARCHAR(60) DEFAULT 'Refleksi',
    reading_time INT DEFAULT 5,
    status ENUM('published', 'draft') DEFAULT 'published',
    views INT DEFAULT 0,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
```

---

## 5. Fitur Utama

1. **Hero Gagak & Identitas "Of The Soul"**:
   - Header minimalis dengan toggle Audio Ambience (Hujan / Tape Hiss)
   - Tipografi besar dengan kutipan puitis bernuansa distopia/eksistensial
   - Siluet gagak interaktif berbasis SVG inline
2. **Esai Unggulan (Featured Essay)**:
   - Penyorotan esai utama dengan tata letak editorial asimetris
3. **Arsip & Filter Esai**:
   - Filter kategori (Refleksi, Kota & Jiwa, Kematian & Waktu, Musik & Rasa)
   - Waktu baca, tanggal publikasi, ringkasan tajam
4. **Distraction-Free Reader**:
   - Pembaca modal cepat tanpa refresh halaman
   - Halaman permalink standalone via `essay.php?slug=...`
5. **Panel Admin Terproteksi**:
   - Otentikasi sesi password
   - Editor tulisan dengan live preview
   - Pengelolaan draft & publish
