TKK_E32231503/backend/RAILWAY_MYSQL_SETUP.md

🚂 Railway MySQL Setup Guide

📋 Environment Variables di Railway

Railway menyediakan environment variables dengan format yang berbeda tergantung cara setup MySQL.

Format 1: Railway MySQL Plugin (Recommended)

Jika Anda menggunakan Railway MySQL Plugin, Railway otomatis menyediakan:

MYSQLHOST=containers-us-west-xxx.railway.app
MYSQLPORT=6543
MYSQLUSER=root
MYSQLPASSWORD=xxxxxxxxxxxxx
MYSQLDATABASE=railway

✅ Backend sudah support format ini! Tidak perlu setting manual.

---

Format 2: DATABASE_URL

Beberapa Railway service menyediakan DATABASE_URL:

DATABASE_URL=mysql://root:password@host:port/database

✅ Backend sudah support format ini! Tidak perlu setting manual.

---

Format 3: MYSQL_URL

Alternative format:

MYSQL_URL=mysql://root:password@host:port/database

✅ Backend sudah support format ini! Tidak perlu setting manual.

---

Format 4: Custom Variables (Local Development)

Untuk development lokal, gunakan:

DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=your_password
DB_NAME=pengering_ikan

✅ Backend sudah support format ini!

---

🚀 Setup Railway MySQL

Opsi 1: Menggunakan Railway MySQL Plugin (Recommended)

1. Buka Railway Dashboard

   • Go to your project
   • Click "New" → "Database" → "Add MySQL"

2. Railway akan otomatis:

   • Create MySQL database
   • Set environment variables:
     • MYSQLHOST
     • MYSQLPORT
     • MYSQLUSER
     • MYSQLPASSWORD
     • MYSQLDATABASE

3. Link ke Service Anda:

   • Railway otomatis link database ke service
   • Environment variables tersedia di service

4. Deploy:

   • Push code ke GitHub
   • Railway auto-deploy
   • Backend otomatis connect ke MySQL

✅ DONE! Backend akan otomatis detect dan gunakan variables ini.

---

Opsi 2: Menggunakan External MySQL (Aiven, PlanetScale, dll)

1. Dapatkan Connection String:

   mysql://user:password@host:port/database
   

2. Set di Railway:

   • Go to your service
   • Click "Variables"
   • Add variable:
     • Name: DATABASE_URL
     • Value: mysql://user:password@host:port/database

3. Deploy:

   • Railway auto-redeploy
   • Backend otomatis connect

✅ DONE!

---

🔍 Cek Connection di Railway

1. Lihat Logs

Di Railway Dashboard:

• Go to your service
• Click "Deployments"
• Click latest deployment
• View logs

Cari log:

📦 Using MYSQLHOST for connection
🔧 Database Config: { host: '...', port: 3306, ... }
✅ Database connected successfully
✅ Database tables initialized

2. Test via API

Setelah deploy, test endpoint:

# Test connection
curl https://your-app.railway.app/api/database/test

# Response jika berhasil:
{
  "success": true,
  "message": "Database connection successful"
}

3. Initialize Tables

Jika belum ada tabel, initialize:

curl -X POST https://your-app.railway.app/api/database/init

# Response:
{
  "success": true,
  "message": "Database tables initialized successfully"
}

---

🛠️ Troubleshooting

Error: "Database connection failed"

Cek 1: Environment Variables

# Di Railway Dashboard → Variables, pastikan ada salah satu:
# - MYSQLHOST, MYSQLPORT, MYSQLUSER, MYSQLPASSWORD, MYSQLDATABASE
# - DATABASE_URL
# - MYSQL_URL

Cek 2: MySQL Service Running

# Di Railway Dashboard, pastikan MySQL service status = "Active"

Cek 3: Network Access

# Pastikan Railway service bisa akses MySQL
# Jika pakai external MySQL, cek firewall/whitelist

---

Error: "Access denied for user"

Solusi:

1. Cek username dan password benar
2. Cek user punya permission ke database
3. Jika pakai Railway MySQL Plugin, coba restart service

---

Error: "Unknown database"

Solusi:

1. Database belum dibuat
2. Jika pakai Railway MySQL Plugin, database otomatis dibuat dengan nama railway
3. Jika pakai external MySQL, buat database manual:

   CREATE DATABASE pengering_ikan;
   

---

Error: "Too many connections"

Solusi:

1. Backend sudah pakai connection pool (max 10 connections)
2. Jika masih error, cek MySQL max_connections setting
3. Atau upgrade Railway plan untuk lebih banyak connections

---

📊 Database Schema

Backend otomatis create 3 tables:

1. sensor_data

CREATE TABLE sensor_data (
  id INT AUTO_INCREMENT PRIMARY KEY,
  suhu FLOAT NOT NULL,
  berat FLOAT NOT NULL,
  target FLOAT NOT NULL,
  relay1 BOOLEAN DEFAULT FALSE,
  relay2 BOOLEAN DEFAULT FALSE,
  relay3 BOOLEAN DEFAULT FALSE,
  relay4 BOOLEAN DEFAULT FALSE,
  status VARCHAR(50) DEFAULT 'DISCONNECTED',
  timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
  INDEX idx_timestamp (timestamp)
);

2. status_history

CREATE TABLE status_history (
  id INT AUTO_INCREMENT PRIMARY KEY,
  message TEXT NOT NULL,
  timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
  INDEX idx_timestamp (timestamp)
);

3. control_commands

CREATE TABLE control_commands (
  id INT AUTO_INCREMENT PRIMARY KEY,
  command VARCHAR(50) NOT NULL,
  source VARCHAR(50) DEFAULT 'API',
  timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
  INDEX idx_timestamp (timestamp)
);

---

🎯 Best Practices

1. Gunakan Railway MySQL Plugin

• ✅ Otomatis setup
• ✅ Otomatis backup
• ✅ Otomatis scaling
• ✅ Gratis untuk development

2. Set Connection Pool

Backend sudah set:

connectionLimit: 10  // Max 10 concurrent connections

3. Regular Cleanup

Backend punya endpoint untuk clear old data:

curl -X DELETE https://your-app.railway.app/api/history/clear

4. Monitor Logs

Cek Railway logs secara berkala untuk detect issues early.

---

📝 Checklist Setup

• Railway MySQL Plugin installed
• Environment variables tersedia
• Backend deployed
• Test /api/database/test berhasil
• Initialize tables via /api/database/init
• Test insert data via ESP32
• Test query data via /api/data/latest

---

🆘 Need Help?

1. Cek Railway Logs untuk error messages
2. Cek Environment Variables di Railway Dashboard
3. Test Connection via /api/database/test
4. Check MySQL Status di Railway Dashboard

---

🎉 Done!

Setelah setup berhasil:

• ✅ Backend otomatis connect ke MySQL
• ✅ Tables otomatis dibuat
• ✅ Data dari ESP32 otomatis tersimpan
• ✅ Flutter app bisa query data via API

Selamat! 🚀