A gamified Android app with speech recognition and a web dashboard for tracking student progress.
# BIGKAS: Integrated Digital Learning System
> **An Integrated Digital Learning System for Supplementary Filipino Pronunciation Using Speech Recognition for Grade 1 Students.**
Bigkas is an end-to-end educational platform designed to help Grade 1 students master Filipino pronunciation. It features a native Android application powered by Google Cloud Speech-to-Text for real-time pronunciation feedback, paired with a comprehensive Web Dashboard for teachers and administrators to manage content, enroll students, and monitor learning analytics.
---
## Table of Contents
- Key Features
- Tech Stack & Architecture
- Project Structure
- Prerequisites
- Getting Started / Quick Start
- Configuration / Environment Variables
- Usage & Examples
- Development & Testing
- Contributing
- License
---
## Key Features
### 📱 Student Android Application
* **Speech Recognition Engine:** Custom integration with Google Cloud Speech-to-Text API tailored for Filipino phonemes, syllables (*Pantig*), phrases (*Parirala*), and sentences (*Pangungusap*).
* **Adaptive Retry System:** Intelligent progression logic that lowers the strictness threshold and provides contextual hints based on the number of failed attempts.
* **Gamification:** Unlockable levels and a rich sticker reward system stored securely in the cloud.
* **Audio Guides:** Embedded pronunciation audio guides using Android's native `MediaPlayer` with LruCache memory management.
* **Offline Resiliency:** Network availability checks and graceful error handling.
### 💻 Admin/Teacher Web Dashboard
* **Role-Based Access Control:** Secure access levels for Superadmins and Teachers.
* **Content Management System (CMS):** Full CRUD capabilities for Topics, Levels, audio files, and Stickers with Firebase Storage integration.
* **Bulk Student Enrollment:** Support for importing students rapidly via CSV parsing (`PapaParse`).
* **Rich Analytics:** Interactive visual reports (powered by `Chart.js`) displaying total students, active …