Skip to content

Latest commit

 

History

History
155 lines (122 loc) · 6.91 KB

e2e-at-cpp-development.md

File metadata and controls

155 lines (122 loc) · 6.91 KB

Panduan E2E AT Corporate and Patient Portal Development

Berikut merupakan panduan dalam mengembangkan e2e automation test menggunakan Codeceptjs dan Monika.

Konten:

  1. Environment
  2. Execution Guideline
  3. Naming
  4. Flow
  5. Tips & Trick
  6. Known Problem

1. Environment

Bagian environment Codeceptjs yang wajib untuk dipahami secara berurutan antara lain:

  1. Package
  2. Configuration
  3. Terminal Command (CLI)
  4. Basic Command/Function
  5. Debug
  6. Retries
  7. Conditional Actions
  8. Multiple Sessions

Bagian environment Monika yang wajib untuk dipahami secara berurutan antara lain:

  1. Configuration
  2. Terminal Command (CLI)
  3. Probes
  4. Alerts and Notifications
  5. Debug

2. Execution Guideline

Secara default alur utama pembuatan e2e automation test pada platform corporate and patient portal mengikuti alur umum e2e testing akan tetapi pendekatan automation pada modul yang telah dikerjakan akan diterapkan di iterasi berikutnya.

Alur pengujian dilakukan secara berurutan setiap modul dengan melengkapi kebutuhan pendekatan manual, membuat script automation, dan deploy ke server untuk dijalankan secara berkala setiap hari.

Berikut checklist pengujian yang mesti dilakukan beserta statusnya:

Functional

Daftar teknik/pengujian:

  • Unit testing
  • Integration testing (Done - Manual)
  • Smoke testing (Done - Manual/Automation)
  • Sanity testing (Done - Manual)
  • Regression testing (Done - Manual/Automation)
  • Exploratory testing (Done - Manual)
  • User acceptance testing

Non Functional

Daftar teknik/pengujian:

  • Load testing
  • Performance testing
  • Stress testing
  • Security testing
  • Accessibility testing

3. Naming

Beberapa aturan secara umum yang perlu diperhatikan dalam naming adalah:

  • Jika nama terlalu panjang, bisa menggunakan akronim (ex: edit data pasien = edp).
  • Hindari nama yang kompleks & panjang.

Test Script

File test script disimpan dalam folder sesuai platform/sistemnya cp/pp dan memiliki aturan dalam penamaan untuk memudahkan identifikasi & kegunaan, yakni:

  • Simple Modul: <Akronim/Nama Modul/Page>_test (ex: companyemployee_test, ce_test).
  • Specific Modul: <Akronim/Nama Modul>_<Akronim/Nama Deskripsi>_test (ex: companyemployee_registrasi_test, ce_registrasi_test).

Penamaan skenario dalam test script memiliki aturan dalam penamaan untuk memudahkan identifikasi & kegunaan, yakni:

  • Parent: Saya sebagai <Peran (Role)> <Aktivitas/Use Case> di <Nama Platform/Sistem> <Deskripsi/Keterangan> (ex: Saya sebagai user gagal registrasi karyawa di corporate portal karena tidak mengisi tipe pendaftar, Saya sebagai user melihat daftar karyawan perusahaan di corporate portal).
  • Child: Saya sebagai <Peran (Role)> <Aktivitas/Use Case> <Deskripsi/Keterangan> (ex: Saya sebagai super admin gagal mengubah data karyawan, Saya sebagai user mengakses halaman daftar perusahaan melalui halaman analytics).

