LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
SERVER-SIDE MODULE
CONTENTS
This module has the following files:
1. MODULE_SERVER_SIDE.doc
2. MODULE_SEVER_SIDE_MEDIA.zip
INTRODUCTION
We know that the pandemic is not over yet and vaccination is something that must be done to
be able to reduce the death rate against the COVID-19 attack. So the government appoints you
as a competent person to create a vaccination registration platform.
The goal of this platform is so that societies can register vaccinations on the platform without
having to come to the vaccine spot directly and can also see when and where society can come
to the vaccine spot.
DESCRIPTION OF PROJECTS AND TASKS
Vaccination registration involves the society platform (request consultation and register
first/second vaccination), doctor platform (see and accept/reject consultation from society), and
officer platform (update vaccination data from society such as giving vaccines and determining
who the vaccinator is).
But your scope of work on this module is only to create a society platform. This module is divided
into two phases:
- Phase one for creating a Society Vaccination REST API using one of the provided PHP
frameworks
- Phase two for building a Frontend using provided JavaScript libraries (react/angular/vue)
of the Society Vaccination Platform
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
Phase one - Vaccination REST API
Authentication
Before a society performs any activity on the society platform, they must be logged in using
their ID card number and password. After successfully logging in, the token will be
automatically generated from the md5 of society ID card number.
Specifications :
Feature: A1 - Login and Logout as society: as a visitor, i want to
login so that i can enter the system and register a vaccination.
Scenario: Society Login
Request:
URL: [domain]/api/v1/auth/login
Method: POST
Header:
Body: { id_card_number: “SomeText”, password: “SomeText” }
Response:
A1a - If login success
Header: Response code: 200
Body: {
"name": "Siti Puspita",
"born_date": "1974-10-22",
"gender": "male"|”female”,
"address": "Ki. Raya Setiabudhi No. 790",
"token": "e96aaafb6f2f76460b8cc93723bd030e",
"regional": {
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
"id": 1,
"province": "DKI Jakarta",
"district": "Central Jakarta"
A1b - If ID Card Number or Password incorrect
Header: Response code: 401
Body: { "message": "ID Card Number or Password incorrect" }
Scenario: Society Logout
Request:
URL: [domain]/api/v1/auth/logout
Params: { token }
Method: POST
Header:
Body:
Response:
A1c - If logout success
Header: Response code: 200
Body: { "message": "Logout success" }
A1d - If logout invalid token
Header: Response code: 401
Body: { "message": "Invalid token" }
Request Consultation
To be able to register a vaccine, the society must consult with a doctor on the platform first. The
society can view consultation status and make consultation requests. The society can only
make one vaccination request.
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
Specifications:
Feature: A2 - Request Consultation: As a society, I want to request
consultation so that I can register for vaccination when my
consultation is accepted.
Scenario: Request consultation
Request:
URL: [domain]/api/v1/consultations
Params: { token }
Method: POST
Header:
Body: { disease_history: “SomeText”, current_symptoms:
“SomeText” }
Response:
A2a - If request consultation success
Header: Response code: 200
Body: { "message": "Request consultation sent successful" }
A2b - If invalid token
Header: Response code: 401
Body: { "message": "Unauthorized user" }
Scenario: Get society consultation
Request:
URL: [domain]/api/v1/consultations
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
Params: { token }
Method: GET
Header:
Body:
Response:
A2c - If success
Header: Response code: 200
Body: {
“consultation”: {
"id": 1,
"status": "pending”|”accepted”|”rejected",
"disease_history": "SomeText”|null,
"current_symptoms": "SomeText"|null,
"doctor_notes": “SomeText”|null,
"doctor": { DOCTOR }|null
A2d - If invalid token
Header: Response code: 401
Body: {"message": "Unauthorized user"}
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
Vaccination Spot
When the consultation has been accepted by the doctor and society will register the
vaccination, the society can choose the vaccination spot based on the society region. List of
available vaccines at each vaccine spot should also be displayed.
In the spot detail, calculate the number of vaccination registrations at that spot and on the
requested date in the date param (optional and default today).
Specifications:
Feature: A3 - Vaccination Spot: As a society, I want to see
vaccination spots in my region.
Scenario: Get all vaccine spots by society region
Request:
URL: [domain]/api/v1/spots
Params: { token }
Method: GET
Header:
Body:
Response:
A3a - If success
Header: Response code: 200
Body: {
“spots”: [
"id": 1,
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
"name": "Purnawati Hospital",
"address": "Jr. Gotong Royong",
"serve": 1|2|3,
"capacity": 15,
"available_vaccines": {
"Sinovac": true,
"AstraZeneca": false,
"Moderna": true,
"Pfizer": true,
"Sinnopharm": false
},
...,
A3b - If invalid token
Header: Response code: 401
Body: { "message": "Unauthorized user" }
Scenario: Get spot detail by spot ID and date
Request:
URL: /api/v1/spots/<spot_id>
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
Params: { token, date (optional and default today) }
Method: GET
Header:
Body:
Response:
A3c - If success
Header: Response code: 200
Body: {
"date": "October 21, 2021",
"spot": {
"id": 1,
"name": "Purnawati Hospital",
"address": "Jr. Gotong Royong No. 264",
"serve": 2,
"capacity": 15
},
"vaccinations_count": 12
A3d - If invalid token
Header: Response code: 401
Body: { "message": "Unauthorized user" }
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
Vaccination Registration
The society can register for vaccination if the society consultation has been accepted by the
doctor. At the vaccination register, if the society has finished the first vaccination, it will
automatically register the second vaccination.
Society can register for a second vaccination on condition that they have to wait 30 days after
the first vaccination day and each society can only register for vaccination 2 times. Society can
be said to be vaccinated if it has received a dose of the vaccine.
Spot ID and date must be filled where the date format is YYYY-MM-DD.
Specifications:
Feature: A4 - Vaccination: as a society, i want to register
vaccination and get all vaccination data.
Scenario: Register Vaccination
Request:
URL: /api/v1/vaccinations
Params: { token }
Method: POST
Header:
Body: { spot_id: 1, date: “2021-10-26” }
Response:
A4a - If success
Header: Response code: 200
Body: { "message": "First|Second vaccination registered
successful" }
A4b - If invalid token
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
Header: Response code: 401
Body: { "message": "Unauthorized user" }
A4c - If the society consultation hasn’t accepted by doctor
Header: Response code: 401
Body: { "message": "Your consultation must be accepted by
doctor before" }
A4d - If invalid fields
Header: Response code: 401
Body: {
"message": "Invalid field",
"errors": {
"date": [
"The date does not match the format Y-m-d."
],
"spot_id": [
"The spot id field is required."
]
}
}
A4e - If 2nd vaccination < 30 days from 1st vaccination
Header: Response code: 401
Body: { "message": "Wait at least +30 days from 1st
Vaccination" }
A4f - If have been 2x vaccinated
Header: Response code: 401
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
Body: { "message": "Society has been 2x vaccinated" }
Scenario: Get all of society vaccinations
Request:
URL: [domain]/api/v1/vaccinations
Params: { token }
Method: GET
Header:
Body: Response:
A4g - If success
Header: Response code: 200
Body: {
“vaccinations”: {
"first": {
"queue": 1,
"dose": 1,
"vaccination_date": "2021-10-21",
"spot": {
"id": 1,
"name": "Purnawati Hospital",
"address": "Jr. Gotong Royong",
"serve": 2,
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
"capacity": 15,
"regional": {
"id": 1,
"province": "DKI Jakarta",
"district": "Central Jakarta"
},
"status": "done",
"vaccine": {
"id": 1,
"name": "Sinovac"
},
"vaccinator": {
"id": 1,
"role": "doctor",
"name": "Dr. Halima Yuniar"
},
"second": <VACCINATION>|null
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
LOMBA KOMPETENSI SISWA
SEKOLAH MENENGAH KEJURUAN
TINGKAT PROVINSI JAWA BARAT
TAHUN 2022
A4h - If invalid token
Header: Response code: 401
Body: { "message": "Unauthorized user" }
Soal LKS SMK Tingkat Provinsi Jawa Barat Tahun 2022 – Web Technologies – Server Side
