⚠️ PERINGATAN

Software ini GRATIS

• ✅ Diperbolehkan: Penggunaan pribadi atau instansi internal.
• ❌ Dilarang: Menjual software ini atau menggunakannya untuk tujuan komersil tanpa izin.

---

Presensee 📱

Sistem Absensi Modern dengan Arsitektur Offline-First — cepat, ringan, dan tetap jalan meskipun tanpa internet.

Presensee adalah aplikasi (web based) absensi siswa untuk sekolah yang dirancang dengan arsitektur Offline-First. Antarmuka dibuat interaktif agar memudahkan proses absensi.

Dibangun menggunakan stack modern: Django & Django Ninja di backend, React 19 (Vite + PWA) di frontend dengan Tailwind CSS 4 & DaisyUI 5.

---

🌟 Fitur Utama

• 📡 Offline-First: Absensi tetap bisa di-input tanpa internet. Sinkronisasi dilakukan nanti saat online.

• 👥 Role-Based Access:

  • Sekretaris → Input absensi harian.
  • Wali Kelas → Monitoring, kunci absensi, dan lihat rekap.
  • Kesiswaan → Lihat rekap seluruh kelas.
  • Guru Piket → Melakukan absensi siswa menggunakan QRCode.
  • Admin → Full Power.

• 📊 Rekap Pintar: Filter otomatis berdasarkan Bulan, Minggu, atau Rentang Tanggal.

• 📄 Export & Share: Generate laporan bulanan + fitur native share (WhatsApp/Telegram).

• 🎨 UI Modern & Responsif dengan dukungan Dark/Light Mode.

---

🛠️ Requirements

1. uv – Python Package Manager.
2. Bun – Untuk build frontend.
3. PostgreSQL Server atau MySQL Server – Database utama.
4. Redis Server – Caching.
5. Git – Untuk download project.
6. wkhtmltopdf – Export laporan ke PDF.

---

🚀 Instalasi

1. Clone Repository

git clone https://github.com/salismazaya/presensee-public.git
cd presensee-public

---

2. Setup Backend (Django)

Masih di folder utama:

# Install python
uv python install

# Install dependencies backend
uv sync

# Setup environment variables
cp .env.example .env

# Jalankan migrasi database
uv run python manage.py migrate

---

3. Setup Frontend (React + Vite)

cd frontend

# Install deps
bun install

# Build assets
bun run build

cd ..

---

⚡ Menjalankan Aplikasi

Jalankan server menggunakan Granian:

uv run granian --interface wsgi django_project.wsgi:application --env-files .env

Akses melalui: http://127.0.0.1:8000 (atau sesuai config Anda).
Buka http://127.0.0.1:8000/setup untuk setup awal.

Baca lebih lanjut tentang Granian

---

👥 Kredit

Crafted with ❤️ by Salis Mazaya

---