TIFNGK_E41222722/QUICK_START.md

2.9 KiB

🚀 QUICK START - Database Integration

Langkah 1: Setup Database (First Time Only)

Jalankan script setup database:

python setup_db.py

Output yang diharapkan:

✓ Database 'deteksi_pmk' created/verified
✓ Database tables created/verified
✓ Database setup completed successfully!

Langkah 2: Jalankan Aplikasi

python app.py

Buka browser ke: http://localhost:5000

Deploy ke Railway

Repository ini sudah disiapkan untuk Railway dengan entrypoint Flask di app.py.

  1. Hubungkan repository ini ke Railway.
  2. Tambahkan layanan database MySQL di Railway jika ingin penyimpanan riwayat berjalan.
  3. Set environment variable berikut di Railway:
    • FLASK_SECRET
    • DATABASE_URL atau MYSQLHOST, MYSQLPORT, MYSQLUSER, MYSQLPASSWORD, MYSQLDATABASE
  4. Railway akan menjalankan gunicorn app:app --bind 0.0.0.0:$PORT.

Catatan:

  • opencv-python-headless dipakai supaya build Railway tidak bergantung pada library GUI.
  • Jika model belum ada di folder models/, jalankan training dulu sebelum deploy.

Langkah 3: Upload Gambar & Lihat Riwayat

  1. Upload: Klik "Upload Gambar" → Pilih file → Upload
  2. Hasil disimpan otomatis ke database MySQL
  3. Lihat Riwayat: Klik "Riwayat Deteksi"
  4. Detail: Klik tombol "Detail" untuk melihat hasil lengkap

📋 Fitur Baru

MySQL Database - Penyimpanan data terstruktur Detail Riwayat - Lihat hasil lengkap setiap deteksi Feature Display - Lihat fitur-fitur yang dianalisis Automatic Backup - CSV sebagai fallback Real-time Stats - Statistik dari database

⚙️ Konfigurasi

Edit .env jika ingin ubah MySQL settings:

DB_HOST=localhost
DB_USER=root
DB_PASSWORD=
DB_NAME=deteksi_pmk

Untuk Railway, lebih aman pakai variabel environment yang disediakan oleh plugin database atau `DATABASE_URL`.

🔗 Useful Routes

URL Deskripsi
/ Halaman Beranda
/upload Upload Gambar
/riwayat_deteksi Riwayat Deteksi (List)
/detail-deteksi/1 Detail Riwayat (ID=1)
/expert-system Sistem Pakar

🆘 Jika Ada Error

Error: "MySQL not available"

  • Jalankan: python setup_db.py
  • Pastikan MySQL server running

Error: "Cannot connect to database"

  • Cek .env configuration
  • Pastikan DB_HOST, DB_USER, DB_password benar

Error: "Unknown database"

  • Jalankan: python setup_db.py

Memory load error?

  • Restart Python: python app.py

📁 File Penting

  • app.py - Main application
  • .env - Database configuration
  • utils/mysql_db.py - Database operations
  • setup_db.py - Database setup script
  • templates/detail_deteksi.html - Detail page

Done!

Database integration sudah selesai. Aplikasi siap digunakan dengan penyimpanan data MySQL yang aman dan terstruktur.


Untuk dokumentasi lengkap, lihat:

  • DATABASE_SETUP.md - Setup guide lengkap
  • DATABASE_INTEGRATION_SUMMARY.md - Summary fitur baru