OPEN-ISP v0.5 (pickle-lime) — rilis open-source perdana
Aplikasi billing & manajemen ISP (fiber optic) — PWA pelanggan, portal teknisi & kolektor, admin panel lengkap, multi-vendor OLT, RADIUS, WhatsApp/Telegram, pembayaran QRIS. Kredit & lisensi (ISC): - Base kode & repo: alijayanet/billing-rtrw oleh Alijaya Net — terima kasih banyak atas base kode dan repo yang bermanfaat. - Add-on: GoWA, LibreSpeed/OpenSpeedTest, Uptime Kuma, notification-forwarder. - Dikembangkan menjadi OPEN-ISP oleh oxpoe — https://github.com/oxpoe/open-isp
This commit is contained in:
oxpoe committed
commit
eaf05f2811
280 files changed
+123975
No files matched your search
@@ -0,0 +1,251 @@
|
||||
# Router Connection Flow - Tanpa Perlu Menambah di /admin/routers
|
||||
|
||||
## ✅ Jawaban: YA, SUDAH BISA!
|
||||
|
||||
Anda **tidak perlu** menambah router di `/admin/routers` jika sudah ada di `settings.json`. Sistem akan otomatis menggunakan `settings.json` sebagai fallback.
|
||||
|
||||
---
|
||||
|
||||
## Connection Priority (Urutan Koneksi)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ getConnection(routerId) dipanggil │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌──────────────────────────────────────┐
|
||||
│ Apakah routerId diberikan? │
|
||||
│ (misal: routerId = 1) │
|
||||
└──────────────────────────────────────┘
|
||||
│ YA │ TIDAK
|
||||
│ │
|
||||
▼ ▼
|
||||
┌──────────────────┐ ┌────────────────────────────────┐
|
||||
│ Cari di database │ │ Cari router aktif dari database│
|
||||
│ WHERE id = 1 │ │ WHERE is_active = 1 │
|
||||
└──────────────────┘ └────────────────────────────────┘
|
||||
│ │
|
||||
│ Ada │ Ada
|
||||
▼ ▼
|
||||
┌──────────────────┐ ┌────────────────────────────────┐
|
||||
│ Pakai router itu │ │ Pakai router dari database │
|
||||
│ dari database │ │ │
|
||||
└──────────────────┘ └────────────────────────────────┘
|
||||
│ │
|
||||
│ TIDAK ADA ▼
|
||||
│ ┌────────────────────────────────┐
|
||||
│ │ (Hubungan database ke MikroTik)│
|
||||
│ └────────────────────────────────┘
|
||||
│ │
|
||||
│ │ TIDAK ADA
|
||||
│ ▼
|
||||
│ ┌──────────────────────────┐
|
||||
│ │ FALLBACK ke settings.json│
|
||||
│ │ - mikrotik_host │
|
||||
│ │ - mikrotik_user │
|
||||
│ │ - mikrotik_password │
|
||||
│ │ - mikrotik_port │
|
||||
│ └──────────────────────────┘
|
||||
│ │
|
||||
└───────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────┐
|
||||
│ Hubung ke MikroTik │
|
||||
│ dengan credentials yang │
|
||||
│ sudah dipilih │
|
||||
└─────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Skenario Penggunaan
|
||||
|
||||
### Skenario 1: Anda HANYA punya `settings.json` (Satu Router)
|
||||
```json
|
||||
{
|
||||
"mikrotik_host": "192.168.8.1",
|
||||
"mikrotik_user": "ali",
|
||||
"mikrotik_password": "060111",
|
||||
"mikrotik_port": 8700
|
||||
}
|
||||
```
|
||||
|
||||
**Apa yang terjadi:**
|
||||
1. `getConnection()` dipanggil tanpa `routerId`
|
||||
2. Cari router di database → TIDAK ADA
|
||||
3. **Fallback ke settings.json** → GUNAKAN ✅
|
||||
4. Koneksi berhasil ke MikroTik Anda
|
||||
|
||||
**Anda perlu tambah di /admin/routers?** → **TIDAK** ✖️
|
||||
|
||||
---
|
||||
|
||||
### Skenario 2: Anda punya `settings.json` + `/admin/routers` (Multi-Router)
|
||||
```json
|
||||
{
|
||||
"mikrotik_host": "192.168.8.1",
|
||||
"mikrotik_user": "ali",
|
||||
"mikrotik_password": "060111"
|
||||
}
|
||||
```
|
||||
|
||||
**Database routers:**
|
||||
```
|
||||
ID | name | host | user | is_active
|
||||
---|-----------------|--------------|-------|----------
|
||||
1 | Main Router | 192.168.8.1 | ali | 1
|
||||
2 | Backup Router | 192.168.9.1 | admin | 1
|
||||
```
|
||||
|
||||
**Apa yang terjadi:**
|
||||
- `getConnection(1)` → Gunakan router ID 1 dari database ✅
|
||||
- `getConnection(2)` → Gunakan router ID 2 dari database ✅
|
||||
- `getConnection()` (tanpa routerId) → Gunakan router pertama dari database ✅
|
||||
- `settings.json` tidak dipakai
|
||||
|
||||
**Kapan settings.json dipakai?** Hanya jika database tidak punya router aktif
|
||||
|
||||
---
|
||||
|
||||
### Skenario 3: TRANSISI dari single-router ke multi-router
|
||||
```
|
||||
Fase 1 (Hanya settings.json):
|
||||
- settings.json: Sudah ada MikroTik credentials ✅
|
||||
- /admin/routers: KOSONG (tidak perlu ditambah)
|
||||
- Aplikasi jalan normal dengan settings.json
|
||||
|
||||
Fase 2 (Tambah multi-router):
|
||||
- Tambah router ke /admin/routers
|
||||
- settings.json: Tetap ada (tapi tidak dipakai lagi)
|
||||
- Aplikasi pakai database routers sebagai priority
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Code Implementation
|
||||
|
||||
### File: `services/mikrotikService.js` (lines 256-290)
|
||||
|
||||
```javascript
|
||||
async function getConnection(routerId = null) {
|
||||
let host, port, user, password;
|
||||
|
||||
if (routerId) {
|
||||
// Priority 1: Gunakan router spesifik dari database
|
||||
const router = db.prepare('SELECT * FROM routers WHERE id = ?').get(routerId);
|
||||
if (!router) throw new Error(`Router with ID ${routerId} not found`);
|
||||
host = router.host;
|
||||
port = router.port || 8728;
|
||||
user = router.user;
|
||||
password = router.password;
|
||||
} else {
|
||||
// Priority 2: Cari router default (is_active = 1)
|
||||
const defaultRouter = db.prepare(
|
||||
'SELECT * FROM routers WHERE is_active = 1 ORDER BY id ASC LIMIT 1'
|
||||
).get();
|
||||
|
||||
if (defaultRouter) {
|
||||
// Ada router aktif, gunakan itu
|
||||
host = defaultRouter.host;
|
||||
port = defaultRouter.port || 8728;
|
||||
user = defaultRouter.user;
|
||||
password = defaultRouter.password;
|
||||
logger.info(`[MikroTik] Using default router from database: ${defaultRouter.name}`);
|
||||
} else {
|
||||
// Priority 3: Fallback ke settings.json (backward compatibility)
|
||||
const settings = getSettingsWithCache();
|
||||
host = settings.mikrotik_host;
|
||||
port = settings.mikrotik_port || 8728;
|
||||
user = settings.mikrotik_user;
|
||||
password = settings.mikrotik_password;
|
||||
logger.info('[MikroTik] Using router from settings.json (no routers in database)');
|
||||
}
|
||||
}
|
||||
|
||||
// Lanjut koneksi...
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Keuntungan Arsitektur Ini
|
||||
|
||||
### ✅ Backward Compatible
|
||||
- **Old Setup**: Hanya `settings.json` → Tetap jalan ✅
|
||||
- **New Setup**: `/admin/routers` + `settings.json` → Prioritas database ✅
|
||||
|
||||
### ✅ Fleksibel
|
||||
- Bisa transisi dari single → multi-router tanpa downtime
|
||||
- Bisa rollback dengan disable semua routers di database
|
||||
- `settings.json` berfungsi sebagai "circuit breaker" terakhir
|
||||
|
||||
### ✅ Aman
|
||||
- Jika database routers error, fallback ke settings.json
|
||||
- Tidak ada data loss atau operasi yang terputus
|
||||
|
||||
---
|
||||
|
||||
## Testing: Verifikasi Fallback Works
|
||||
|
||||
### Test 1: Cek logs saat aplikasi start
|
||||
```bash
|
||||
tail -f logs/combined.log | grep "Using router"
|
||||
```
|
||||
|
||||
Akan muncul salah satu:
|
||||
- `"Using default router from database"` → Database routers digunakan
|
||||
- `"Using router from settings.json"` → Fallback ke settings.json
|
||||
|
||||
### Test 2: Cek via Node
|
||||
```bash
|
||||
node -e "
|
||||
const svc = require('./services/mikrotikService');
|
||||
svc.checkConnection(null).then(ok => {
|
||||
console.log('Default connection:', ok ? '✅ OK' : '❌ FAIL');
|
||||
});
|
||||
"
|
||||
```
|
||||
|
||||
### Test 3: Disable routers di database, cek apakah fallback jalan
|
||||
```bash
|
||||
sqlite3 database/billing.db "UPDATE routers SET is_active = 0;"
|
||||
```
|
||||
|
||||
Cek logs → Harus ada `"Using router from settings.json"` ✅
|
||||
|
||||
---
|
||||
|
||||
## Pertanyaan Umum (FAQ)
|
||||
|
||||
**Q: Apa perbedaan /admin/routers dengan settings.json?**
|
||||
- **settings.json**: Single router, tidak bisa diubah dari UI
|
||||
- **/admin/routers**: Multiple routers, bisa diatur dari UI admin
|
||||
|
||||
**Q: Kalau saya hapus settings.json apa yang terjadi?**
|
||||
- Jika database kosong (tidak ada routers) → Error "MikroTik settings not configured"
|
||||
- Jika database punya routers → Jalan normal
|
||||
|
||||
**Q: Kapan saya harus gunakan /admin/routers?**
|
||||
- Jika punya multiple MikroTik routers (multi-ISP, multi-lokasi)
|
||||
- Jika ingin setup dari UI daripada edit JSON manual
|
||||
|
||||
**Q: Bisakah saya punya settings.json TIDAK ada tapi /admin/routers ada?**
|
||||
- Ya, bisa! Sebetulnya yang penting adalah database routers
|
||||
|
||||
**Q: Isolir via WhatsApp apakah support multi-router?**
|
||||
- Ya! Gunakan `getEffectiveRouterId()` → fallback ke settings.json jika perlu
|
||||
|
||||
---
|
||||
|
||||
## Kesimpulan
|
||||
|
||||
Anda **TIDAK PERLU** menambah router di `/admin/routers` jika:
|
||||
- ✅ Hanya punya 1 MikroTik router
|
||||
- ✅ Sudah di-setup di `settings.json`
|
||||
- ✅ Tidak perlu ganti-ganti router dari UI
|
||||
|
||||
**Cukup gunakan `settings.json` yang sudah ada, sistem akan otomatis menggunakannya sebagai fallback.** ✅
|
||||
|
||||
Jika nanti ingin multi-router, tinggal tambah di `/admin/routers` dan system akan auto-switch prioritas.
|
||||
Reference in new issue
Block a user