Vote CSUI

Website sederhana untuk voting nama angkatan Fasilkom menggunakan SSO UI.

Daftar Isi

1. Penjelasan Singkat
2. Persiapan Awal
3. Deployment
4. Petunjuk Khusus Contributors
5. Contributors

Penjelasan Singkat

Kriteria Pemilihan Nama Angkatan

Jika sekarang adalah tahun n, maka :

• Nama angkatan yang dipilih adalah nama angkatan untuk CSUI angkatan tahun n
• User yang dapat ikut memilih nama angkatan hanyalah mahasiswa Fakultas Ilmu Komputer angkatan tahun n-1, n-2, n-3, dst dengan syarat akun SSO UI-nya masih aktif

Hasil Pemilihan Nama Angkatan

• Hasil pemilihan nama angkatan dapat dilihat pada route /result
• Admin hanya terdiri atas 1 (satu) orang dan hanya admin yang dapat melihat hasil pemilihan nama angkatan

Persiapan Awal

1. Clone repositori ke komputer

   $ git clone https://github.com/raryasdya/vote-csui vote-csui
   

2. Atur deadine voting dan pilihan calon nama angkatan

   • Buka file serverData.json

     {
         "deadlineVoting": "October 30, 2020 23:55:00",
         "calonNamaAngkatan": ["satu", "dua", "tiga", "empat"]
     }
     

   • Ubah value dari deadlineVoting dengan format "Month DD, YYYY HH:MM:SS"

   • Ubah value dari calonNamaAngkatan sesuai pilihan calon nama angkatan yang telah ditentukan

     Perlu diperhatikan bahwa "maung" dan "Maung" adalah 2 (dua) calon nama angkatan yang berbeda

3. Atur icon dan background image

   • Letakkan file untuk icon dengan nama file icon.png pada directory ./static/img/
   • Letakkan file untuk background image dengan nama file background-desktop.png pada directory ./static/img/

4. Pastikan struktur folder adalah seperti berikut :

   vote-csui
   ├── app
   |   ├── controllers
   |   |   └── ...
   |   └── models
   |       └── ...
   ├── static
   |   ├── css
   |   |	└── ...
   |   ├── img
   |   |	├── icon.png
   |   |	└── background-desktop.png
   |   ├── js
   |   |	└── ...
   |   └──	...
   ├── serverData.json
   └── ...
   

5. Add repositori

   $ git add .
   

6. Commit repositori

   $ git commit -m "Update data"
   

Deployment

1. Install Heroku CLI
2. Buka terminal
3. Login ke Heroku

   $ heroku login
   

4. Buat app Heroku

   $ heroku create <nama_app>
   

5. Buat database postgres

   $ heroku addons:create heroku-postgresql:hobby-dev
   

6. Tambahkan configuration variable ADMIN_SS0

   $ heroku config:set ADMIN_SSO=<username_SSO_UI_admin>
   

   Value dari ADMIN_SSO adalah username SSO-UI milik seseorang yang akan menjadi admin

7. Tambahkan configuration variable URL

   $ heroku config:set URL=http://<nama_app>.herokuapp.com
   

8. Deploy repositori ke Heroku

   $ git push heroku master
   

Petunjuk Khusus Contributors

Membuat File .env

File .env merupakan file yang berisi environment variable yang akan digunakan jika program dijalankan di local.

1. Buatlah file .env pada root repositori

2. Isi file .env seperti contoh yang ada di file .env.sample

   PORT=3000
   ADMIN_SSO=username.ssoui
   DATABASE_URL=postgres://user:pass@localhost:5432/dbname
   

   Value dari ADMIN_SSO adalah username SSO-UI milik seseorang yang akan menjadi admin

   Value dari user, pass, dan dbname berlaku untuk database local

Install Dependencies

 $ npm install

Menjalankan Program

 $ npm run dev

Contributors

Muhammad Indra Ramadhan / indravb6