SIAB1

Sistem Informasi Asesmen Berintegritas untuk penyelenggaraan asesmen digital yang terlindungi, terpantau, dan dapat diaudit.

SIAB1 menggabungkan aplikasi kiosk Android, FastAPI untuk control/non-hot-path, Go untuk enam rute siswa (join, start, submit-answer, auto-save, auto-save-batch, submit), PostgreSQL, Redis, Celery, serta kontrol SEB/SXB. FastAPI tetap fallback Nginx untuk rute tersebut.

Kemampuan Utama

• Aplikasi kiosk Android native dengan pembatasan navigasi, screenshot protection, dan origin-bound authentication.
• Manajemen peserta, bank soal, jadwal, sesi, penilaian, analitik, dan laporan.
• Autosave, answer journal, final-submit integrity, reconnect, dan recovery sesi.
• Validasi SEB/SXB, signature policy, rate limiting, CAPTCHA, account lockout, dan audit logging.
• Monitoring real-time, Prometheus, Grafana, alerting, backup, dan recovery tooling.
• Go sebagai writer produksi untuk enam rute siswa; FastAPI menangani control plane dan menjadi backup Nginx. Dual-write jawaban dilarang.

Arsitektur

Android kiosk / browser / Flutter fallback
                    |
             SafeLine -> Nginx
          _________|_________
         |                   |
   Go student hot-path   FastAPI lanes
   (6 routes, 100%)      + FastAPI backup
         |                   |
         +---------+---------+
                   |
            PgBouncer / Redis
                   |
         PostgreSQL / Celery workers

Status produksi, fallback, dan target boundary tersedia di ARCHITECTURE.md.

Struktur Repository

Path	Fungsi
android-kiosk/	Klien Android native utama
app/	API, policy, model, service, middleware, dan task FastAPI
go/	Runtime Go student hot-path (primary untuk enam rute)
flutter_client_code/	Klien Flutter fallback
templates/, static/	Antarmuka web admin dan peserta
docker/, monitoring/	Container, Nginx, PgBouncer, Prometheus, dan Grafana
scripts/, bin/	Verifikasi, maintenance, backup, recovery, dan observability
tests/	Regression dan security contract tests
docs/	Runbook dan checklist aktif

Pengembangan Lokal

Persyaratan utama: Python 3.11+, PostgreSQL, dan Redis.

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python -m app.main

Alternatif:

uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

Verifikasi

python -m compileall app
python scripts/check_security.py
pytest -q
SKIP_HTTP=1 bash scripts/verify_release_gate.sh

Untuk Go:

cd go
go test ./...
go vet ./...
go build ./...

Untuk Android kiosk:

cd android-kiosk
./gradlew :app:compileDebugKotlin :app:lintDebug

Deployment

Deployment production menggunakan docker-compose.production.yml. Database, image, dan Compose project memakai slug siab1. Hostname publik adalah siab.man1rokanhulu.cloud; SafeLine menangani ingress dan TLS sebelum meneruskan trafik ke origin Nginx yang hanya terikat ke loopback.

Lihat DEPLOYMENT.md. Jangan menjalankan rebuild, migrasi, atau penghapusan volume ketika asesmen aktif.

Dokumentasi

• Arsitektur
• Deployment
• Indeks runbook
• Riwayat ringkas

Keamanan

Jangan commit .env, keystore, certificate, private key, token, hasil asesmen, upload peserta, atau credential lainnya. Laporkan kerentanan secara privat kepada maintainer, bukan melalui issue publik.