Skip to content

diegoarmanda/go-task

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GO-TASK

Open-source work-order & field-service platform — pengaduan pelanggan, penugasan petugas, peta kebocoran (NRW), RBAC, dan integrasi data pelanggan.

Data demo dan branding UI mengacu Perumda Tirta Tamiang sebagai reference deployment (PDAM Kab. Aceh Tamiang). Fork proyek ini untuk organisasi Anda: ganti nama, logo, integrasi billing, dan kirim update lewat Pull Request.

Fitur utama

  • Work order WO-YYMM-NNN, status flow, foto before/after, verifikasi atasan
  • Form pengaduan publik (/lapor.html) dengan rate limit & honeypot
  • Peta Leaflet, heatmap kebocoran, dashboard & laporan
  • Django + PostGIS, JWT, audit log, notifikasi FCM (opsional)
  • Sync pelanggan GoSimona via Celery (dapat diganti adapter lain)

Stack

Layer Teknologi
Backend Django 5 + DRF, PostGIS, Celery, Redis
Frontend React 18, Vite 8 (SPA + /lapor.html publik)
Peta Leaflet + OpenStreetMap

Quick start (development)

Prasyarat

  • Python 3.10+, Node 20+
  • PostgreSQL + PostGIS di port 5437
  • Redis (Celery opsional untuk sync GoSimona)

Backend

cd backend
cp .env.example .env   # isi DJANGO_SECRET_KEY & DB
python -m venv ../.venv && source ../.venv/bin/activate
pip install -r requirements.txt
python manage.py migrate
python manage.py seed_demo
python manage.py runserver 0.0.0.0:8765

Frontend

cd frontend
npm install
npm run dev    # http://localhost:5173 — proxy API ke :8765

Demo login

User Password
admin gotask123

Data seed mengacu tanggal kanonik 2026-05-31.

Scripts berguna

# Backend (dari backend/)
python -m pytest
python manage.py spectacular --file schema.yml

# Frontend (dari frontend/)
npm run lint && npm run build && npm run check:bundle
npm run test:smoke   # butuh backend + Vite + Chromium

Dokumentasi

  • CLAUDE.md — panduan arsitektur untuk kontributor/AI
  • docs/dev-onboarding.md — setup lengkap
  • frontend/README.md — struktur frontend Vite

Kontribusi

Lihat CONTRIBUTING.md. Issue dan PR dipersilakan — terutama white-label, deploy, dan integrasi untuk utilitas lain.

Lisensi

MIT — bebas pakai, modifikasi, dan distribusi dengan atribusi. Nama dan data demo PDAM bukan merek dagang yang dilindungi oleh lisensi kode; ganti di fork Anda untuk produksi.

About

Open-source work order & field service for utilities (Django, PostGIS, React)

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors