beepresent: CLI dan API untuk Portal Kuliah

Ringkasan

Proyek ini adalah CLI dan API untuk berinteraksi dengan data mata kuliah — menampilkan daftar mata kuliah, mengambil detail, mengambil tugas dan kuis, serta mengirimkan catatan kehadiran (“present”).

API

Endpoint	Deskripsi
GET /courses	Menampilkan semua mata kuliah
GET /courses/{id}	Mengambil detail mata kuliah
GET /courses/{course_id}/assignments	Menampilkan daftar tugas untuk sebuah mata kuliah
GET /courses/{course_id}/quizzes	Menampilkan daftar kuis untuk sebuah mata kuliah
POST /courses/{course_id}/present/{present_id}	Mengirim kehadiran

CLI

CLI mencerminkan permukaan API:

• bl courses — menampilkan daftar mata kuliah
• bl courses {id} — menampilkan detail mata kuliah
• bl present — mengirim kehadiran

Penjadwalan

Pengiriman kehadiran sebaiknya berjalan pada jadwal tetap:

• Senin – Jumat: 19.00 – 20.00
• Sabtu: 09.00, 11.00, 14.00, 16.00

Pertanyaan terbuka: apakah scheduler sebaiknya berada di dalam proyek ini, atau menjadi concern terpisah?

Caching & Invalidasi

Data mata kuliah jarang berubah, jadi caching yang agresif tidak menjadi masalah.

• Entri cache kedaluwarsa setelah satu minggu
• Crawl ulang hanya dilakukan ketika data cache sudah kedaluwarsa
• Invalidasi pada setiap akses dihindari — itu bukan prioritas

Implementasi

Tech Stack

• TypeScript
• Runtime Bun.js
• Cheerio untuk parsing HTML

Struktur Proyek

src/
├── services/
│   ├── getCourses
│   ├── getCourseDetail
│   ├── getPresentationList
│   └── postPresent
├── repository/
│   ├── courses
│   ├── assignments
│   └── quiz
├── utils/
│   └── log
└── config/
    └── creds