Buku Panduan Operasional Sistem Presensi & Server PC

PT Atlantis Infotama Teknika • Standar Operasional Prosedur (SOP) Sistem Absensi & Jaringan

Kembali
Daftar Bab Panduan
Bantuan IT Kantor

Panduan ini dirancang untuk tim IT Support, Administrator, dan Supervisor PT Atlantis Infotama Teknika.

Bab 1 • Landasan Sistem

Ikhtisar Sistem Presensi & Arsitektur Jaringan

Sistem Manajemen Presensi Lapangan & Payroll Berbasis Biometrik Wajah AI dan Geofencing Multi-Site.

1. Biometrik Wajah AI

Verifikasi wajah berstandar adaptif lapangan (ambang kemiripan minimal 55%) untuk memblokir titip absen, foto dari layar HP lain, dan spoofing wajah.

2. Geofencing GPS

Validasi radius presisi (150m - 250m) dari titik proyek resmi, dilengkapi proteksi anti-mock location dan izin Multi-Site khusus.

3. Server Lokal Mandiri

Database SQLite tersimpan mandiri di PC kantor tanpa langganan cloud mahal, disinkronkan real-time lewat Cloudflare Tunnel.

Diagram Aliran Konektivitas Jaringan Presensi
[HP Teknisi Lapangan (PWA Chrome)]
└── HTTPS Request ──> [Cloudflare Edge (WAF & SSL Enkripsi)]
└── Daemon cloudflared ──> [PC Server Kantor 10.0.1.55]
├── Port 3010 & Port 3000 (Express & WS)
└── SQLite Database & Foto Biometrik
Bab 2 • Keamanan & Autentikasi

Struktur Hak Akses, Akun & Kredensial Pengguna

Pengelompokan hak akses (Role-Based Access Control) dan kredensial akun bawaan sistem.

Peran (Role) Username Password Wewenang Operasional
Administrator admin ait194748 Pengelola sistem menyeluruh: kelola site proyek geofencing, kelola akun pengguna, penyesuaian tarif upah, kalkulasi payroll & cetak slip gaji.
Supervisor spv 123 Perekaman wajah master AI (Enrollment), input NIK & rekening bank teknisi, izin Multi-Site, dan monitoring kehadiran live.
Teknisi Lapangan ahmad / rian / deni 123 Melakukan absen masuk dan absen pulang via biometrik wajah & GPS di lokasi proyek, serta pengajuan cuti/izin.
Kebijakan Keamanan Password:

Setelah proses instalasi awal selesai, Administrator sangat disarankan untuk mengubah kata sandi default melalui menu Kelola Pengguna > Edit Password untuk mencegah akses tidak sah.

Bab 3 • Operasional Lapangan

Panduan Operasional Mobile Teknisi Lapangan

Petunjuk absensi menggunakan smartphone Android/iOS, verifikasi biometrik, dan mode offline.

1 Akses URL & Instalasi PWA (Add to Home Screen)

Teknisi membuka browser Google Chrome di HP dan memasukkan alamat resmi https://absen.teknikait.net. Klik menu titik tiga di kanan atas Chrome lalu pilih "Tambahkan ke Layar Utama" (Install App) agar aplikasi terpasang di HP seperti aplikasi native.

2 Izin Kamera & Lokasi Presisi Tinggi

Saat aplikasi pertama kali dibuka, browser akan meminta izin akses Kamera dan Lokasi (GPS). Teknisi WAJIB memilih "Izinkan saat menggunakan aplikasi" dengan mode akurasi tinggi aktif.

3 Verifikasi Radius & Scan Wajah AI

Pastikan indikator lokasi berstatus HIJAU (Dalam Radius Proyek). Tekan tombol "Absen Masuk Sekarang", posisikan wajah di dalam lingkaran oval dengan cahaya cukup, dan tunggu konfirmasi centang hijau.

Kemampuan Offline-First (Tanpa Sinyal di Site):

Jika teknisi berada di area basement atau remote site tanpa sinyal internet, absensi tetap dapat dilakukan. Data dan foto biometrik akan tersimpan aman di penyimpanan internal browser ponsel, lalu otomatis tersinkronisasi ke server PC kantor saat HP mendeteksi koneksi online.

Bab 4 • Manajemen Teknisi

Panduan Supervisor (Perekaman Wajah AI & Multi-Site)

Prosedur enrollment biometrik wajah master, kelola data rekening payroll, dan penetapan izin lokasi.

Standar Operasional Perekaman Wajah AI:

  • Pastikan teknisi menghadap kamera secara langsung dengan ekspresi netral.
  • Lepaskan masker, kacamata hitam, atau topi yang menutupi alis dan mata.
  • Pastikan pencahayaan ruangan terang merata tanpa bayangan tajam di salah satu sisi wajah.
  • Klik "Ambil Foto Master" dan periksa kejelasan foto sebelum menekan tombol simpan.

Pengaturan Izin Lokasi (Multi-Site):

Secara default teknisi hanya bisa absen di site proyek tertentu. Untuk teknisi mobilitas tinggi (troubleshooting antar-site), Supervisor dapat mengaktifkan opsi "Izin Multi-Site (Bebas Semua Lokasi)" pada formulir edit teknisi.

Bab 5 • Pengelolaan Admin

Panduan Administrator (Site Proyek & Siklus Payroll)

