SIMIPAS adalah tool untuk mengisi jurnal harian SIMPEG KEMENIMIPAS secara otomatis. Project ini dirancang untuk meningkatkan efisiensi kerja melalui otomasi, sehingga pengguna bisa fokus pada hal-hal yang lebih penting.
Disclaimer: Aplikasi ini dibuat sesuai dengan
SKP TAHUNANdanJURNAL HARIANsesuai dengan bagian dari pekerjaan saya selaku pembuat script yaitu diPengamanan Pintu Utama (P2U).Anda dapat mengembangkan sendiri sesuai dengan bagian anda masing-masing, dibutuhkan pengetahuan tentang
Backend.
Overview | Features | Installation | Usage | Project Structure | Contributing | License | Contact
SIMIPAS merupakan alat otomatisasi yang diciptakan khusus untuk memudahkan pengisian jurnal harian di SIMPEG KEMENIMIPAS. Dengan memanfaatkan teknologi modern seperti TypeScript dan Playwright, tool ini membantu:
- Mengurangi beban administrasi.
- Meningkatkan akurasi data.
- Mempercepat proses input jurnal harian.
- Otomatisasi Pengisian Jurnal: Mengotomatiskan proses input data harian dengan presisi.
- Integrasi Khusus SIMPEG: Dibuat untuk memenuhi kebutuhan SIMPEG KEMENIMIPAS.
- Logging dan Monitoring: Menggunakan Winston untuk pencatatan aktivitas dan debugging.
- Automasi Web: Menggunakan Playwright untuk interaksi otomatis dengan antarmuka web.
- TypeScript Modern: Menjamin kualitas dan maintainability kode melalui penggunaan TypeScript.
- Node.js (v23.8.0 atau lebih baru)
- npm atau yarn
-
Clone repository
git clone https://github.com/idugeni/simipas.git
cd simipas -
Install dependencies
npm install
atau jika menggunakan yarn
yarn install
-
BUAT FILE
.envuntuk menyimpan konfigurasi aplikasiSIMPEG_URL= SIMPEG_NIP= SIMPEG_PASSWORD=
-
Edit file
task.jsonsesuai dengan kebutuhan untuk pengisian jurnal harian{ "option1": "", "option2": "" }
Pastikan semua dependensi telah terinstal dengan benar sebelum menjalankan perintah-perintah berikut.
-
Pengembangan (Development)
Jalankan aplikasi dalam mode pengembangan dengan perintah berikut:npm run dev
Perintah ini akan menjalankan file
src/app/index.tsmenggunakants-node-devdengan konfigurasi tambahandotenv/configdantsconfig-paths/register. -
Produksi (Start)
Sebelum menjalankan aplikasi dalam mode produksi, pastikan sudah melakukan build dengan perintah:npm run build
Setelah build selesai, jalankan aplikasi dengan:
npm start
Perintah ini akan menjalankan file
dist/app/index.jsmenggunakants-nodedengan konfigurasi yang sama.
Untuk mengkompilasi kode TypeScript ke JavaScript, gunakan perintah:
npm run buildHasil kompilasi akan tersimpan di folder dist.
-
Linting
Cek kualitas kode dengan:npm run lint
-
Format Kode
Format seluruh kode sumber dengan Prettier:npm run format
-
Cek Kode (Build + Lint)
Pastikan kode bebas dari error dengan:npm run check
Jika browser tidak muncul saat menjalankan aplikasi, pastikan untuk menginstal dependensi Playwright dengan perintah:
npx playwright installHal ini diperlukan karena aplikasi menggunakan pustaka Playwright untuk pengujian otomatisasi browser.
simipas/
├── src/
│ ├── data/
│ │ └── task.json # Data tugas otomatis
│ ├── lib/
│ │ ├── auth.ts # Modul untuk otentikasi
│ │ ├── automation.ts # Logika otomasi pengisian jurnal
│ │ ├── browser.ts # Modul untuk browser
│ │ ├── config.ts # Konfigurasi aplikasi
│ │ ├── constants.ts # Konstanta yang digunakan
│ │ ├── journalManager.ts # Manajemen jurnal
│ │ ├── logger.ts # Modul untuk logging
│ │ ├── reportGenerator.ts # Fungsi untuk menghasilkan laporan
│ │ ├── schedules.ts # Pengaturan jadwal tugas otomatis
│ │ ├── types.ts # Tipe data dan interface yang digunakan
│ │ ├── userInterface.ts # Modul untuk user interface
│ │ └── utils.ts # Fungsi utilitas pendukung
│ └── app/
│ └── index.ts # Entry point aplikasi
├── .env # File konfigurasi environment
├── .eslinttrc.json # Konfigurasi ESLint
├── .gitignore # Daftar file/folder yang diabaikan oleh Git
├── .prettierrc # Konfigurasi Prettier
├── eslint.config.mjs # Konfigurasi ESLint
├── LICENSE # Lisensi proyek
├── package-lock.json # Lock file npm
├── package.json # Konfigurasi project dan dependensi
├── README.md # Dokumentasi project
└── tsconfig.json # Konfigurasi TypeScriptKami sangat menghargai kontribusi dari komunitas pengembang untuk meningkatkan kualitas dan kemampuan proyek SIMIPAS. Jika Anda memiliki ide, saran, atau perbaikan yang ingin Anda sumbangkan, silakan ikuti langkah-langkah berikut:
- Fork repository: Buat salinan repository SIMIPAS ke akun GitHub Anda sendiri dengan menekan tombol
Forkpada halaman repository. - Buat branch baru: Buat branch baru pada repository Anda dengan nama yang sesuai dengan perubahan yang ingin Anda lakukan (misalnya,
fix-bugatautambah-fitur). - Lakukan perubahan: Lakukan perubahan yang ingin Anda lakukan pada branch baru Anda.
- Buat commit: Buat commit untuk perubahan yang Anda lakukan dengan menggunakan pesan commit yang jelas dan singkat.
- Buat pull request: Buat pull request ke repository asli SIMIPAS dengan memilih branch yang sesuai dan menambahkan deskripsi yang jelas tentang perubahan yang Anda lakukan.
Proyek SIMIPAS dilisensikan di bawah MIT License. Dengan melakukan kontribusi, Anda setuju untuk memberikan hak cipta atas karya Anda kepada proyek SIMIPAS dan memungkinkan penggunaan karya Anda di bawah lisensi yang sama.
Terima kasih atas kontribusi Anda! Kami berharap dapat bekerja sama dengan Anda untuk meningkatkan kualitas dan kemampuan proyek SIMIPAS.
| Kontak | Informasi | Link |
|---|---|---|
| officialelsa21@gmail.com | ||
| Github | idugeni | GitHub Profile |
| Issue Tracker | simipas/issues | Issue Tracker |
Terima kasih telah menggunakan SIMIPAS. Jika ada pertanyaan atau saran, jangan ragu untuk membuka issue atau menghubungi author. Semoga SIMIPAS dapat membantu meningkatkan produktivitas dan efisiensi kerja!