KF13 Community Platform

Wadah eksploratif yang memfasilitasi kolaborasi ilmiah dari tingkat SMP hingga pascasarjana — demi masyarakat yang terbuka akan sains, informasi, dan penelitian yang dapat saling diverifikasi.

Monorepo untuk dua produk terintegrasi: platform sosial media dan arsip riset terpadu — diinisiasi oleh Klub Fisika Indonesia, sebuah yayasan non-profit independen, dan dirancang untuk dimiliki bersama oleh komunitas.

---

Navigasi Cepat

Dokumen	Deskripsi
🏗️ ARCHITECTURE.md	Arsitektur teknis — database, auth, submodule
🔐 AUTH.md	Shared auth: Community sebagai auth provider, Index via API
💻 DEVELOPMENT.md	Setup, env, workflow development, deployment
📋 DECISIONS.md	Log keputusan teknis & rationale
📖 VISION.md	Visi lengkap, mengapa platform ini dibangun, roadmap
🏛️ GOVERNANCE.md	Tata kelola, peran, proses pengambilan keputusan
💰 FUNDING.md	Strategi pendanaan, grant, cara berkontribusi finansial
📣 OUTREACH.md	Strategi promosi ke pemerintah, institusi, komunitas global
🤝 CONTRIBUTING.md	Cara berkontribusi — kode, dokumentasi, desain, ide
💬 Discussions	Forum diskusi terbuka untuk komunitas
🐛 Issues	Bug report, feature request, RFC

---

Visi

Dimensi	Produk	Analogi
Siapa kamu — jejaring, diskusi, reputasi	apps/platform	LinkedIn × Kaskus untuk ilmuwan Indonesia
Apa karyamu — publikasi, verifikasi, sitasi	apps/index	SINTA untuk jenjang SD–SMA/SMK

Keduanya berbagi satu identitas pengguna. Seorang peneliti muda yang aktif berdiskusi di platform akan otomatis terhubung dengan karya ilmiahnya di index — dan sebaliknya, karya yang terverifikasi akan memperkuat kredibilitas profilnya.

Baca VISION.md untuk penjelasan mendalam tentang mengapa platform ini dibangun.

---

Arsitektur

┌──────────────────────────────────────────────────────────────┐
│        github.com/openriset/community (monorepo root)         │
├──────────────────────────────────────────────────────────────┤
│                                                              │
│  apps/platform                     apps/index                │
│  ┌──────────────────┐             ┌──────────────────┐       │
│  │  Qwik City       │             │  SvelteKit 2     │       │
│  │  Better Auth     │◄─── API ────│  Drizzle ORM     │       │
│  │  Tailwind CSS 4  │ auth        │  Paraglide i18n  │       │
│  │  KaTeX · Mermaid │ validation  │  Tailwind CSS 4  │       │
│  │                  │             │  mdsvex          │       │
│  │  PLATFORM SOSIAL │             │  ARSIP RISET     │       │
│  │  • feed & diskusi│             │  • indeks karya  │       │
│  │  • proyek        │             │  • verifikasi    │       │
│  │  • gamifikasi    │             │  • sitasi        │       │
│  │  • onboarding    │             │  • portofolio    │       │
│  └────────┬─────────┘             └────────┬─────────┘       │
│           │                                │                 │
│           ▼                                ▼                 │
│  ┌──────────────────┐             ┌──────────────────┐       │
│  │  Community DB    │             │  Index DB        │       │
│  │  user, session   │             │  research_works  │       │
│  │  profiles, posts │             │  authors, tags   │       │
│  │  projects, ...   │             │  citations, ...  │       │
│  └──────────────────┘             └──────────────────┘       │
│                                                              │
│  packages/                                                   │
│  ┌──────────────────────────────────────────────────────┐   │
│  │  @kf13/auth · @kf13/db                               │   │
│  └──────────────────────────────────────────────────────┘   │
│                                                              │
└──────────────────────────────────────────────────────────────┘

---

Struktur Repository

community/
├── apps/
│   ├── platform/          → github.com/klubfisika/platform (Qwik City)
│   └── index/             → github.com/klubfisika/index (SvelteKit)
├── packages/              → @kf13/auth, @kf13/db
├── docs/
│   ├── ARCHITECTURE.md    → arsitektur teknis
│   ├── AUTH.md            → detail shared auth
│   ├── DEVELOPMENT.md     → workflow development
│   ├── DECISIONS.md       → log keputusan teknis
│   ├── VISION.md          → visi lengkap & roadmap
│   ├── GOVERNANCE.md      → tata kelola komunitas
│   ├── FUNDING.md         → strategi pendanaan
│   └── OUTREACH.md        → strategi promosi & advokasi
├── .github/
│   └── ISSUE_TEMPLATE/
├── CONTRIBUTING.md
├── .gitmodules
└── README.md

Path	Repository	Stack
apps/platform	klubfisika/platform	Qwik City · Neon · Tailwind 4
apps/index	klubfisika/index	SvelteKit · Drizzle · Paraglide

---

Memulai

Prasyarat

• bun ≥ 1.x
• Node.js ≥ 18 (untuk Qwik)
• Akun Neon untuk PostgreSQL (free tier cukup)

Clone

git clone --recurse-submodules git@github.com:openriset/community.git
cd community

