📚 KF13 Citation Checker

AI-powered citation finder and validator for Indonesian physics research community.

🎯 Overview: Evolusi Menuju CORM

CORM (Citation Platform for Digital Lab Researcher), sebelumnya dikenal sebagai Citation, adalah evolusi platform riset digital yang dirancang sebagai "laboratorium digital" bagi peneliti Indonesia.

Kami bertransformasi dari sekadar mesin pencari sitasi menjadi ekosistem riset yang lengkap:

• 🧪 Digital Lab: Tempat mengumpulkan, memvalidasi, dan mengolah referensi.
• 🤝 Collaboration Hub: Berbagi koleksi riset ("Rak Buku Digital") dengan pembimbing/rekan.
• 🎓 Verified Portfolio: Jejak rekam digital karir penelitian Anda (Visi masa depan).
• 🇮🇩 Indonesian Context: Fokus pada database dan kebutuhan akademik lokal (BRIN, IJP).

✨ Key Features

🔍 Smart Discovery & Triage

• AI-Powered Search: Integrasi Perplexity API untuk jawaban kontekstual.
• Local Integration: Akses ke database jurnal fisika Indonesia.
• Citation Finding: Temukan "Emas" (paper valid) di antara tumpukan data.

📱 Mobile First Experience ✨ NEW

• Touch-Optimized: Navigasi carousel yang fluid dengan native scroll snap.
• Zero-Loading Navigation: Transisi instan antar halaman publik tanpaloading spinner.
• Responsive Design: Tampilan yang menyesuaikan diri dari ponsel hingga desktop besar.

📝 Blog & Knowledge Base ✨ NEW

• Rich Technical Content: Dukungan penuh untuk MDX, LaTeX Math ($E=mc^2$), dan Mermaid Diagrams.
• SEO & Schema: Implementasi JSON-LD (FAQ, Article, Organization) untuk visibilitas maksimal.
• Educational Resources: Tutorial alur kerja riset modern.

📊 Analysis & Validation

• Quality Assessment: Scoring otomatis untuk kredibilitas sumber.
• Format Validation: Validasi otomatis format IEEE, APA, dll.
• AI Summary: Ringkasan instan dari abstrak paper panjang.

👤 User Management (Auth.js)

• Academic Login: Dukungan Google OAuth dan email akademik.
• Role-Based: Akses khusus untuk Dosen, Mahasiswa, dan Peneliti Umum.
• Personal Library: Simpan dan organisir sitasi dalam koleksi pribadi.

🚀 Tech Stack

• Framework: Next.js 16 (App Router + Turbopack)
• Language: TypeScript (Strict Mode)
• Styling: Tailwind CSS, Shadcn UI, Framer Motion (Animations)
• Auth: Auth.js (NextAuth v5 Beta)
• Database: Turso (LibSQL) + Drizzle ORM
• AI Integration: Vercel AI SDK, Perplexity API
• Content: MDX Remote, Rehype/Remark Plugins
• Deployment: Vercel Edge Network

📁 Project Structure

Struktur proyek telah direfaktor untuk skalabilitas dan kejelasan:

citation/
├── content/                 # MDX files for Blog
├── public/                  # Static assets & OG Images
├── src/
│   ├── app/
│   │   ├── (marketing)/     # Public pages (Home, About, Blog, Features, Guide, FAQ)
│   │   ├── (platform)/      # Protected App pages (Dashboard, Project, Profile)
│   │   ├── api/             # API Routes (AI Chat, Search, Auth)
│   │   └── layout.tsx       # Root Layout with Providers
│   ├── components/          # Reusable UI Components
│   ├── lib/                 # Core logic, Utils, & DB Config
│   └── types/               # TypeScript Definitions
├── drizzle.config.ts        # Database Schema Config
└── next.config.mjs          # Next.js Configuration

🛠️ Development

# Install dependencies (pnpm recommended)
pnpm install

# Run development server (Turbopack enabled)
pnpm dev

# Build for production
pnpm build

# Database Management
pnpm db:generate    # Generate SQL migrations
pnpm db:push        # Push schema to Turso
pnpm db:studio      # Open visual database editor

🔑 Environment Variables

Pastikan Anda memiliki .env file dengan konfigurasi berikut:

# AI Services
PERPLEXITY_API_KEY=your_key
OPENAI_API_KEY=your_key (Optional)

# Database
TURSO_DATABASE_URL=libsql://...
TURSO_AUTH_TOKEN=...

# Auth & App
NEXTAUTH_SECRET=your_secret
NEXTAUTH_URL=http://localhost:3000
GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...

🎯 Roadmap: Toward CORM Ecosystem

Phase 1-3: Foundation (Completed)

• Core Search & Validation Engine
• AI Integration (Perplexity)
• User System & Database

Phase 4: Optimization & Experience (Completed) ✅

• Mobile UX Overhaul: Carousel implementations & Responsive layouts.
• Content Engine: Blog system with Math & Diagrams support.
• Performance: Zero-loading masking for public pages.
• Architecture: Route grouping (marketing) vs (platform).

Phase 5: The Digital Lab (Next)

• Document Export: Generate Google Docs/Word dari koleksi sitasi.
• Research Collaboration: Shared Collections ("Rak Buku Digital").
• Verified Badge: Integrasi verifikasi peneliti (BRIN).

🤝 Contributing

Kami mengundang kontribusi dari seluruh komunitas open-source Indonesia.

1. Fork repository ini.
2. Buat feature branch (git checkout -b fitur-keren).
3. Commit perubahan (git commit -m 'feat: tambah fitur keren').
4. Push ke branch (git push origin fitur-keren).
5. Buka Pull Request.

📄 License

MIT License - Open Source untuk kemajuan pendidikan Indonesia.

---

🇮🇩 Built with ❤️ by Klub Fisika Indonesia