api-btekno/DEPLOYMENT.md

# Deployment Guide - Production

## ⚠️ PENTING: Vendor Folder

**Vendor folder TIDAK di-commit ke git repository!**

Setiap kali deploy atau pull code baru, **WAJIB** jalankan:

```bash
composer install --no-dev --optimize-autoloader
```

## 🚀 Quick Deployment Steps

### 1. First Time Deployment

```bash
# 1. Clone repository
cd /www/wwwroot/api.btekno.cloud
git clone https://git.btekno.cloud/kangmin/api-btekno.git api

# 2. Masuk ke folder project
cd api

# 3. WAJIB: Install dependencies
composer install --no-dev --optimize-autoloader

# 4. Setup environment
cp .env.example .env
nano .env  # Edit dengan konfigurasi production

# 5. Apply migrations (dari folder project root)
cd /www/wwwroot/api.btekno.cloud/api
mysql -u sql_retribusi -p sql_retribusi < ./migrations/001_create_audit_logs.sql
mysql -u sql_retribusi -p sql_retribusi < ./migrations/002_create_hourly_summary.sql
mysql -u sql_retribusi -p sql_retribusi < ./migrations/003_create_realtime_events.sql

# Atau menggunakan path absolut:
mysql -u sql_retribusi -p sql_retribusi < /www/wwwroot/api.btekno.cloud/api/migrations/001_create_audit_logs.sql
mysql -u sql_retribusi -p sql_retribusi < /www/wwwroot/api.btekno.cloud/api/migrations/002_create_hourly_summary.sql
mysql -u sql_retribusi -p sql_retribusi < /www/wwwroot/api.btekno.cloud/api/migrations/003_create_realtime_events.sql

# 6. Set permissions
chown -R www:www /www/wwwroot/api.btekno.cloud/api
chmod -R 755 /www/wwwroot/api.btekno.cloud/api
```

### 2. Update Deployment (Setelah Pull Code)

```bash
# 1. Pull latest code
cd /www/wwwroot/api.btekno.cloud/api
git pull origin main

# 2. WAJIB: Update dependencies (jika ada perubahan composer.json)
composer install --no-dev --optimize-autoloader

# 3. Regenerate autoloader
composer dump-autoload --optimize

# 4. Clear cache (jika ada)
# Tidak ada cache untuk project ini, skip
```

### 3. Setup aaPanel

1. **Create Website**:

   - Domain: `api.btekno.cloud`
   - DocumentRoot: `/www/wwwroot/api.btekno.cloud/api/public`
   - PHP Version: 8.2 atau 8.3

2. **PHP Settings**:

   - Enable `extension=pdo_mysql`
   - Enable `extension=mbstring`
   - Memory limit: 256M (minimum)

3. **Nginx Configuration** (PENTING untuk fix 404):
   
   Masuk ke: **Website -> api.btekno.cloud -> Settings -> Configuration**
   
   Ganti isi configuration dengan:
   ```nginx
   server {
       listen 80;
       listen 443 ssl http2;
       server_name api.btekno.cloud;
       
       # Document Root - HARUS ke folder public/
       root /www/wwwroot/api.btekno.cloud/api/public;
       index index.php index.html;
       
       # Logs
       access_log /www/wwwlogs/api.btekno.cloud.log;
       error_log /www/wwwlogs/api.btekno.cloud.error.log;
       
       # Disable access to hidden files
       location ~ /\. {
           deny all;
           access_log off;
           log_not_found off;
       }
       
       # Main location block - routing untuk Slim Framework
       location / {
           try_files $uri $uri/ /index.php?$query_string;
       }
       
       # PHP-FPM configuration
       location ~ \.php$ {
           try_files $uri =404;
           fastcgi_split_path_info ^(.+\.php)(/.+)$;
           fastcgi_pass unix:/tmp/php-cgi-83.sock;  # Sesuaikan dengan PHP version (83, 82, dll)
           fastcgi_index index.php;
           fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
           include fastcgi_params;
           
           # Disable buffering for SSE
           fastcgi_buffering off;
       }
       
       # Disable PHP execution in uploads
       location ~* /uploads/.*\.php$ {
           deny all;
       }
   }
   ```
   
   **Cek PHP socket path:**
   ```bash
   # Cek PHP version yang digunakan
   php -v
   
   # Cek socket path (biasanya di /tmp/php-cgi-XX.sock)
   ls -la /tmp/php-cgi-*.sock
   ```
   
   Setelah edit, klik **Save** dan **Reload** nginx.
   
   **Atau copy file `nginx.conf.example` dan sesuaikan path PHP socket.**

## 🔧 Environment Configuration

Edit `.env` file:

```env
APP_ENV=production
APP_DEBUG=false

# Database
DB_HOST=localhost
DB_NAME=sql_retribusi
DB_USER=sql_retribusi
DB_PASS=your_secure_password

# JWT
JWT_SECRET=generate-random-secure-string-here
JWT_TTL_SECONDS=3600
JWT_ISSUER=api-btekno

# API Key
RETRIBUSI_API_KEY=generate-secure-api-key-here
```

**Generate secure keys:**

```bash
# JWT Secret (min 32 characters)
openssl rand -base64 32

# API Key
openssl rand -hex 32
```

## 📋 Cron Jobs Setup

Setup di aaPanel → Cron:

```cron
# Daily summary (run at 1 AM every day)
0 1 * * * cd /www/wwwroot/api.btekno.cloud/api && /www/server/php/83/bin/php bin/daily_summary.php

# Hourly summary (run at 1 AM every day)
0 1 * * * cd /www/wwwroot/api.btekno.cloud/api && /www/server/php/83/bin/php bin/hourly_summary.php
```

**Note**: Ganti `/www/server/php/83/bin/php` dengan path PHP yang sesuai di server Anda.

## ✅ Verification

Setelah deployment, test endpoint:

```bash
# Health check
curl https://api.btekno.cloud/health

# Should return:
# {"status":"ok","time":1735123456}
```

## 🐛 Common Issues

### Error: vendor/autoload.php not found

**Cause**: Vendor folder belum di-install  
**Solution**:

```bash
cd /www/wwwroot/api.btekno.cloud/api
composer install --no-dev --optimize-autoloader
```

### Error: Database connection failed

**Cause**: Database config salah di `.env`  
**Solution**:

- Cek `DB_HOST`, `DB_NAME`, `DB_USER`, `DB_PASS` di `.env`
- Test koneksi: `mysql -u sql_retribusi -p sql_retribusi`

### Error: JWT secret not set

**Cause**: `JWT_SECRET` kosong di `.env`  
**Solution**: Generate dan set JWT_SECRET di `.env`

### Error: Permission denied

**Cause**: File permission salah  
**Solution**:

```bash
chown -R www:www /www/wwwroot/api.btekno.cloud/api
chmod -R 755 /www/wwwroot/api.btekno.cloud/api
```

## 📊 Monitoring

- Check logs: `/www/wwwroot/api.btekno.cloud/api/logs/` (jika ada)
- Check PHP error log di aaPanel
- Monitor database size dan performance
- Monitor realtime_events table (cleanup old data jika perlu)

## 🔄 Rollback

Jika ada masalah setelah update:

```bash
# 1. Rollback ke commit sebelumnya
cd /www/wwwroot/api.btekno.cloud/api
git log --oneline  # Lihat commit history
git checkout <previous-commit-hash>

# 2. Reinstall dependencies
composer install --no-dev --optimize-autoloader

# 3. Test endpoint
curl https://api.btekno.cloud/health
```