Development

# Dari root monorepo:
bun run dev:platform   # Platform (Community) → http://localhost:5173
bun run dev:index      # Index (Arsip Riset) → http://localhost:5173

# Setup masing-masing:
# Index
cd apps/index
bun install
cp .env.example .env
# isi: DATABASE_URL (Index DB), AUTH_ORIGIN (Community origin), ORIGIN
bun run dev

# Platform
cd apps/platform
bun install
cp .env.example .env.local
# isi: DATABASE_URL (Community DB), BETTER_AUTH_SECRET, ORIGIN
bun run dev

Catatan: Index dan Platform menggunakan database Neon PostgreSQL yang berbeda. Auth dikelola oleh Community (Platform). Index memvalidasi session via API call ke Community — tidak ada koneksi DB langsung. Lihat AUTH.md untuk detail.

Lihat CONTRIBUTING.md untuk panduan setup lengkap.

---

DNA Produk

🥒 Gamifikasi Kaskus

Platform menggunakan sistem reputasi terinspirasi Kaskus:

• Cendol (🥒) — apresiasi positif, endorsement berbobot berbasis kontribusi
• Bata (🧱) — feedback negatif untuk konten tidak berkualitas
• Rank progression: Newbie → Kaskuser → Aktivis → Kaskus Holic → Kaskus Addict → Kaskus Maniac → Kaskus Geek
• Emoticon parser: 18 emote Kaskus-style (:cendol:, :ngakak:, :pertamax:, dll)

🔬 Kredibilitas Terverifikasi

Tidak seperti platform sosial pada umumnya, kredibilitas di KF13 ditentukan oleh karya nyata:

• Diskusi dan kontribusi di platform → reputasi sosial
• Karya ilmiah terindeks di index → kredibilitas akademik
• Keduanya terintegrasi dalam satu profil

---

Prinsip

• Terbuka & non-profit — tidak terafiliasi, tidak didanai pihak manapun
• Milik komunitas — diinisiasi Klub Fisika, dirancang untuk dimiliki dan dikelola bersama
• Verifikasi ketat dengan audit terbuka — keamanan, transparansi, dan kenyamanan bersama
• Kids-friendly — pengawasan wali/mentor/orangtua untuk pengguna di bawah umur
• Terinspirasi oleh: Ki Hajar Dewantara, HOS Cokroaminoto, BJ Habibie, Prof Yohanes Surya

---

Beyond Klub Fisika — Menuju Platform Komunitas

Domain Saat Ini Hanya Titik Awal

Platform saat ini berjalan di bawah domain klubfisika.or.id sebagai titik awal fase beta, karena Klub Fisika Indonesia adalah inisiator yang menyediakan infrastruktur dan sumber daya pertama. Ini bukan identitas permanen.

Visi jangka panjang: Platform ini tidak bergantung pada, dan tidak dikontrol oleh, satu entitas tunggal — termasuk Klub Fisika Indonesia sendiri.

SEKARANG (Beta)                        MASA DEPAN (Komunitas)
──────────────────────────             ──────────────────────────────
Inisiator : Klub Fisika Indonesia      Governance : multi-stakeholder
Domain    : klubfisika.or.id           Domain     : independen / netral
Maintainer: tim internal               Maintainer : komunitas terbuka
Funding   : mandiri (unit usaha)       Funding    : komunitas + institusi
Kontributor: terbatas                  Kontributor: dari mana saja

Komitmen Klub Fisika Indonesia

• Kode tetap open-source (MIT) tanpa syarat dan tanpa perubahan lisensi
• Tidak mengunci platform ke infrastruktur atau layanan proprietary
• Semua keputusan teknis dan arsitektur didokumentasikan secara terbuka
• Kontributor dari luar Klub Fisika disambut dengan setara

Platform ini dibangun bukan untuk menjadi produk Klub Fisika. Ia dibangun untuk menjadi infrastruktur bersama ekosistem riset Indonesia.

---

Cara Terlibat

Sebagai Developer

→ Baca CONTRIBUTING.md, cari issue berlabel good first issue

Sebagai Peneliti / Akademisi

→ Buka Discussion dan share perspektif domain Anda

Sebagai Guru / Pendidik

→ Hubungi via Discussion — kami butuh feedback dari ground level

Sebagai Organisasi / Institusi

→ Baca OUTREACH.md untuk opsi kemitraan

Sebagai Donatur / Funder

→ Baca FUNDING.md untuk cara mendukung platform ini

---

Kontribusi

Lihat CONTRIBUTING.md untuk panduan lengkap.

Komunitas pengembang dapat memulai dari:

1. Clone monorepo ini dengan --recurse-submodules
2. Pilih area kontribusi: apps/platform atau apps/index
3. Baca README di masing-masing submodule
4. Buat pull request ke repository terkait

Untuk kolaborasi institusional, diskusi terbuka, atau pertanyaan tentang adopsi platform — buka GitHub Discussions.

---

Lisensi

MIT — kode bebas digunakan, dimodifikasi, dan didistribusikan ulang tanpa syarat afiliasi.

---

_{Diinisiasi oleh Klub Fisika Indonesia — dimaintain bersama komunitas
Arsitektur · Auth · Visi · Governance · Funding · Outreach · Kontribusi}