Charging Station Management

1 Hirarki: Lokasi → Mesin → Konektor

Baca ini dulu — semua alur lain bergantung padanya.

Salah menempatkan sesuatu di tingkat yang keliru adalah kesalahan paling sering di CESA, dan paling merepotkan untuk diperbaiki.

1. Data CESA bertingkat tiga: Lokasi berisi satu atau lebih Mesin, dan setiap mesin berisi satu atau lebih Konektor. Konektor menempel pada mesin, bukan pada lokasi — jadi saat menambah konektor yang dipilih adalah mesinnya.
2. Panel Edit Data menampilkan ketiganya sekaligus: lokasi di bagian atas, kartu mesin di bawahnya, dan konektor di dalam tiap kartu mesin. Ini cara tercepat melihat isi satu lokasi utuh.

   

3. Urutan pembuatannya mengikuti hirarki itu: lokasi dulu, lalu mesin di dalamnya, lalu konektor di dalam mesin. Mesin tidak bisa dibuat tanpa lokasi, dan konektor tidak bisa dibuat tanpa mesin.
4. Urutan penghapusan justru kebalikannya — konektor dulu, baru mesin, baru lokasi. CESA melakukannya otomatis; alasannya ada di alur nomor 12.

2 Tambah Charging Station Baru (lokasi + mesin + konektor)

Lokasi, mesin, dan konektornya belum ada sama sekali.

Alur terpandu ini membuat ketiganya berurutan tanpa perlu berpindah tab, jadi tidak ada mesin atau konektor yang lupa dibuat.

1. Di tab Join Table, klik ＋ Tambah Lokasi (beserta Mesin & Konektornya) di kanan atas tabel.

   

2. Isi form lokasi. Kalau punya link Google Maps, tempel di kolom paling atas lalu klik Ambil Data — nama, koordinat, alamat, kota, dan provinsi terisi otomatis. Kalau tempatnya belum terdaftar di Google Maps, keterangannya muncul kuning, bukan merah: itu bukan kegagalan, cuma berarti kamu mengisi Latitude dan Longitude sendiri. Provider sudah terpilih ALVA, Description terisi otomatis dari nama lokasi, dan Status tetap Draft sampai diaktifkan di langkah terakhir. Field bertanda * wajib diisi.

   

3. Pada Jam Operasional, kotak yang cocok dengan isian tabel di bawahnya akan menyala hijau. Begitu kamu mengubah jam salah satu hari atau menandai satu hari tutup, yang menyala pindah ke Custom — jadi kamu selalu tahu apa yang sedang tersimpan tanpa membaca tujuh barisnya.
4. Dua field wajib ini ada di bagian bawah form dan paling sering terlewat. Charging Bike Type punya tiga pilihan: Semua Motor ALVA, Kecuali ALVA ONE Series, atau ALVA ONE saja.

   

5. Parkir Motor Berbayar berupa tombol geser, sama seperti Is Paid di sebelahnya, dan defaultnya Gratis. Keduanya beda hal: yang ini soal biaya parkir, yang itu soal biaya charging. Disimpan di database CESA karena Electra tidak punya kolomnya.

   

6. Tombol simpannya berbunyi Simpan dan Tambah Mesin. Kliknya langsung membuka form mesin — tidak perlu pindah tab.

   

7. Form mesin terbuka dengan Location sudah terisi otomatis. Isi Charger Machine Type — setelah itu Display Name dan Serial Number Machine terisi sendiri, dan keduanya masih bisa kamu ubah. Display Name berbentuk Machine {n} dengan {n} nomor urut mesin di lokasi itu, dan nomor urut serial mengikuti angka yang sama: mesin pertama 0001, berikutnya 0002. Status default Active.

   

8. Charging Feature juga wajib, dan ada di bawah form. Satu pilihan mengisi versi Indonesia dan English sekaligus, jadi keduanya tidak bisa berbeda. Pilih Tulis sendiri kalau butuh kalimat lain.

   

9. Tombol simpannya sekarang berbunyi Simpan dan Tambah Konektor.

   

10. Form konektor terbuka dengan Machine sudah terisi. Slot No terisi otomatis dengan nomor slot berikutnya di mesin itu, dan Connector No mengikutinya (1 = A, 2 = B, … 27 = AA). Isi Serial Number — formatnya 16 angka — lalu Wattage terisi otomatis dari enam digit pertamanya: 007250=4000W, 007245=3000W, 007230=2000W, 007212=1000W. Connector Type, Charger Model, dan Firmware sudah terisi default.

    

11. Di langkah terakhir ada tiga pilihan:

    • Simpan, Selesai & Aktifkan Lokasi — menyimpan konektornya, mengubah status lokasi dari Draft jadi Active, lalu membuka panel Edit Data berisi lokasi, mesin, dan konektor yang barusan dibuat.
    • Simpan & tambah mesin lain di lokasi ini — untuk lokasi dengan lebih dari satu mesin.
    • Simpan & tambah konektor lain di mesin ini — untuk mesin dengan lebih dari satu konektor.

    Dua pilihan terakhir bisa dipakai berulang kali; pakai yang pertama kalau semuanya sudah lengkap.

    

3 Tambah Lokasi / Mesin / Konektor dari tabnya masing-masing

Kalau yang ditambah hanya salah satu, bukan satu paket.

Setiap tab punya tombol tambahnya sendiri. Bedanya dengan alur nomor 2: di sini kamu menambah satu tingkat saja, dan induknya harus sudah ada.

1. Lokasi baru saja: buka tab Location, klik ＋ Add Location. Formnya sama dengan langkah pertama alur nomor 2. Setelah tersimpan, lokasinya masih kosong — mesin dan konektornya ditambahkan lewat dua langkah di bawah.

   

2. Buka tab Machine, klik ＋ Add Machine.

   

3. Ketik nama lokasi di kolom Location — daftarnya menyaring saat kamu mengetik, jadi tidak perlu menggulir ratusan baris. Pilih Charger Machine Type, lalu serial number terisi otomatis dengan nomor urut yang melanjutkan mesin yang sudah ada di lokasi itu. Charging Feature wajib dipilih. Setelah simpan, tambahkan konektornya lewat alur nomor 3.

   

4. Buka tab Connector, klik ＋ Add Connector.

   

5. Ketik serial number atau nama lokasi di kolom Machine untuk mencari mesinnya — tabel Machine dan Connector juga bisa dicari pakai nama lokasi. Saat serial number konektor diisi, Wattage terisi otomatis dari prefiksnya: 007250=4000W, 007245=3000W, 007230=2000W, 007212=1000W. Prefiks lain harus diisi manual.

   

4 Edit Lokasi / Mesin / Konektor

Mengubah data yang sudah tersimpan.

Tombol edit ada di dua tempat: di baris tabelnya masing-masing, dan di panel Edit Data. Keduanya membuka form yang sama.

1. Di tab Location, Machine, atau Connector, klik ikon ✏️ pada baris yang mau diubah.

   

2. Formnya terbuka dengan data yang tersimpan. Field bertanda * wajib diisi — tombol Simpan menolak kalau ada yang kosong. Beberapa field terisi otomatis (slug, jam operasional, display name, wattage, slot) dan boleh diubah manual — kecuali beberapa field yang terkunci saat edit, lihat dua langkah berikut.

   

3. Untuk mesin dan konektor, formnya juga sama seperti saat menambah — kecuali Location pada form mesin dan Machine pada form konektor yang terkunci. API Electra menerima perubahan induk tapi diam-diam mengabaikannya, jadi CESA mengunci field itu daripada menampilkan "tersimpan" untuk perubahan yang tidak terjadi.

   

4. Pada form Edit Connector, Serial Number dan Slot No juga terkunci — alasannya sama: API Electra membalas success tapi nilainya tidak berubah. Slot bahkan lebih berbahaya kalau dibiarkan terbuka: Connector No ikut slot dan itu tersimpan, jadi mengubah slot akan meninggalkan slot 1 berlabel C. Yang masih bisa diubah di konektor: Wattage, Charger Model Name, Firmware Version, dan Status.
5. Kalau serial number atau slot konektor salah dan harus diganti, pakai tombol 🔄 Ganti SN / Slot Konektor di bawah field itu — langkah lengkapnya ada di bagian 7 — Pergantian Serial Number Konektor & Mesin.
6. Panel Edit Data juga punya tombol ✏️ di setiap tingkat — berguna kalau kamu sedang memeriksa satu lokasi dan menemukan sesuatu yang perlu dibetulkan tanpa harus pindah tab.