Penamaan parent digunakan untuk menamai skenario utama (ex: Scenario("nama parent skenario") dan child untuk penanda sub-scenario atau keterangan alur dalam skenario utama (ex: I.say('nama child skenario')).

Penamaan untuk skenario utama/test case yang tidak dimasukan dalam pengujian mengikuti format child dan dimasukan di bagian akhir skenario utama yang terkait atau skenario utama terakhir yang dijalankan dalam sebuah test script.

Widget/UI Components

Masing - masing widget/ui components memiliki aturan dalam penamaan untuk memudahkan identifikasi & kegunaan, yakni:

  • Text/Label: txt_<Nama>/txt_<Nama>_<Akronim Deskripsi> (ex: txt_title, txt_count_lbl).
  • Text Field: tf_<Nama>/tf_<Nama>_<Akronim Deskripsi> (ex: tf_email).
  • Dropdown/Select: dd_<Nama> (ex: dd_status).
  • Checkbox: cb_<Nama> (ex: cb_reason).
  • Radio Button: rb_<Nama> (ex: rb_gender).
  • Button: btn_<Nama> (ex: btn_save).
  • Divider: div_<Nama> (ex: div_assessment).
  • Section: sec_<Nama> (ex: sec_clinic).
  • Table: tbl_<Nama> (ex: tbl_data).

Untuk kasus file yang tak punya aturan penamaan, by default mengikuti aturan penamaan <Nama Komponen>_<Nama>_<Akronim Deskripsi>.

Selain itu, penamaan komponen dalam table/daftar, tinggal menambahkan urutan dari data yang tampil setelah penamaan komponennya. <Nama Komponen>_<Nama>_<Akronim Deskripsi>_<Urutan> (ex: txt_product_title_0, btn_detail_0, btn_edit_0).

Selain penamaan komponen widget/ui components, penamaan atribut class pada widget/ui components juga memiliki aturan umum yang mengikuti format pada Tailwind. Tim frontend developer belum dapat menentukan format urutan atribut class yang digunakan sehingga belum ada cara untuk mendeteksi atribut class menggunakan pola dan harus mengecek secara manual melalui dokumentasi di tailwind #hiks.

4. Flow

Alur dalam penyusunan test script secara default terdiri dari 4 alur/skenario, yakni:

Pembacaan Data

  • Akses halaman.
  • Pencarian data.
  • Penerapan Filter.
  • Menampilkan rincian data.
  • Mengecek komponen tampilan.
  • Mengecek data.
  • Pagination (opsional).

Penambahan Data

  • Akses halaman tambah.
  • Mengecek komponen tampilan.
  • Menambah data.

Perubahan Data

  • Pencarian data.
  • Akses halaman ubah.
  • Mengecek komponen tampilan.
  • Mengecek data.
  • Menyimpan data.

Penghapusan Data

  • Pencarian data.
  • Mengecek data.
  • Menghapus data.

Pendaftaran

  • Akses halaman daftar.
  • Mengecek komponen tampilan.
  • Mengirim data.

Untuk alur lainnya ditambahkan dan disesuaikan dengan kebutuhan bisnis.

5. Tips & Trick

Berikut daftar saran yang sebaiknya dilakukan saat melakukan pengembangan:

  1. Duplicate before create, sebelum membuat script baru pastikan untuk mengecek apa yang sudah ada untuk menghindari kondisi buat dari awal.
  2. Stable internet connection is a must, untuk kesehatan mental yang lebih baik.
  3. Codeceptjs is prime suspect before your code, bug aneh? silakan cek bagian known problem dan forum curhat terlebih dahulu.
  4. Start with small scenario, pastikan untuk membagi scenario secara kecil untuk memudahkan debugging.
  5. Don't forget waiting time, selalu gunakan wait untuk semua perintah crud maupun navigasi halaman.
  6. Styling and content first, pastikan untuk mengecek styling dan konten yang ditampilkan.

6. Known Problem

Berikut daftar masalah yang teridentifikasi sebagai bug/anomaly/error aneh yang ditemukan dalam pengembangan:

  1. Butuh waktu tunggu lebih untuk proses cud sehingga perlu diatur lebih lama (current accepted waiting time = 7-15 seconds).

Silakan tambahkan kesini jika menemukan bug/anomaly/error aneh terbaru dan tambahkan label [Solved] jika tidak pernah terjadi lagi atau ada pemberitahuan masalah tersebut telah diselesaikan.