NgeSEC / relawan

Aplikasi web untuk pemetaan lokasi posko, kebutuhan pengungsi dan koordinasi relawan
https://posko.id
MIT License
42 stars 38 forks source link

Posko.id

Build Status

Aplikasi web untuk pemetaan lokasi posko, kebutuhan pengungsi dan koordinasi relawan. Untuk ikut serta dalam proyek ini, silahkan baca dahulu cara berkontribusi.

Catatan: status development saat ini adalah Pre-Alfa

1. LATAR BELAKANG

dari situs https://bnpb.go.id:

Wilayah Indonesia merupakan gugusan kepulauan terbesar di dunia. Wilayah yang juga terletak di antara benua Asia dan Australia dan Lautan Hindia dan Pasifik ini memiliki 17.508 pulau. Meskipun tersimpan kekayaan alam dan keindahan pulau-pulau yang luar biasa, bangsa Indonesia perlu menyadari bahwa wilayah nusantara ini memiliki 129 gunung api aktif, atau dikenal dengan ring of fire, serta terletak berada pada pertemuan tiga lempeng tektonik aktif dunia?Lempeng Indo-Australia, Eurasia, dan Pasifik.

Ring of fire dan berada di pertemuan tiga lempeng tektonik menempatkan negara kepulauan ini berpotensi terhadap ancaman bencana alam. Di sisi lain, posisi Indonesia yang berada di wilayah tropis serta kondisi hidrologis memicu terjadinya bencana alam lainnya, seperti angin puting beliung, hujan ekstrim, banjir, tanah longsor, dan kekeringan. Tidak hanya bencana alam sebagai ancaman, tetapi juga bencana non alam sering melanda tanah air seperti kebakaran hutan dan lahan, konflik sosial, maupun kegagalan teknologi.

secara singkat, Indonesia adalah salah satu negara yang paling rawan terhadap bencana.

2. TUJUAN

Tujuan jangka panjang aplikasi ini adalah:

3. TEST CASE & MVP

3.1 TEST CASE

Kami menggunakan Gunung Merapi sebagai test case dengan pertimbangan:

3.2 MVP

Catatan: status development saat ini adalah Pre-Alfa

- [ ] Registrasi pengguna
    - [ ] melalui email
    - [ ] melalui sosial media
- [ ] Menampilkan status Gunung Merapi (Normal/Waspada/Siaga/Awas)
- [ ] Menampilkan lokasi posko pengungsi warga dan ternak pada peta
    - [ ] data posko yang didapat dari BPPTKG dan dinas terkait berupa file KMZ
    - [ ] Pengguna dapat menambahkan data posko
    - [ ] Status posko apakah saat ini aktif dihuni atau tidak
- [ ] Menampilkan data di setiap posko:
    - [ ] Nama koordinator posko beserta nomer yang dapat dihubungi 
    - [ ] Jumlah Pengungsi dan data statistik lainnya (umur, jenis kelamin, )
    - [ ] Kebutuhan pengungsi yang belum tersedia (makanan, obat-obatan, ataupun kebutuhan lain)

4. UNDANGAN TERBUKA

:pray: :pray: :pray:

Dengan senang hati, kami mengundang rekan-rekan untuk turut berkontribusi dalam pengembangan aplikasi ini. Saat ini kami membutuhkan bantuan untuk bagian:

Dokumen Instalasi pada Debian / Ubuntu bisa dilihat disini

5.1 Windows Development Setup

Pada sistem operasi Windows, cara paling mudah adalah menggunakan Laragon

6. HOW TO RUN

  1. A. Jika anda hanya ingin menjalankan aplikasi maka lakukan langkah berikut :

    Clone repositori melalui terminal

    git clone https://github.com/NgeSEC/relawan.git

    B. Jika anda ingin berkontribusi maka lakukan langkah berikut :

    Fork repositori dari NgeSEC/relawan ke repositori masing - masing

    Clone repositori milik kita melalui terminal

    git clone https://github.com/xxxxx/relawan.git

    Lakukan add upstream ke repo NgeSEC

    git remote add upstream https://github.com/NgeSEC/relawan.git
  2. Masuk ke direktori relawan dan lakukan Update Github submodule melalui terminal

    git submodule update --init --recursive

    Jika menemukan error, silahkan cek wiki Troubleshooting

  3. Install/Update Composer

    Jika ingin menginstall packages/dependencies saja tanpa memperbarui (seringkali hanya ini yang dibutuhkan dan lebih cepat prosesnya)

    composer install

    Jika ingin memperbarui packages dengan versi terbaru (jika ada)

    composer update
  4. Konfigurasi database pada .env copy dari .env.example

    DB_CONNECTION=mysql
    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=NAMADATABASE
    DB_USERNAME=USER
    DB_PASSWORD=PASSWORD
  5. Artisan Migrate

    php artisan migrate
  6. DB SEED

    php artisan db:seed
  7. NPM INSTALL (Hanya Untuk Pertama Kali)

    npm install
  8. NPM RUN DEV

    npm run dev
  9. Start Magic

    php artisan serve
  10. Akses melalui browser menggunakan alamat http://127.0.0.1:8000

7. LISENSI

license

Aplikasi ini menggunakan lisensi MIT

8. CONTACT

Untuk melaporkan celah keamanan atau bergabung dengan grup telegram Posko.id silahkan menghubungi posronda@posko.id