SaaS SEO AI - Platform Optimasi SEO Cerdas

Platform Analitik SEO dan Strategi Konten Berbasis AI yang Komprehensif.
Dibangun dengan Next.js, Supabase, dan Deepseek AI untuk merevolusi cara Anda mengoptimasi peringkat pencarian.

---

Daftar Isi

• Ikhtisar
• Demo & Website Live
• Fitur Utama
• Arsitektur Sistem
• Teknologi yang Digunakan (Tech Stack)
• Panduan Instalasi
• Konfigurasi
• Panduan Deployment
• Struktur Folder
• Standar Kualitas Proyek
• FAQ & Penyelesaian Masalah
• Roadmap
• Ujian Akhir Semester (UAS) - Informasi Proyek
• Panduan Berkontribusi
• Keamanan
• Lisensi

---

Ikhtisar

SaaS SEO AI adalah platform canggih bertenaga AI yang dirancang untuk melakukan audit SEO otomatis, analisis kata kunci (keyword), dan pembuatan konten cerdas. Dengan memanfaatkan Large Language Models (LLM) modern, platform ini melampaui alat SEO statis tradisional dengan memberikan wawasan yang dapat langsung ditindaklanjuti dan disesuaikan dengan konteks untuk meningkatkan peringkat pencarian organik Anda secara signifikan.

---

Demo & Website Live

🌍 Website Produksi Live: seo.newsaint.web.id
🏢 Dikembangkan Oleh: Tim inti di bawah naungan newsaint.web.id

---

Fitur Utama

• Web Crawling Otomatis: Memindai URL target secara instan untuk mendiagnosis masalah teknis SEO.
• Rekomendasi Keyword Berbasis AI: Memanfaatkan pemahaman semantik untuk menghasilkan kata kunci yang sangat relevan dengan persaingan rendah.
• Pembuatan Konten Cerdas: Menyusun artikel, meta tag, dan deskripsi yang dioptimalkan untuk SEO secara otomatis.
• Dashboard Kelas Enterprise: Dashboard aplikasi Next.js yang didesain indah dan responsif untuk mengelola berbagai proyek.
• Integrasi Pembayaran Terpadu: Mendukung paket pengguna premium yang dikelola secara mulus melalui gateway pembayaran Midtrans.
• Autentikasi & RBAC (Role-Based Access Control): Sistem login yang sangat aman didukung oleh Supabase Auth dengan izin pengguna yang terperinci.

---

Arsitektur Sistem

graph TD
    User([Pengguna]) --> Frontend
    Frontend[Next.js App Router] --> NextAuth[Supabase Auth]
    Frontend --> APIs[Next.js API Routes]
    APIs --> DB[(Supabase PostgreSQL)]
    APIs --> AI[API Deepseek AI]
    APIs --> Payments[Gateway Midtrans]

Loading

---

Teknologi yang Digunakan (Tech Stack)

Framework Inti

• Frontend / Backend: Next.js 16 (App Router)
• Bahasa Pemrograman: TypeScript 5, React 19
• Styling: Tailwind CSS 4 + Radix UI Primitives

Database & Autentikasi

• Database: PostgreSQL
• BaaS (Backend-as-a-Service): Supabase (Auth, DB, RLS Policies)

Stack AI

• Model: API Deepseek
• Implementasi: Structured Prompting, Validasi Parsing JSON, Fallback Routing

Tooling

• Linting & Formatting: ESLint + Prettier

---

Panduan Instalasi

Persyaratan Sistem

• Node.js >= 18.17.0
• npm, yarn, atau pnpm
• Proyek Supabase aktif
• Kunci API (API Key) Deepseek

Memulai

1. Clone repositori ini:

   git clone https://github.com/ervareza/SaaS_SEO_AI.git
   cd SaaS_SEO_AI

2. Instal seluruh dependensi:

   npm install

3. Siapkan Environment Variables:

   cp .env.example .env.local

   Isi file .env.local dengan kunci Supabase dan Deepseek Anda.

4. Jalankan server pengembangan (development server):

   npm run dev

5. Buka browser Anda: Akses http://localhost:3000.

---

Konfigurasi

Untuk konfigurasi mendetail terkait Skema Database, API Keys, dan pengaturan Environment, silakan merujuk ke docs/configuration.md.

---

Standar Kualitas Proyek

Repositori ini telah direkayasa secara khusus untuk memenuhi standar rekayasa perangkat lunak yang ketat:

1. Kejelasan Problem, Target User, & Scope

   • Target User: Webmaster, Spesialis SEO, Pembuat Konten.
   • Problem: Audit SEO manual sangat memakan waktu, dan alat tradisional tidak memiliki pemahaman semantik untuk pembuatan konten.
   • Scope: Platform end-to-end yang mengelola proyek pengguna, pemindaian otomatis, dan generasi berbasis AI.

2. Kesesuaian Fitur dengan Problem

   • Fitur-fitur secara langsung mengatasi pain points (masalah utama): diagnostik crawler instan yang dipetakan secara langsung ke perbaikan AI otomatis. Tidak ada fitur kosmetik/gimmick.

3. Implementasi AI & Kualitas Integrasi

   • Rekayasa prompt (Prompt Engineering) disusun secara ketat untuk mengembalikan JSON yang telah dipilah dan diverifikasi.
   • Mekanisme fallback yang kuat menangani batas tingkat API (rate limits) dan halusinasi model dengan sangat baik.

4. Kualitas Engineering, Security, & Maintainability

   • Keamanan Utama: Parsing .env yang ketat, sanitasi data, rute API yang aman, dan Row Level Security (RLS) di Supabase.
   • Clean Architecture: Pemisahan Tanggung Jawab (Separation of Concerns) digunakan di seluruh App Router (Components, Hooks, Lib, API).

5. Dokumentasi & Reproducibility

   • Dokumentasi proyek komprehensif yang dirancang untuk memastikan kemudahan integrasi dan deployment bagi para kontributor maupun pengguna akhir.

---

Ujian Akhir Semester (UAS) - Informasi Proyek

Proyek ini diajukan untuk memenuhi persyaratan Ujian Akhir Semester (UAS) dengan rincian sebagai berikut:

Personel Kelompok (Maksimal 4 Personel)

Foto	Nama Lengkap	NIM	Peran / Deskripsi	GitHub
	Ervareza Naurian Novantila	24.01.53.0018	Founder, Lead Developer, Fullstack	@ervareza
	Adrianus Bagus Setiaji	24.01.53.0033	Backend Developer	@Fyxis
	Fathur Rohman	24.01.53.0030	Frontend Developer	@fthrrhmn19

Link & Informasi Penting

• 🌍 URL Aplikasi Live: seo.newsaint.web.id
• 📂 Poster Proyek UAS (Softcopy):
  • Poster 1 - Arsitektur Cloud Terpusat & Integrasi AI
  • Poster 2 - Detail Platform SaaS SEO AI

---

Tampilan Poster Proyek

Poster 1: Arsitektur Cloud Terpusat & Integrasi AI

Poster 2: Detail Platform SaaS SEO AI

---

Panduan Berkontribusi

Kami sangat menyambut kontribusi Anda! Silakan tinjau CONTRIBUTING.md kami untuk memulai. Dengan berpartisipasi, Anda setuju untuk mematuhi Kode Etik (Code of Conduct) kami.

Keamanan

Jika Anda menemukan kerentanan keamanan, harap merujuk pada kebijakan SECURITY.md kami untuk panduan pelaporan.

Lisensi

Proyek ini bersifat open-source dan dilisensikan di bawah MIT License.