Skip to content
sambaskuPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

75 Commits

Folders and files

Repository files navigation

SambasKu

SambasKu Pronunciation

Repositori penyimpanan file audio pelafalan untuk aplikasi SambasKu (Kamus Digital Sambas-Indonesia).

Apa isi repo ini?

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/…).

Struktur path

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 → folder umum
  • lemma-slug - lemma dinormalisasi (huruf kecil, non-alfanumerik → -)
  • Nama file - ULID unik (immutable; unggah baru = file baru)

URL publik (dipakai client)

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.

Yang tidak dilakukan di repo ini

  • Tidak ada UI upload manual yang didukung sebagai alur produksi
  • Tidak menyimpan notasi IPA (itu tabel pronunciations di API)
  • Jangan rename / pindah file yang sudah di-referensi DB - URL CDN akan putus

Akses API (server saja)

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.

Lisensi

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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors