XXX Ty
XXX Ty
Copyright © 2021 PT. Paramadaksa Teknologi Nusantara. All rights reserved. These
materials are confidential and proprietary to PT. Paramadaksa Teknologi Nusantara and
no part of these materials should be reproduced, published in any form by any means,
electronic or mechanical including photocopy or any information storage or retrieval
system nor should the materials be disclosed to third parties without the express written
authorization of PT. Paramadaksa Teknologi Nusantara.
Riwayat Versi
Versi Tanggal Penulis Riwayat
1.0.0 08/06/2021 Emil Kevin Release Pertama
Lamsundy
Daftar Isi
Riwayat Versi..............................................................................................................................................2
Daftar Isi......................................................................................................................................................3
Daftar Gambar............................................................................................................................................4
Daftar Tabel................................................................................................................................................4
Kaidah Simbol dan Istilah...........................................................................................................................5
Lembar Persetujuan....................................................................................................................................8
1. Pendahuluan........................................................................................................................................9
1.1. Tujuan Dokumen.........................................................................................................................9
1.2. Latar Belakang.............................................................................................................................9
1.3. Simbol dan Singkatan..................................................................................................................9
1.3.1. Tipe Field.............................................................................................................................9
1.4. Tipe Data....................................................................................................................................11
2. Struktur Kebutuhan...........................................................................................................................11
2.1. Gambaran Umum......................................................................................................................11
2.1.1. Deskripsi............................................................................................................................11
2.1.2. Batasan Pembahasan.........................................................................................................11
3. Solusi Kebutuhan...............................................................................................................................11
3.1. Route Plan.................................................................................................................................11
3.1.1. Process Flow Pembuatan Weekly Route plan....................................................................11
3.1.2. Process Flow Edit Weekly Route Plan................................................................................14
3.1.3. Process Flow Delete Weekly Route Plan............................................................................15
3.1.4. CUD Route Plan..................................................................................................................16
3.1.5. Action Control....................................................................................................................22
3.1.6. Route Pricing......................................................................................................................24
3.1.7. Parameter Pada Weekly Route Plan..................................................................................24
3.1.8. Penambahan Tabel Baru Untuk Weekly Route Plan..........................................................26
3.2. Route Plan Armada....................................................................................................................31
3.2.1. Flow Route Plan Armada....................................................................................................31
3.2.2. Pembuatan Menu Route Plan Armada..............................................................................32
3.2.3. Action Control....................................................................................................................35
3.2.4. Pembuatan Table Baru Untuk Route Plan Armada............................................................37
3.3. Synchronize Weekly Routeplan to GroMart..............................................................................38
3.3.1. Penambahan Informasi Estimasi Pengiriman.....................................................................38
3.3.2. Penambahan Tabel untuk Synchronization Route Plan.....................................................39
Daftar Gambar
Figure 1 Flowchart pembuatan Weekly Route Plan pada ND6....................................................................9
Figure 2 Flowchart Proses edit Weekly Route Plan pada ND6...................................................................11
Figure 3 Flowchart delete Weekly Route Plan pada ND6..........................................................................12
Figure 4 Menu Utama Route Plan.............................................................................................................13
Figure 5 Tampilan view map pada sebuah detail rute...............................................................................14
Figure 6 Form header Pembuatan weekly route plan...............................................................................14
Figure 7 Pemilihan hari pada pembuatan weekly route plan....................................................................15
Figure 8 Form weekly route plan details...................................................................................................15
Figure 9 Gambar tampilan map saat pembuatan rute..............................................................................16
Figure 10 Detail hover pada titik customer saat pembuatan weekly route plan.........Error! Bookmark not
defined.
Figure 11 Proses penambahan titik lokasi customer dan non-customer...................................................17
Figure 12 Contoh tampilan pembuatan rute.............................................................................................18
Figure 13 Confirmation dialog save weekly route plan..............................................................................19
Figure 14 Flowchart Route Plan Armada pada ND6...................................................................................27
Figure 15 Tampilan menu utama route plan armada................................................................................28
Figure 16 Detail form route plan armada..................................................................................................29
Figure 17 Penugasan rute pada weekly route plan...................................................................................30
Figure 18 Detail route plan pada google map pada route plan armada....................................................31
Figure 19 Radio button pemilihan tipe replikasi route plan armada.........................................................31
Daftar Tabel
Table 1-1 Tabel Tipe Field............................................................................................................................6
Table 1-2 Tabel Tipe Data............................................................................................................................8
Table 3-1 Tabel Field Description Weekly Route Plan...............................................................................14
Table 3-2 Tabel Action Control Weekly Route Plan...................................................................................19
Table 3-3 Tabel Parameter Weekly Route Plan.........................................................................................21
Table 3-4 Tabel Database routeplan..........................................................................................................22
Table 3-5 Tabel Database routeplandetail.................................................................................................23
Table 3-6 Tabel Database routelocation....................................................................................................24
Table 3-7 Tabel Field Description Route Plan Armada...............................................................................29
Table 3-8 Tabel Action Control Route Plan Armada..................................................................................31
Table 3-9 Tabel Database armadarouteplan.............................................................................................33
Kaidah Simbol dan Istilah
a. Tipe Kolom
LBL Label
DPL Date Pick List
SCH Search
PHT Photo
or
LUMLO Look Up Multi Line Option
b. Tipe Data
c. Status Kolom
C System calculated Kolom yang berisikan nilai yang berasal dari hasil
perhitungan tertentu
d. Tipe Kontrol
2.1.2.Batasan Pembahasan
Dalam pengembangan sistem NexTrac2 fase 2, tentunya ada beberapa batasan fitur.
Adapun batasan fitur yang dibuat adalah sebagai berikut:
a. Tiap user hanya memiliki 1 data group, dan 1 data group dapat terdiri dari satu atau lebih
data scope.
b. Migrasi master database hanya terkait master yang berkaitan dengan instalasi customer
yaitu salesman, customer, customer installation, dan user login, dan existing data
mengenai lisensi produk. Untuk seluruh database yang berkaitan dengan sistem billing
dari NexTrac, tidak akan dimigrasikan ke NexTrac2
c. Migrasi master database akan mengikuti skema tabel NexTrac2 yang sudah berhubungan
dengan projek Authentication server dan Master Data.
d. Prelicense merupakan master untuk membuat detil lisensi berdasarkan lisensi produk
yang telah dibeli oleh customer. Dalam hal ini dibeli yang dimaksudkan adala secara
sistem telah ditambahkan pada customer installation dan dicetak proforma invoice-nya
pada NexTrac, serta telah dibayarkan oleh customer dan diverifikasi oleh pihak finance.
e. Prelicense dibuat di NexTrac2 untuk nantinya dijadikan acuan untuk menghasilkan
product key saat diminta oleh sistem external untuk menghasilkan product key sebelum
aktivasi.
f. License akan dihasilkan berdasarkan permintaan aktivasi dilakukan dari sisi customer
melalui aplikasi. Detail mengenai lisensi akan dibahas pada subbab selanjutnya.
g. License hanya akan dihasilkan setelah product key sudah dihasilkan oleh sistem
NexTrac2 setelah permintaan dilakukan oleh product yang memiliki client ID yang telah
memiliki prelicense yang valid.
h. Baik Online / Offline validation, akan dilakukan dari sisi aplikasi yang secara berkala
menggunakan scheduler dan jalan pada background process. Nantinya akan dilakukan
validasi lisensi secara berkala untuk sistem menggunakan API NexTrac2. Pada ND6 juga
akan dilakukan pengecekan secara offline secara berkala untuk memastikan apakah
lisensi tersebut valid / tidak dan pengecekan untuk mewajibkan ND6 untuk online secara
berkala.
i. Offline validation hanya akan terbatas pada aplikasi on-premise yaitu ND6, yang
memiliki server sendiri dan bisa jalan secara offline.
j. Data master yang dapat disinkronisasi dari NexTrac hanya data yang berkaitan dengan
customer installation.
k. NexTrac2 API digunakan untuk sinkronisasi data master dari NexTrac, proses aktivasi
lisensi online, registrasi client ID dan authentication, dan validasi lisensi secara online.
l. Data master akan digunakan sebagai referensi profil data orang maupun perusahaan
(customer).
3. Solusi Kebutuhan
3.1. Arsitektur Sistem NexTrac2
Berdasarkan latar belakang dan kebutuhan sistem di atas, NexTrac2 akan dikembangkan
sebagai sistem internal Nexsoft penghubung antar customer dan Nexsoft dalam hal aktivasi
lisensi software sebagai pengembangan dari NexTrac versi yang sekarang di mana NexTrac
hanya mencatat instalasi produk dari setiap customer dan billing (pembelian dan perpanjangan)
license dari customer. Nantinya NexTrac2 akan berdiri sebagai salah satu SaaS (Software as a
Service) untuk menangani mengenai aktivasi lisensi software secara online yang dilakukan oleh
customer melalui produk terkait.
Pada gambar di atas, merupakan arsitektur sistem pada NexTrac2 berikut komponen-nya
dan sistem lain yang berhubungan. Berikut adalah penjelasan dari tiap komponen berikut aksi
yang dapat dilakukan oleh sistem:
Table 3-6 Komponen arsitektur sistem
Komponen Keterangan
Menu
Pembatas
# Menu Menu Menu Aksi Permission Keterangan Menu Terkait
an Aksi
Lv 1 Lv 2 Lv 3
Kategor
master.konsumen.ka Digunakan untuk mengakses halaman
w. Maste konsum i Master-konsumen-
View All tegori_konsumen:vi pada menu master-konsumen-kategori
r en konsum kategori konsumen
ew konsumen dengan akses aksi view
en
Kategor
master.konsumen.ka Digunakan untuk akses halaman pada
bb.Maste konsum i Master-konsumen-
Delete All tegori_konsumen:de menu master-konsumen-grup
r en konsum grup konsumen
lete konsumen dengan akses aksi delete
en
master.konsumen.k
hh.Maste konsum konsum
Update All onsumen:update_o
r en en
wn
ii. Maste konsum konsum master.konsumen.k
Delete All
r en en onsumen:delete
master.konsumen.k
jj. Maste konsum konsum
Delete own onsumen:delete_ow
r en en
n
Lokasi
kk.Maste konsum master.konsumen.lo
konsum View All
r en kasi_konsumen:view
en
Lokasi master.konsumen.
ll. Maste konsum
konsum View Own lokasi_konsumen:vie
r en
en w_own
Lokasi master.konsumen.
Maste
mm. konsum
konsum Insert All lokasi_konsumen:ins
r en
en ert
Lokasi master.konsumen.
nn.Maste konsum
konsum Update All lokasi_konsumen:up
r en
en date
Lokasi master.konsumen.
oo.Maste konsum
konsum Update All lokasi_konsumen:up
r en
en date_own
Lokasi master.konsumen.
pp.Maste konsum
konsum Delete All lokasi_konsumen:de
r en
en lete
Lokasi master.konsumen.
qq.Maste konsum
konsum Delete own lokasi_konsumen:de
r en
en lete_own
uu.Maste master.produk:upda
produk All Update All
r te
vv.Maste master.produk:upda
produk All Update All
r te_own
Maste
ww. master.produk:delet
produk All Delete All
r e
xx.Maste master.produk:delet
produk All Delete own
r e_own
Maste
aaa. Grup master.produk.grup
produk Insert All
r Produk _produk:insert
Maste
bbb. Grup master.produk.grup
produk Update All
r Produk _produk:update
master.produk.grup
ccc.Maste Grup
produk Update All _produk:update_ow
r Produk
n
Maste
ddd. Grup master.produk.grup
produk Delete All
r Produk _produk:delete
Maste
eee. Grup master.produk.grup
produk Delete own
r Produk _produk:delete_own
fff.Maste master.produk.prod
produk Produk View All
r uk:view
Maste
ggg. master.produk.prod
produk Produk View Own
r uk:view_own
Maste
hhh. master.produk.prod
produk Produk Insert All
r uk:insert
Maste
kkk. master.produk.prod
produk Produk Delete All
r uk:delete
Maste
nnn. master.lisensi:view_
Lisensi All View Own
r own
Maste
ooo. Lisensi All Insert All master.lisensi:insert
r
Maste
ppp. master.lisensi:updat
Lisensi All Update All
r e
Maste
qqq. master.lisensi:updat
Lisensi All Update All
r e_own
rrr.Maste Lisensi All Delete All master.lisensi:delete
r
sss.Maste master.lisensi:delete
Lisensi All Delete own
r _own
Maste
uuu. Tipe master.lisensi.tipe_li
Lisensi View Own
r Lisensi sensi:view_own
Maste
vvv. Tipe master.lisensi.tipe_li
Lisensi Insert All
r Lisensi sensi:insert
Maste
www. Tipe master.lisensi.tipe_li
Lisensi Update All
r Lisensi sensi:update
Maste
yyy. Tipe master.lisensi.tipe_li
Lisensi Delete All
r Lisensi sensi:delete
Maste
aaaa. Versi master.lisensi.versi_l
Lisensi View All
r Lisensi isensi:view
Maste
bbbb. Versi master.lisensi.versi_l
Lisensi View Own
r Lisensi isensi:view_own
Maste
cccc. Versi master.lisensi.versi_l
Lisensi Insert All
r Lisensi isensi:insert
Maste
dddd. Versi master.lisensi.versi_l
Lisensi Update All
r Lisensi isensi:update
Maste
eeee. Versi master.lisensi.versi_l
Lisensi Update All
r Lisensi isensi:update_own
Maste
hhhh. Prelisen master.lisensi.prelis
Lisensi View All
r si ensi:view
Maste
kkkk. Prelisen master.lisensi.prelis
Lisensi Delete All
r si ensi:delete
llll.Maste Prelisen master.lisensi.prelis
Lisensi Delete own
r si ensi:delete_own
Maste
mmmm. Lisensi master.lisensi.lisensi
Lisensi View All
r Produk _produk:view
Maste
nnnn. Lisensi master.lisensi.lisensi
Lisensi Insert All
r Produk _produk:insert
Maste
oooo. Lisensi master.lisensi.lisensi
Lisensi Update All
r Produk _produk:update
master.lisensi.lisensi
Maste
pppp. Lisensi
Lisensi Update own _produk:update_ow
r Produk
n
Lisensi
Maste
qqqq. Master.lisensi.lisensi
Lisensi Nexmil View All
r _nexmile:view
e
Jenis Pembatas
# Scope Digunakan untuk Keterangan
data an
Menu
Pembatas
# Menu Menu Menu Aksi Permission Keterangan Menu Terkait
an Aksi
Lv 1 Lv 2 Lv 3
- Tidak ada dalam pemilihan hak akses Admin
di halaman role, tetapi setiap role yang
ditambahkan, otomatis akan
rrrr. mendapatkan permission ini
Admin All All View Own admin:view_own
- Digunakan untuk mengakses seluruh
halaman yang berkaitan dengan admin
dengan akses aksi update data diri
sendiri (profile dan atau sandi)
- Tidak ada dalam pemilihan hak akses admin
di halaman role, tetapi setiap role yang
ditambahkan, otomatis akan
ssss. mendapatkan permission ini
Admin All All Update Own admin:update_own
- Digunakan untuk mengakses seluruh
halaman yang berkaitan dengan admin
dengan akses aksi update data diri
sendiri (profile dan atau sandi)
- Tidak ada dalam pemilihan hak akses Admin-pengguna
di halaman role, tetapi setiap role yang
ditambahkan, otomatis akan
tttt.Admin Penggu admin.pengguna:up mendapatkan permission ini
All Update Own
na date_own - Digunakan untuk mengakses seluruh
halaman pada admin-pengguna dengan
hak akses update untuk data diri sendiri
(profile dan atau sandi)
- Tidak ada dalam pemilihan hak akses Admin-pengguna-
di halaman role, tetapi setiap role yang pengguna
ditambahkan, otomatis akan
uuuu. Penggu Penggu admin.pengguna.pe mendapatkan permission ini
Admin Update Own
na na ngguna:update_own - Digunakan untuk mengakses halaman
admin-pengguna-pengguna dengan hak
akses update untuk data diri sendiri
(profile dan atau sandi)
- Tidak ada dalam pemilihan hak akses Admin-kredit
di halaman role, tetapi setiap role yang
vvvv. ditambahkan, otomatis akan
Admin Kredit All View All admin.kredit:view
mendapatkan permission ini
- Digunakan untuk mengakses halaman
kredit
master
Digunakan untuk akses seluruh
Maste
wwww. All All View All Master:view halaman pada menu master dengan
r
akses aksi view
master
Digunakan untuk akses seluruh
Maste
xxxx. halaman pada menu master dengan
All All View Own Master:view_own
r akses aksi view untuk data yang dibuat
oleh user terkait
master
Digunakan untuk akses seluruh
Maste
yyyy. All All Insert All Master:insert halaman pada menu master dengan
r
aksi insert
master
Digunakan untuk akses seluruh
Maste
zzzz. All All Update All Master:update halaman pada menu master dengan
r
aksi update
master
Digunakan untuk akses seluruh
Maste
aaaaa. halaman pada menu master dengan
All All Update Own Master:update_own
r aksi update pada data yang dibuat oleh
user terkait
master
Digunakan untuk akses seluruh
Maste
bbbbb. All All Delete All Master:delete halaman pada menu master dengan
r
aksi delete
master
Digunakan untuk akses seluruh
Maste
ccccc. halaman pada menu master dengan
All All Delete Own Master:delete_own
r aksi delete pada data yang dibuat oleh
user terkait
Master-konsumen
Digunakan untuk akses seluruh
Maste
ddddd. Konsu Master.konsumen:vi
All View All halaman pada menu master-konsumen
r men ew
dengan akses aksi view
Master-konsumen
Digunakan untuk akses seluruh
Maste
eeeee. Konsu Master.konsumen:vi halaman pada menu master-konsumen
All View Own
r men ew_own dengan akses aksi view untuk data yang
dibuat oleh user terkait
Master-konsumen
Digunakan untuk akses seluruh
Maste
fffff. Konsu Master.konsumen:in
All Insert All halaman pada menu master-konsumen
r men sert
dengan aksi insert
Master-konsumen
Digunakan untuk akses seluruh
Maste
ggggg. Konsu Master.konsumen:u
All Update All halaman pada menu master-konsumen
r men pdate
dengan aksi update
Master-konsumen
Digunakan untuk akses seluruh
Maste
hhhhh. Konsu Master.konsumen:upd halaman pada menu master-konsumen
All Update Own
r men ate_own dengan aksi update pada data yang
dibuat oleh user terkait
Master-konsumen
Digunakan untuk akses seluruh
iiiii.Maste Konsu Master.konsumen:del
All Delete All halaman pada menu master-konsumen
r men ete
dengan aksi delete
Master-konsumen
Digunakan untuk akses seluruh
jjjjj.Maste Konsu Master.konusmen:del halaman pada menu master-konsumen
All Delete Own
r men ete_own dengan aksi delete pada data yang
dibuat oleh user terkait
Master-konsumen-
pemetaan klien
Digunakan untuk akses halaman menu
Maste
kkkkk. Konsu Pemeta Master.konusmen.pe
View All master-konsumen-pemetaan klien
r men an klien metaan_klien:view
dengan akses aksi view
Master-konsumen-
pemetaan klien
Digunakan untuk akses halaman menu
lllll.Maste Konsu Pemeta Master.konusmen.pe
Update All master-konsumen-pemetaan klien
r men an klien metaan_klien:update
dengan aksi update
Master-konsumen-
pemetaan klien
Pemeta Master.konusmen.pe Digunakan untuk akses halaman menu
Maste Konsu
mmmmm. PKCE
an klien View All metaan_klien_pkce:vi master-konsumen-pemetaan klien
r men ew
PKCE PKCE dengan akses aksi view
Master-konsumen-
pemetaan klien
Pemeta Master.konusmen.pe Digunakan untuk akses halaman menu
Maste
nnnnn. Konsu PKCE
an klien Update All metaan_klien_pkce:up master-konsumen-pemetaan klien
r men date
PKCE PKCE dengan aksi update
3.6. Penambahan Tabel Penunjang Lainnya