Pengaturan koordinat geofencing, siklus kalkulasi upah, resume eksekutif Excel, dan slip gaji.

1. Geofencing Site Proyek

Masukkan koordinat Latitude, Longitude (bisa didapat dari Google Maps), dan tentukan radius batas (contoh: 200m). Sistem secara otomatis memetakan toleransi kehadiran teknisi.

2. Skema Upah Fleksibel

Mendukung 4 skema: Bulanan Type A (shift standar), Bulanan Type B (dengan insentif akhir pekan), Harian Per Jam, dan Harian Luar Kota tanpa faktor potongan denda.

3. Resume Excel Manajemen

Dapat diekspor dalam format spreadsheet (.xlsx) resmi dengan lembar tanda tangan pengesahan Direksi, Manajer Operasional, dan Keuangan.

4. Dokumen Slip Gaji PDF

Format resmi A4 bersih tanpa potongan BPJS yang tidak diperlukan, dilengkapi nomor referensi otomatis dan rincian kehadiran riil.

Bab 6 • Infrastruktur IT Komprehensif

Setup Server PC Kantor & Infrastruktur Cloudflare Tunnel (cloudflared)

Panduan teknis lengkap instalasi server lokal PC kantor dan tunneling HTTPS resmi untuk akses teknisi lapangan.

Mengapa Cloudflare Tunnel Wajib Digunakan?

Syarat Keamanan Browser Browser Google Chrome dan Android secara ketat memblokir Kamera dan GPS presisi tinggi jika dibuka melalui HTTP biasa. Wajib menggunakan HTTPS resmi.
Tanpa Buka Port Router Tidak memerlukan IP Publik Statis atau Port Forwarding di modem kantor (Indihome/Biznet/FirstMedia). Aman dari serangan peretasan dan scanning port.
Realtime WebSocket Sinkronisasi kehadiran detik itu juga ke monitor PC kantor dengan protokol WebSocket WSS yang stabil.
Konfigurasi Port & Listener Server PC: Dual-Port Siaga
• Alamat IP LAN Kantor : 10.0.1.55
• Port Utama Aplikasi : 3010 & 3000
• Domain Resmi Cloudflare : https://absen.teknikait.net
• Format Target Tunnel : HTTP 127.0.0.1:3010

3 Metode Menjalankan Cloudflare Tunnel di PC Kantor:

1
Metode 1: Quick Tunnel (Instan 10 Detik)
Gratis & Otomatis
cloudflared tunnel --url http://127.0.0.1:3010
2
Metode 2: Dedicated Named Tunnel (absen.teknikait.net)
Domain Permanen
1. cloudflared tunnel login
2. cloudflared tunnel create presensi-kantor
3. cloudflared tunnel route dns presensi-kantor absen.teknikait.net
4. cloudflared tunnel run --url http://127.0.0.1:3010 presensi-kantor
Bab 7 • Distribusi Akses

Distribusi QR Code & Akses Remote Smartphone Teknisi

Generator QR Code live, panduan scan smartphone teknisi lapangan, dan pencetakan kartu akses.

Pratinjau QR Code Akses Teknisi
QR Code Presensi
https://absen.teknikait.net
SOP Scan QR Code untuk Teknisi Lapangan:
  1. Buka aplikasi Kamera bawaan HP Android atau Google Chrome.
  2. Arahkan kamera ke QR Code di atas hingga muncul pop-up tautan HTTPS.
  3. Ketuk tautan untuk membuka aplikasi web presensi di browser.
  4. Pilih menu browser (titik 3) lalu klik "Tambahkan ke Layar Utama" (Install PWA).
Bab 8 • Penanganan Masalah

Solusi Kendala Teknis & Panduan Troubleshooting

Panduan tuntas penanganan Error 1016, Error 502, Windows Defender Firewall, dan kendala sensor GPS/Kamera.

!
Error 1016: Origin DNS error Target Tunnel Tidak Ditemukan

Penyebab: Browser berhasil mencapai server Cloudflare, tetapi Cloudflare tidak menemukan tujuan CNAME (Target tidak cocok karena tunnel pernah dibuat ulang atau hostname belum terdaftar).

3 Langkah Solusi Tuntas Error 1016:
  1. Buka browser ke https://one.dash.cloudflare.com > menu Networks > Tunnels.
  2. Pastikan status tunnel HEALTHY. Klik nama tunnel > Configure > Public Hostnames.
  3. Klik + Add a public hostname lalu masukkan subdomain dan URL HTTP (127.0.0.1:3010). Simpan.
Bab 9 • Tanya Jawab

Frequently Asked Questions (FAQ)

Q: Apakah PC kantor harus selalu menyala agar teknisi bisa absen?

A: Ya, PC kantor bertindak sebagai server database sentral. Agar koneksi aktif 24 jam tanpa jeda, Anda dapat memasang Cloudflare Tunnel sebagai Windows Service dan mengatur power setting PC agar tidak masuk ke mode Sleep.

Q: Di mana lokasi penyimpanan file backup database sistem?

A: Seluruh catatan kehadiran, pengguna, site, dan slip gaji tersimpan di file database lokal /data/attendance.db dan /data/biometrics/ di folder instalasi server kantor.

Dokumen Resmi PT Atlantis Infotama Teknika • IT System Administration