5 Set Maintenance Lokasi / Mesin / Konektor

Menandai unit yang sedang tidak bisa dipakai.

Status maintenance menular ke atas dan ke bawah secara otomatis, jadi kamu tidak perlu menandai satu per satu.

1. Di tab Location, cari barisnya lalu klik tombol 🔧 di kolom Actions. Status baris itu langsung berubah jadi Maintenance.

   

2. Di tab Machine, klik 🔧 Maint pada baris mesinnya.

   

3. Di tab Connector caranya sama — 🔧 Maint pada baris konektor.

   

4. Kalau semua konektor di satu mesin jadi maintenance, mesinnya ikut otomatis. Kalau semua mesin di satu lokasi jadi maintenance, lokasinya ikut. Sebaliknya, menandai lokasi akan menandai semua mesin dan konektor di dalamnya. Setiap kali itu terjadi, muncul kotak yang menyebutkan apa saja yang ikut berubah dan kenapa.

6 Selesaikan Maintenance

Mengembalikan unit ke status aktif.

Aturannya simetris dengan alur nomor 5 — begitu semua turunannya aktif, induknya ikut aktif.

1. Buka tab 🔧 Maintenance, klik ✅ Selesaikan pada barisnya. Kolom Sudah Berjalan memakai menit di bawah 1 jam, jam di bawah 1 hari, dan hari setelahnya — warnanya kuning setelah 1 hari, merah setelah 1 minggu. Tanda ≈ berarti waktunya perkiraan, bukan angka pasti.

   

7 Pergantian Serial Number Konektor & Mesin

Hardware diganti, nomornya berubah.

Caranya berbeda untuk mesin dan konektor. Serial mesin bisa diubah langsung; serial konektor tidak bisa diubah sama sekali dan harus dibuat ulang.

1. Konektor — serial number tidak bisa diedit. Field Serial Number pada form Edit Connector terkunci. API Electra menerima nilai barunya dan membalas success, tapi serialnya tetap yang lama — jadi CESA mengunci field itu daripada menampilkan “tersimpan” untuk perubahan yang tidak terjadi.

   

2. Klik tombol 🔄 Ganti SN / Slot Konektor tepat di bawah field itu. Formnya terbuka dengan semua data konektor lama sudah terisi — serial, slot, tipe, wattage, firmware, status — dan semuanya masih boleh diubah.

   1. Ganti serial number: ketik serial baru di field Serial Number. Kalau prefiksnya dikenali, wattage ikut menyesuaikan otomatis.
   2. Pindah slot saja: biarkan serialnya apa adanya, ubah Slot No. Connector No ikut menyesuaikan sendiri.
   3. Boleh juga keduanya sekaligus.

   Yang tidak boleh cuma satu: membiarkan serial dan slot sama persis — tidak ada yang perlu diganti.

   

3. Klik 🔄 Konfirmasi Ganti. CESA menghapus konektor lama lalu membuat konektor baru pada mesin yang sama dengan data yang kamu isi. Kalau slotnya tidak diubah, konektor baru menempati slot yang sama — slot lama otomatis bebas begitu yang lama dihapus, jadi nomornya tidak bergeser.
   
   Konektor baru punya id baru. Semua pemeriksaan dilakukan sebelum apa pun dihapus, dan kalau pembuatan konektor baru gagal, CESA mengembalikan konektor lama dan memberitahu kamu.
4. Riwayat pergantian serial tercatat. Klik 🕐 pada baris konektor yang baru untuk melihat serial lama, serial baru, waktu, dan siapa yang mengganti. Kalau yang kamu ubah cuma slotnya, tidak ada riwayat yang ditulis — serialnya memang tidak berganti.
   
   Catatan: ini hanya berlaku untuk pergantian lewat tombol tadi. Kalau kamu menghapus dan menambah konektor secara manual, CESA tidak tahu keduanya berhubungan, jadi tidak ada riwayat yang tercatat. Entri riwayat konektor yang tercatat sebelum batasan ini diketahui juga tidak bisa dipercaya — saat itu CESA mencatat pergantian yang ternyata tidak pernah tersimpan di Electra.

   

