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,494 @@
|
||||
# 📚 INDEX DOKUMENTASI AUDIT - Aplikasi Billing B481
|
||||
|
||||
**Tanggal Audit:** Juni 2026
|
||||
**Total Dokumentasi:** 6 file (91 KB)
|
||||
**Status:** ✅ LENGKAP & SIAP PAKAI
|
||||
|
||||
---
|
||||
|
||||
## 📖 Panduan Membaca Dokumentasi
|
||||
|
||||
### Untuk Pengguna Pertama (5-15 menit)
|
||||
```
|
||||
START HERE:
|
||||
1. AUDIT_SUMMARY.md ← Ringkasan eksekutif (5 min)
|
||||
2. QUICK_REFERENCE.md ← Perintah dasar (10 min)
|
||||
3. README.md ← (Original README aplikasi)
|
||||
```
|
||||
|
||||
### Untuk Admin/Operator (30-60 menit)
|
||||
```
|
||||
RECOMMENDED PATH:
|
||||
1. QUICK_REFERENCE.md ← Common tasks & troubleshooting
|
||||
2. AUDIT_LENGKAP.md ← Section 4 (Endpoints & Routes)
|
||||
3. BACKUP_CHECKLIST.md ← Backup & recovery procedures
|
||||
4. DATABASE_SCHEMA.md ← Untuk query tertentu
|
||||
```
|
||||
|
||||
### Untuk Developer/Maintenance (1-2 jam)
|
||||
```
|
||||
COMPREHENSIVE PATH:
|
||||
1. AUDIT_LENGKAP.md ← Full architecture & features
|
||||
2. DATABASE_SCHEMA.md ← Complete schema with examples
|
||||
3. QUICK_REFERENCE.md ← Common tasks reference
|
||||
4. BACKUP_CHECKLIST.md ← Operational procedures
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📄 File Documentation Details
|
||||
|
||||
### 1. AUDIT_LENGKAP.md (45.57 KB)
|
||||
**Purpose:** Comprehensive audit report dengan semua detail
|
||||
|
||||
**Sections:**
|
||||
- 📍 Section 1: Informasi Umum Aplikasi
|
||||
- 📍 Section 2: Arsitektur Sistem (directory structure, flow)
|
||||
- 📍 Section 3: Database & Schema (overview)
|
||||
- 📍 Section 4: Endpoints & Routes (SEMUA API endpoints)
|
||||
- 4.1: Portal Pelanggan (/customer)
|
||||
- 4.2: Portal Admin (/admin)
|
||||
- 4.3: Portal Teknisi (/tech)
|
||||
- 4.4: Portal Agen (/agent)
|
||||
- 4.5: Portal Kolektor (/collector)
|
||||
- 4.6: Portal Finance (/finance)
|
||||
- 4.7: Public Routes
|
||||
- 4.8: Settings & Configuration API
|
||||
- 4.9: Voucher Payment API
|
||||
- 📍 Section 5: Fitur-Fitur Utama (15+ modul)
|
||||
- 5.1 Billing & Invoicing
|
||||
- 5.2 MikroTik Integration
|
||||
- 5.3 GenieACS & TR-069
|
||||
- 5.4 OLT & ONU Management
|
||||
- 5.5 GIS Mapping
|
||||
- 5.6 WhatsApp Automation
|
||||
- 5.7 Payment Gateways
|
||||
- 5.8 Agen & Sales
|
||||
- 5.9-5.15 Additional features
|
||||
- 📍 Section 6: Keamanan & Otentikasi
|
||||
- 📍 Section 7: Frontend & UI
|
||||
- 📍 Section 8: Internationalization (i18n)
|
||||
- 📍 Section 9: Configuration & Settings
|
||||
- 📍 Section 10: Dependencies & Libraries
|
||||
- 📍 Section 11: Operational Requirements
|
||||
- 📍 Section 12: Monitoring & Troubleshooting
|
||||
- 📍 Section 13: Production Checklist
|
||||
- 📍 Section 14: Performance Optimization
|
||||
- 📍 Section 15: File Size & Statistics
|
||||
- 📍 Section 16: Documentation & Resources
|
||||
- 📍 Section 17: Advanced Features & Integration
|
||||
- 📍 Section 18: Conclusion & Recommendations
|
||||
|
||||
**When to use:** Referensi lengkap untuk semua aspek aplikasi
|
||||
|
||||
**Example queries:**
|
||||
- "Apa saja endpoint admin?" → See section 4.2
|
||||
- "Bagaimana cara kerja billing?" → See section 5.1
|
||||
- "Apa saja database tables?" → See section 3.2
|
||||
- "Bagaimana setup MikroTik?" → See section 5.2
|
||||
|
||||
---
|
||||
|
||||
### 2. QUICK_REFERENCE.md (6.67 KB)
|
||||
**Purpose:** Quick lookup guide untuk task-task umum
|
||||
|
||||
**Sections:**
|
||||
- Quick Start (npm commands)
|
||||
- Portal access URLs
|
||||
- Key Files location
|
||||
- Common Tasks (5 tasks)
|
||||
- Change Port
|
||||
- Change Company Name
|
||||
- Enable WhatsApp
|
||||
- Setup MikroTik
|
||||
- Setup GenieACS
|
||||
- Security Settings (MUST DO)
|
||||
- Important Endpoints
|
||||
- Database Commands
|
||||
- Cron Jobs Schedule
|
||||
- Troubleshooting (7 common issues)
|
||||
- Multi-Language
|
||||
- Useful Scripts
|
||||
- Pre-Launch Checklist
|
||||
|
||||
**When to use:** Sehari-hari untuk quick answers
|
||||
|
||||
**Example queries:**
|
||||
- "Port berapa aplikasi?" → See "Quick Start"
|
||||
- "MikroTik tidak connect, apa solusinya?" → See "Troubleshooting"
|
||||
- "Bagaimana aktifkan WhatsApp?" → See "Common Tasks"
|
||||
- "Kapan billing dijalankan?" → See "Cron Jobs"
|
||||
|
||||
---
|
||||
|
||||
### 3. DATABASE_SCHEMA.md (15.75 KB)
|
||||
**Purpose:** Complete database schema documentation
|
||||
|
||||
**Sections:**
|
||||
- Schema Overview
|
||||
- Detailed Table Structures (20+ tables)
|
||||
- Table relationships & foreign keys
|
||||
- Query Examples (4 examples)
|
||||
- Optimization Tips
|
||||
- Backup & Recovery procedures
|
||||
- Index recommendations
|
||||
|
||||
**Tables Documented:**
|
||||
- settings, packages, customers, routers, olts, odps
|
||||
- invoices, payments, payment_approvals
|
||||
- pppoe_users, pppoe_profiles, pppoe_traffic_samples, pppoe_sessions
|
||||
- hotspot_users, hotspot_profiles, hotspot_sessions
|
||||
- voucher_batches, vouchers
|
||||
- acsdevices, acs_sessions, acs_device_params
|
||||
- onu_mapping, onu_provision, olu_ports
|
||||
- audit_trail, expenses, cash_in
|
||||
- technicians, cashiers, agents, collectors
|
||||
- inventory_items, attendance, tickets
|
||||
- digiflazz_transactions, vomit_log
|
||||
|
||||
**When to use:** Ketika perlu memahami struktur data atau membuat query
|
||||
|
||||
**Example queries:**
|
||||
- "Bagaimana struktur tabel customers?" → See "customers" section
|
||||
- "Query apa untuk cek overdue invoice?" → See "Query Examples"
|
||||
- "Tabel apa untuk tracking PPPoE usage?" → See "pppoe_traffic_samples"
|
||||
|
||||
---
|
||||
|
||||
### 4. BACKUP_CHECKLIST.md (10.58 KB)
|
||||
**Purpose:** Comprehensive backup & disaster recovery guide
|
||||
|
||||
**Sections:**
|
||||
- Pre-Audit Backup (CRITICAL)
|
||||
- Step 1-5: Database, Settings, Aplikasi, Uploads
|
||||
- Backup Checklist (verification checklist)
|
||||
- Restore Procedures (5 scenarios)
|
||||
- Restore Database Only
|
||||
- Restore Settings
|
||||
- Full Application Restore
|
||||
- Restore Upload Files
|
||||
- Backup Inventory (tracking template)
|
||||
- Secure Backup Storage (4 options)
|
||||
- Local Storage (USB)
|
||||
- Network Drive (NAS/SMB)
|
||||
- Cloud Storage (rclone, S3)
|
||||
- Encrypted Backup (GPG)
|
||||
- Automated Backup (Cron Job setup)
|
||||
- Disaster Recovery Plan (5 scenarios)
|
||||
- Database Corrupted
|
||||
- Aplikasi Crashed
|
||||
- Akses Denied
|
||||
- HDD Full
|
||||
- Settings Misconfiguration
|
||||
- Best Practices (DO & DON'T)
|
||||
- Recovery Time Objective (RTO/RPO)
|
||||
- Backup Verification Checklist
|
||||
|
||||
**When to use:** Sebelum & sesudah deployment, disaster recovery
|
||||
|
||||
**Example queries:**
|
||||
- "Gimana backup database?" → See "Backup Procedures" Step 1
|
||||
- "Gimana restore jika database corrupt?" → See "Disaster Recovery" Scenario 1
|
||||
- "Setup automated backup gimana?" → See "Automated Backup (Cron Job)"
|
||||
|
||||
---
|
||||
|
||||
### 5. AUDIT_SUMMARY.md (12.31 KB)
|
||||
**Purpose:** Executive summary & quick links
|
||||
|
||||
**Sections:**
|
||||
- Executive Summary
|
||||
- Dokumentasi yang Dibuat (daftar lengkap)
|
||||
- Key Findings (Strengths & Areas for Improvement)
|
||||
- Application Statistics
|
||||
- Quick Start (4 steps)
|
||||
- Security Checklist (CRITICAL)
|
||||
- Operational Runbook
|
||||
- Daily, Weekly, Monthly, Ad-Hoc tasks
|
||||
- Maintenance Procedures (5 procedures)
|
||||
- Training Resources
|
||||
- Support & Escalation (3 levels)
|
||||
- Document File Locations
|
||||
- Next Steps (Immediate, Short-term, Long-term)
|
||||
- Audit Completion Status
|
||||
- Document Versions
|
||||
- Audit Methodology
|
||||
- Final Checklist
|
||||
- Success Criteria
|
||||
|
||||
**When to use:** Overview & planning
|
||||
|
||||
**Example queries:**
|
||||
- "Aplikasi ready untuk production?" → See "Audit Completion Status"
|
||||
- "Apa saja dokumentasi yang dibuat?" → See "Dokumentasi yang Telah Dibuat"
|
||||
- "Langkah pertama gimana?" → See "Quick Start"
|
||||
|
||||
---
|
||||
|
||||
### 6. DOKUMENTASI_INDEX.md (This file)
|
||||
**Purpose:** Navigation guide untuk semua dokumentasi
|
||||
|
||||
**Sections:**
|
||||
- Panduan Membaca Dokumentasi (paths untuk berbagai user)
|
||||
- File Documentation Details (overview setiap file)
|
||||
- Quick Links & Search Tips
|
||||
- Related Documentation
|
||||
- How to Update Documentation
|
||||
- Troubleshooting Documentation Issues
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Quick Links
|
||||
|
||||
### By Topic
|
||||
|
||||
#### Billing & Invoicing
|
||||
- AUDIT_LENGKAP.md → Section 5.1
|
||||
- DATABASE_SCHEMA.md → invoices, payments tables
|
||||
|
||||
#### MikroTik Management
|
||||
- QUICK_REFERENCE.md → "Setup MikroTik"
|
||||
- AUDIT_LENGKAP.md → Section 5.2
|
||||
- DATABASE_SCHEMA.md → routers, pppoe_users tables
|
||||
|
||||
#### Payment Gateways
|
||||
- AUDIT_LENGKAP.md → Section 5.7
|
||||
- QUICK_REFERENCE.md → "Setup Payment Gateway"
|
||||
|
||||
#### Database
|
||||
- DATABASE_SCHEMA.md → All sections
|
||||
- BACKUP_CHECKLIST.md → Backup procedures
|
||||
|
||||
#### Security
|
||||
- QUICK_REFERENCE.md → "Security Settings"
|
||||
- AUDIT_SUMMARY.md → "Security Checklist"
|
||||
- AUDIT_LENGKAP.md → Section 6
|
||||
|
||||
#### Troubleshooting
|
||||
- QUICK_REFERENCE.md → "Troubleshooting"
|
||||
- AUDIT_LENGKAP.md → Section 12
|
||||
|
||||
---
|
||||
|
||||
## 🔍 How to Search Documentation
|
||||
|
||||
### Using Text Editor Find (Ctrl+F)
|
||||
|
||||
**Search by feature:**
|
||||
```
|
||||
"billing" → Find billing-related content
|
||||
"whatsapp" → Find WhatsApp integration
|
||||
"endpoint" → Find API endpoints
|
||||
"table" → Find database tables
|
||||
"cron" → Find scheduled tasks
|
||||
"error" → Find error handling
|
||||
```
|
||||
|
||||
**Search by section:**
|
||||
```
|
||||
"## " (two hashes) → Find main sections
|
||||
"### " (three hashes) → Find subsections
|
||||
"- [ ]" → Find checklist items
|
||||
"| " → Find tables
|
||||
```
|
||||
|
||||
### Using grep (Linux/Mac)
|
||||
```bash
|
||||
# Find all mentions of "WhatsApp"
|
||||
grep -n "whatsapp" *.md
|
||||
|
||||
# Find all table structures
|
||||
grep -n "CREATE TABLE" DATABASE_SCHEMA.md
|
||||
|
||||
# Find all endpoints
|
||||
grep -n "GET\|POST\|PUT\|DELETE" AUDIT_LENGKAP.md
|
||||
|
||||
# Find all endpoints for /admin
|
||||
grep -n "/admin" AUDIT_LENGKAP.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 Documentation Cross-References
|
||||
|
||||
### Related Files to Read Together
|
||||
|
||||
**For Admin Portal:**
|
||||
- AUDIT_LENGKAP.md section 4.2
|
||||
- QUICK_REFERENCE.md "Common Tasks"
|
||||
- AUDIT_SUMMARY.md "Operational Runbook"
|
||||
|
||||
**For Customer Portal:**
|
||||
- AUDIT_LENGKAP.md section 4.1
|
||||
- AUDIT_LENGKAP.md section 5.1 (Billing)
|
||||
|
||||
**For Database Operations:**
|
||||
- DATABASE_SCHEMA.md (all sections)
|
||||
- BACKUP_CHECKLIST.md (all procedures)
|
||||
- QUICK_REFERENCE.md "Database Commands"
|
||||
|
||||
**For Security:**
|
||||
- QUICK_REFERENCE.md "Security Settings"
|
||||
- AUDIT_SUMMARY.md "Security Checklist"
|
||||
- AUDIT_LENGKAP.md section 6
|
||||
|
||||
**For Troubleshooting:**
|
||||
- QUICK_REFERENCE.md "Troubleshooting"
|
||||
- AUDIT_LENGKAP.md section 12
|
||||
- AUDIT_LENGKAP.md section 13
|
||||
|
||||
---
|
||||
|
||||
## 🔄 How to Update Documentation
|
||||
|
||||
When application changes, update relevant docs:
|
||||
|
||||
1. **New Feature Added:**
|
||||
- Update AUDIT_LENGKAP.md section 5 (Fitur-Fitur)
|
||||
- Update QUICK_REFERENCE.md if it's a common task
|
||||
|
||||
2. **New Endpoint Added:**
|
||||
- Update AUDIT_LENGKAP.md section 4 (Routes)
|
||||
- Add to QUICK_REFERENCE.md "Important Endpoints"
|
||||
|
||||
3. **Database Schema Changed:**
|
||||
- Update DATABASE_SCHEMA.md with new tables
|
||||
- Add query examples if applicable
|
||||
|
||||
4. **Backup Procedure Changed:**
|
||||
- Update BACKUP_CHECKLIST.md
|
||||
- Update QUICK_REFERENCE.md "Database Commands"
|
||||
|
||||
5. **Security Changes:**
|
||||
- Update AUDIT_SUMMARY.md "Security Checklist"
|
||||
- Update AUDIT_LENGKAP.md section 6
|
||||
|
||||
**Version Control:**
|
||||
```markdown
|
||||
Example header update:
|
||||
|
||||
### 6. AUDIT_SUMMARY.md (12.31 KB) → Last updated: 2026-06-20
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ❓ FAQ - Documentation
|
||||
|
||||
**Q: File mana yang harus dibaca duluan?**
|
||||
A: Mulai dengan AUDIT_SUMMARY.md (5 min), lalu QUICK_REFERENCE.md (10 min)
|
||||
|
||||
**Q: Gimana cari informasi tentang endpoint tertentu?**
|
||||
A: Cari di AUDIT_LENGKAP.md section 4, atau grep dengan `/endpoint-name`
|
||||
|
||||
**Q: Database tables untuk X ada di file mana?**
|
||||
A: DATABASE_SCHEMA.md, section "Detailed Table Structures"
|
||||
|
||||
**Q: Backup gimana?**
|
||||
A: Baca BACKUP_CHECKLIST.md dari atas sampai bawah
|
||||
|
||||
**Q: Troubleshooting error X gimana?**
|
||||
A: Lihat QUICK_REFERENCE.md "Troubleshooting", atau AUDIT_LENGKAP.md section 12
|
||||
|
||||
**Q: Dokumentasi sudah lengkap?**
|
||||
A: Ya, 6 file (91 KB) sudah cover semua aspek aplikasi
|
||||
|
||||
**Q: Dokumentasi perlu diupdate?**
|
||||
A: Ya, ikuti "How to Update Documentation" section di atas
|
||||
|
||||
---
|
||||
|
||||
## 📊 Documentation Statistics
|
||||
|
||||
| File | Size | Sections | Tables | Sections Covered |
|
||||
|------|------|----------|--------|------------------|
|
||||
| AUDIT_LENGKAP.md | 45 KB | 18 | 5+ | Features, API, Security |
|
||||
| QUICK_REFERENCE.md | 7 KB | 10 | 3+ | Common tasks, Quick links |
|
||||
| DATABASE_SCHEMA.md | 16 KB | 6 | 20+ | Database, Tables, Queries |
|
||||
| BACKUP_CHECKLIST.md | 11 KB | 8 | 2+ | Backup, Recovery, RTO/RPO |
|
||||
| AUDIT_SUMMARY.md | 12 KB | 15 | 2+ | Executive, Roadmap |
|
||||
| DOKUMENTASI_INDEX.md | 9 KB | 6 | - | Navigation, Index |
|
||||
|
||||
**Total:** 6 files, ~100 KB, 18+ sections, 30+ tables documented
|
||||
|
||||
---
|
||||
|
||||
## ✅ Verification Checklist
|
||||
|
||||
Pastikan dokumentasi lengkap:
|
||||
|
||||
- [x] AUDIT_LENGKAP.md → 18 sections ✓
|
||||
- [x] QUICK_REFERENCE.md → 10 sections ✓
|
||||
- [x] DATABASE_SCHEMA.md → 20+ tables ✓
|
||||
- [x] BACKUP_CHECKLIST.md → 8 sections ✓
|
||||
- [x] AUDIT_SUMMARY.md → 15 sections ✓
|
||||
- [x] DOKUMENTASI_INDEX.md → Navigation ✓
|
||||
|
||||
**All files created:** ✅ COMPLETE
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Documentation Roadmap
|
||||
|
||||
### Current Status (2026-06-19)
|
||||
- ✅ 6 documentation files created
|
||||
- ✅ ~100 KB comprehensive documentation
|
||||
- ✅ All major features documented
|
||||
- ✅ Backup procedures documented
|
||||
- ✅ Troubleshooting guide created
|
||||
|
||||
### Future Enhancements
|
||||
- ⏳ API Swagger/OpenAPI documentation
|
||||
- ⏳ Video tutorials for common tasks
|
||||
- ⏳ Deployment guide (Docker, K8s)
|
||||
- ⏳ Performance tuning guide
|
||||
- ⏳ Custom integration examples
|
||||
|
||||
---
|
||||
|
||||
## 🔐 Documentation Backup
|
||||
|
||||
**Backup documentation juga!**
|
||||
|
||||
```bash
|
||||
# Create backup
|
||||
tar -czf audit-docs-backup-$(date +%Y-%m-%d).tar.gz \
|
||||
AUDIT_LENGKAP.md \
|
||||
QUICK_REFERENCE.md \
|
||||
DATABASE_SCHEMA.md \
|
||||
BACKUP_CHECKLIST.md \
|
||||
AUDIT_SUMMARY.md \
|
||||
DOKUMENTASI_INDEX.md
|
||||
|
||||
# Store in safe location
|
||||
cp audit-docs-backup-*.tar.gz /mnt/backup/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📞 Documentation Support
|
||||
|
||||
**Questions about documentation?**
|
||||
|
||||
1. First, try searching the relevant file
|
||||
2. Check cross-references at the end of each section
|
||||
3. Review FAQ section (above)
|
||||
4. Contact: Ali Jaya Net (081947215703)
|
||||
|
||||
---
|
||||
|
||||
## 🏁 Next Steps
|
||||
|
||||
1. **READ:** Mulai dengan AUDIT_SUMMARY.md
|
||||
2. **UNDERSTAND:** Baca AUDIT_LENGKAP.md sections yang relevan
|
||||
3. **REFERENCE:** Simpan QUICK_REFERENCE.md untuk daily use
|
||||
4. **BACKUP:** Ikuti BACKUP_CHECKLIST.md procedures
|
||||
5. **MAINTAIN:** Update docs saat ada changes
|
||||
|
||||
---
|
||||
|
||||
**Documentation Version:** 1.0 - Complete
|
||||
**Last Updated:** June 19, 2026
|
||||
**Status:** ✅ READY FOR PRODUCTION
|
||||
|
||||
**Happy Reading! 📖**
|
||||
|
||||
Reference in new issue
Block a user