Spaces:
Sleeping
Sleeping
| title: Debate Class LMS | |
| emoji: 🎭 | |
| colorFrom: blue | |
| colorTo: purple | |
| sdk: docker | |
| app_port: 8501 | |
| tags: | |
| - streamlit | |
| - lms | |
| - education | |
| - debate | |
| pinned: false | |
| short_description: Learning Management System for Debate Class | |
| # Debate Class LMS - Learning Management System | |
| A comprehensive Learning Management System built with Streamlit specifically designed for debate class instruction. **Cloud-ready and optimized for Hugging Face Spaces deployment.** | |
| ## 🎭 Features | |
| ### 🔐 Authentication | |
| - Secure student login system with Supabase database | |
| - Individual student accounts | |
| - Session management | |
| - Custom authentication system | |
| ### 📚 Course Content | |
| - Week-by-week structured learning materials | |
| - Interactive quizzes and assessments | |
| - Video resources and lecture materials | |
| - Assignment submission system | |
| ### 📊 Dashboard | |
| - Student progress tracking | |
| - Assignment due dates | |
| - Course announcements | |
| - Learning objectives overview | |
| ### 📝 Assignments | |
| - File upload capabilities | |
| - Assignment descriptions and grading criteria | |
| - Submission tracking | |
| - Multiple file format support | |
| ### 📝 Instructor Notes | |
| - Attendance tracking for each class session | |
| - Student progress notes (writing, research, case development) | |
| - Debate skills assessment (speaking, presentation, strategy) | |
| - Parent communication notes and recommendations | |
| - Tournament and important dates tracking | |
| - General notes and observations | |
| - Instructor-only access with role-based security | |
| ## 👥 Student Accounts | |
| The system includes the following student accounts: | |
| | Username | Name | Role | | |
| |----------|------|------| | |
| | `instructor` | Debate Instructor | Instructor | | |
| | `alice` | Alice Johnson | Student | | |
| | `bob` | Bob Smith | Student | | |
| | `carol` | Carol Davis | Student | | |
| | `david` | David Wilson | Student | | |
| | `emma` | Emma Brown | Student | | |
| **Default Password for all accounts:** `password123` | |
| ## 🛠️ Installation & Usage | |
| ### Local Development | |
| 1. **Install Dependencies:** | |
| ```bash | |
| pip install -r requirements.txt | |
| ``` | |
| 2. **Set up Supabase:** | |
| - Create a Supabase project | |
| - Run the SQL script in `database/setup.sql` | |
| - Add your credentials to `.streamlit/secrets.toml` | |
| 3. **Run the Application:** | |
| ```bash | |
| streamlit run src/main.py | |
| ``` | |
| 4. **Test Database Connection (Optional):** | |
| ```bash | |
| streamlit run tests/test_database.py | |
| ``` | |
| ### Hugging Face Spaces Deployment | |
| 1. **Fork this repository** to your GitHub account | |
| 2. **Create a new Space on Hugging Face:** | |
| - Go to [huggingface.co/spaces](https://huggingface.co/spaces) | |
| - Click "Create new Space" | |
| - Choose "Docker" as the SDK | |
| - Link to your forked repository | |
| 3. **Add Repository Secrets:** | |
| - Go to your GitHub repository settings | |
| - Navigate to "Secrets and variables" → "Actions" | |
| - Add these repository secrets: | |
| - `SUPABASE_URL`: Your Supabase project URL | |
| - `SUPABASE_KEY`: Your Supabase anon public key | |
| 4. **Deploy:** | |
| - The Space will automatically build and deploy | |
| - Your app will be available at `https://huggingface.co/spaces/your-username/your-space-name` | |
| ## 📁 Application Structure | |
| ``` | |
| ├── src/ | |
| │ ├── main.py # Main application entry point | |
| │ ├── auth.py # Authentication module | |
| │ └── views/ # Page modules | |
| │ ├── __init__.py | |
| │ ├── dashboard.py # Dashboard page | |
| │ ├── week1.py # Week 1 lesson content | |
| │ ├── future_weeks.py # Weeks 2-4 placeholder content | |
| │ ├── assignments.py # Assignments page | |
| │ ├── resources.py # Resources page | |
| │ ├── user_management.py # User management (instructor only) | |
| │ └── instructor_notes.py # Instructor notes (instructor only) | |
| ├── tests/ | |
| │ ├── __init__.py | |
| │ └── test_database.py # Database connection testing | |
| ├── database/ | |
| │ ├── setup.sql # Database setup script | |
| │ ├── create_instructor_notes_table.sql # Instructor notes table | |
| │ └── instructor_notes_rls_policies.sql # RLS policies for instructor notes | |
| ├── .streamlit/ | |
| │ ├── config.toml # Streamlit configuration | |
| │ └── secrets.toml # Local secrets (not in repo) | |
| ├── requirements.txt # Python dependencies | |
| ├── Dockerfile # Container configuration | |
| └── README.md # This file | |
| ``` | |
| ## 🎯 Course Structure | |
| ### Week 1: Introduction to Debate | |
| - Understanding debate formats | |
| - Basic argument structure | |
| - Public speaking fundamentals | |
| - Evidence importance | |
| ### Week 2: Argument Structure | |
| - Components of strong arguments | |
| - Logical argument construction | |
| - Identifying logical fallacies | |
| - Argument mapping skills | |
| ### Week 3: Evidence & Research | |
| - Effective research strategies | |
| - Evidence quality evaluation | |
| - Proper source citation | |
| - Evidence organization | |
| ### Week 4: Rebuttal Techniques | |
| - Effective rebuttal strategies | |
| - Opponent argument identification | |
| - Defensive argumentation | |
| - Quick thinking development | |
| ## 🔧 Technical Details | |
| - **Framework:** Streamlit | |
| - **Database:** Supabase (PostgreSQL) | |
| - **Authentication:** Custom system with Supabase backend | |
| - **Data Storage:** Supabase database (cloud-ready) | |
| - **Deployment:** Optimized for Hugging Face Spaces | |
| - **Architecture:** Modular design with separate view modules | |
| ## 🎯 Use Cases | |
| - **High School Debate Classes:** Structured learning for debate teams | |
| - **College Debate Programs:** Advanced debate instruction | |
| - **Debate Clubs:** Organized practice and learning | |
| - **Public Speaking Courses:** Fundamental skills development | |
| ## 🔒 Security Features | |
| - Supabase Row Level Security (RLS) | |
| - Custom authentication system | |
| - User role management | |
| - Secure file upload handling | |
| ## ☁️ Cloud Features | |
| - **Supabase integration** - Cloud database and authentication | |
| - **Hugging Face Spaces ready** - Optimized for immediate deployment | |
| - **Docker containerization** - Consistent deployment environment | |
| - **Environment-based configuration** - Secrets management | |
| ## 🧪 Testing | |
| Run database tests locally: | |
| ```bash | |
| streamlit run tests/test_database.py | |
| ``` | |
| Test instructor notes functionality: | |
| ```bash | |
| streamlit run tests/test_instructor_notes.py | |
| ``` | |
| These tests will help you verify your Supabase connection and functionality. | |
| ## 📈 Future Enhancements | |
| - Real-time debate practice sessions | |
| - Video conferencing integration | |
| - Advanced progress analytics | |
| - Mobile-responsive design | |
| - Debate tournament management | |
| - Advanced user management | |
| - test commit and push | |
| --- | |
| **Built with ❤️ using Streamlit & Supabase | Cloud-ready for Hugging Face Spaces** | |