5. Mesin — serial number bisa diubah langsung. Di tab Machine, klik ✏️ pada barisnya, ganti Serial Number, lalu simpan.

   

6. Khusus mesin, CESA mencatat pergantiannya otomatis. Klik 🕐 pada baris yang sama untuk melihat riwayatnya — nomor lama, nomor baru, waktu, dan siapa yang mengubah. Electra menimpa serial number di tempat dan tidak menyimpan nilai lamanya, jadi riwayat ini hanya ada kalau penggantiannya dilakukan lewat CESA.

   

8 Cek & Monitor Data Lokasi / Mesin / Konektor

Melihat kondisi seluruh data tanpa mengubah apa pun.

Semua yang di bagian ini aman dibuka oleh siapa saja, termasuk role viewer.

1. Kartu di atas menghitung seluruh data dalam provider yang sedang dipilih — bukan hanya yang tampil di layar. Angka maintenance ditandai merah supaya kenaikannya tidak terlewat.

   

2. Angka di tab mengikuti filter yang sedang aktif, jadi bisa berbeda dari kartu di atas. Data yang sudah di-decommission tidak dihitung di mana pun.

   

3. Join Table menyatukan ketiga tingkat dalam satu tabel — paling berguna untuk memeriksa kelengkapan data. Filter Kelengkapan Data menyaring lokasi yang datanya belum lengkap, dan filter Public / Private memisahkan lokasi yang tidak tampil di aplikasi.

   

4. Saring dengan Kota, Cluster, atau Provinsi — ketik atau pilih dari daftar. Pencariannya memaklumi singkatan: Jogja dan Yogya sama-sama menemukan DI Yogyakarta. ↻ Refresh Data memuat ulang dari Electra.

   

5. Tabelnya mencakup seluruh lokasi, bukan hanya halaman yang tampil, dan dipaginasi 20 baris konektor. Kolom paling kanan Aksi membuka panel Edit Data lokasi itu.

   

6. Panel Edit Data menampilkan satu lokasi beserta seluruh mesin dan konektornya. Tiap baris punya tombol ✏️ edit dan 🔧 maintenance, plus tombol menambah PLN, mesin, dan konektor. Panel ini hanya membaca — tiap tombol membuka form yang sama seperti dari tab masing-masing, dengan lokasi atau mesinnya sudah terisi. Kalau berubah pikiran, tombol ← Edit Data di form mengembalikanmu ke panel ini.

   

7. Tab Machine dan Connector punya pencarian, filter status dan tipe, serta tombol Excel yang mengunduh tepat baris yang sedang tampil beserta catatan filternya.

   

8. Tab Connector bekerja sama persis, dan bisa dicari memakai nama lokasi maupun serial number mesinnya — tidak harus serial konektornya.

   

9 Cek & Monitor Data Maintenance

Melihat apa saja yang sedang tidak bisa dipakai sekarang.

Tab ini menjawab satu pertanyaan: apa yang sedang rusak, dan sudah berapa lama.

1. Tab Maintenance memuat lokasi, mesin, dan konektor yang sedang berstatus maintenance dalam satu daftar. Barisnya dikelompokkan per lokasi — lokasi dulu, lalu mesinnya, lalu konektor tiap mesin — jadi satu lokasi yang mati total terbaca sebagai satu blok.

   

2. Kolom Sudah Berjalan dihitung dari maintenance_since milik Electra, jadi ini lama sebenarnya. Kalau suatu unit tidak punya field itu, waktunya diperkirakan dari updated_at dan ditandai ≈.
3. Urutan lokasinya berdasarkan outage terlama, jadi yang paling perlu diperhatikan ada di atas. Tombol Selesaikan di setiap baris melakukan hal yang sama dengan alur nomor 6.

10 Cek Maintenance History

Melihat maintenance yang sudah selesai, bukan hanya yang sedang berjalan.

Electra hanya menyimpan waktu mulai maintenance yang sedang berlangsung. Begitu unitnya diperbaiki, jejaknya hilang di sana — riwayat ini milik CESA.

1. Dari tab Maintenance, klik 🕐 Maintenance History. Halamannya memuat satu baris per periode maintenance: apa, di mana, kapan mulai, dan kapan selesai.

   

