Repositori penyimpanan file audio pelafalan untuk aplikasi SambasKu (Kamus Digital Sambas-Indonesia).
Audio di sini bukan konten editorial manual. File diunggah otomatis oleh backend SambasKu API saat pengguna (admin web atau aplikasi mobile) merekam / mengirim pelafalan kata atau contoh kalimat.
| Sumber submit | Cara |
|---|---|
| Admin (web) | Rekam / unggah di form kata → POST …/pronunciations/audio |
| Mobile (Flutter) | Sheet rekam pelafalan → endpoint yang sama |
| Backend API | Menerima multipart → menulis file ke repo ini lewat GitHub Contents API |
Repo ini harus publik agar client bisa memutar file lewat jsDelivr CDN
(cdn.jsdelivr.net/gh/…).
assets/
└── audio/
└── <dialect|umum>/
└── <lemma-slug>/
└── <ulid>.<ext> # mp3 | m4a | wav | ogg | webm
Contoh:
assets/audio/umum/makatn/01HXYZ….m4a
assets/audio/sambas-kota/makatn/01HABC….wav
dialect- kode dialek (slug); jika tidak ada → folderumumlemma-slug- lemma dinormalisasi (huruf kecil, non-alfanumerik →-)- Nama file - ULID unik (immutable; unggah baru = file baru)
https://cdn.jsdelivr.net/gh/sambasku/audios@main/<path>
Contoh:
https://cdn.jsdelivr.net/gh/sambasku/audios@main/assets/audio/umum/makatn/01HXYZ….m4a
URL lengkap disimpan di baris tabel word_audios.url pada database SambasKu
(Turso / SQLite), bersama metadata (MIME, ukuran, penutur, example_id, dll.).
Path relatif tetap ada di provider_file_id bila basis URL CDN diganti nanti.
Catatan: file baru bisa butuh beberapa detik sampai jsDelivr mengindeks commit GitHub; path ULID immutable jadi cache CDN aman setelah itu.
- Tidak ada UI upload manual yang didukung sebagai alur produksi
- Tidak menyimpan notasi IPA (itu tabel
pronunciationsdi API) - Jangan rename / pindah file yang sudah di-referensi DB - URL CDN akan putus
Backend memakai fine-grained PAT dengan izin Contents: Read & Write pada repo ini. Variabel lingkungan (di API / Workers):
PRONUNCIACION_PROVIDER=github
PRONUNCIACION_GITHUB_URL=https://github.com/sambasku/audios
PRONUNCIACION_GITHUB_TOKEN=<pat>Ringkasan endpoint & kontrak: api/README.md.
Kode & dokumentasi repo ini dilisensikan di bawah MIT - lihat
LICENSE.
Rekaman audio dikirim kontributor SambasKu untuk keperluan kamus. Metadata
penutur (speaker_name) ada di database API, bukan di path file.