2. Baris yang Maintenance End-nya masih - berarti unit itu sekarang masih maintenance. Durasinya dihitung sampai sekarang.
3. Tersedia filter jenis, filter masih berjalan / sudah selesai, rentang tanggal mulai, dan unduhan Excel.
4. Yang perlu diingat: riwayat ini dicatat CESA saat perubahannya terjadi. Maintenance yang di-set langsung di Electra, di luar CESA, tidak muncul di sini — begitu juga yang terjadi sebelum fitur ini ada.

11 Tambah / Edit Data PLN di suatu lokasi

Nomor meteran dan kapasitas listrik di lokasi itu.

Electra tidak punya kolom untuk data ini, jadi CESA menyimpannya di databasenya sendiri. Karena itu satu-satunya tempat data PLN ada.

1. Buka panel Edit Data lokasinya dari Join Table. Di bawah alamat ada baris data PLN — tombol ＋ kalau belum ada, atau ✏️ kalau sudah.

   

2. Isi PLN ID (nomor pelanggan meterannya) dan Kapasitas dalam kVA — boleh pecahan, karena PLN menjual 3.5, 7.7, 13.2 dan seterusnya. Entity diisi pemilik meterannya.

   

3. Pilih Dependency. Independent berarti meteran itu berdiri sendiri. Dependent berarti menumpang meteran lain — pilih itu dan kolom Parent PLN ID akan muncul untuk menunjuk meteran induknya.
4. Satu lokasi boleh punya lebih dari satu data PLN, karena satu tempat bisa punya beberapa meteran. Semuanya tampil di panel Edit Data dan di kolom PLN ID pada Join Table.
5. Semua data PLN juga bisa dilihat sekaligus di tab Data PLN, lengkap dengan pencarian, filter dependency, dan unduhan Excel. Tombol edit dan hapusnya ada di setiap baris.

   

6. Bedanya dengan menghapus lokasi: menghapus data PLN hanya menghapus baris itu dari database CESA. Lokasinya sendiri tidak tersentuh, dan tidak ada apa pun yang dikirim ke Electra.

12 Hapus Lokasi / Mesin / Konektor

Menghapus data secara permanen. Baca seluruhnya sebelum dipakai.

Ini satu-satunya alur di CESA yang tidak bisa dibatalkan.

1. Tombol 🗑 ada di panel Edit Data pada ketiga tingkat, dan di baris tabel Location serta Machine.

   

2. Menghapus lokasi ikut menghapus semua mesin dan konektor di dalamnya. Menghapus mesin ikut menghapus konektornya. Kotak konfirmasi menyebutkan satu per satu apa saja yang ikut terhapus — baca daftarnya, bukan hanya jumlahnya.

   

3. Kenapa ikut dihapus: Electra tidak menghapus turunannya sendiri. Kalau lokasinya dihapus lebih dulu, mesin dan konektor di dalamnya tertinggal menunjuk induk yang sudah tidak ada, dan tidak bisa diakses dari mana pun lagi. Karena itu CESA menghapus dari yang paling dalam: konektor, mesin, baru lokasi.
4. Tidak bisa dipulihkan. Setelah dihapus, datanya tidak bisa dibaca lagi lewat API Electra — termasuk untuk dikembalikan. Kalau unitnya hanya sedang tidak dipakai, gunakan status maintenance (alur nomor 5), bukan hapus.

? Kalau ada yang salah

Semua perubahan tercatat. Admin bisa melihat siapa mengubah apa dan kapan lewat Access History di menu profil — bisa disaring per user, per jenis aksi (Tambah / Ubah / Maintenance / Hapus), dan per rentang tanggal.

Penghapusan lokasi, mesin, dan konektor hilang sepenuhnya dari API Electra: tidak muncul lagi di daftar mana pun, dan tidak ditandai decommissioned. Datanya sendiri masih tersimpan di database Electra dengan penanda waktu hapus, jadi pemulihan masih mungkin — tapi lewat tim backend langsung ke database, bukan lewat CESA. Karena itu Access History penting: begitu record hilang dari Electra, catatan di sinilah satu-satunya bukti kapan dan oleh siapa dihapus.