Program & Short Course Summary
| Name | Type | Accreditation | Level | Provider | Date Range | Total Cohorts | Active | Completed | Avg Progress | Avg Attendance | Key Issues | Actions |
|---|
Cohort Details
Issues Tracker
| Cohort | Issue Description | Priority | Reported By | Deadline | Status | Resolved By | Actions |
|---|
Trainer Dashboard
Select a cohort to start updating
Choose a cohort from the dropdown aboveManage Data
Add Cohort
Unit Templates
Define unit templates for each program or short course. When you create a new cohort, these units will be automatically added.
| Order | Unit Code | Title | Type | Active | Actions |
|---|---|---|---|---|---|
| Select a program to view its unit templates | |||||
Unit Library
View all units in the system, including templates and units added to cohorts. Units are organized by program or short course.
| Unit Code | Title | Program / Short Course | Course Type | Type | Unit Type | Status |
|---|---|---|---|---|---|---|
| Loading unit library... | ||||||
Delete Data
This will delete the program and ALL its cohorts, units, students, and attendance records.
This will delete the cohort and ALL its units, students, and attendance records.
System Manual
Version 1.3.0Overview
The DVTPD Tracking System is a comprehensive web application designed for tracking Technical and Vocational Education and Training (TVET) program progress across multiple cohorts.
Key Features:
- Program and Short Course Management with accreditation tracking
- Cohort tracking with start/end dates, location, and trainer assignment
- Date-based attendance register with status codes
- Unit progress logging with completion tracking
- Issues tracking and resolution management
- Visual analytics with charts and KPI metrics
- Year-based filtering for historical reporting
- CSV export functionality for reporting
Getting Started
1. Sign In
Click the Sign In button in the top-right corner and enter the access code provided by your administrator.
2. Navigation
Use the sidebar on the left to navigate between different sections:
- Overview Dashboard - View program summaries and analytics
- Cohort Details - View detailed cohort information
- Issues Tracker - Log and track cohort-related issues
- Trainer Dashboard - Manage attendance and progress
- Manage Data - Add or delete programs, cohorts, and units
3. Authentication Required
Most data modification actions require you to be signed in. View-only access is available without authentication.
Overview Dashboard
KPI Cards
The dashboard displays key performance indicators including:
- Total Programs/Courses - Number of programs and short courses
- Active/Completed Cohorts - Cohort status breakdown
- Average Progress - Overall program completion rate
- Average Attendance - Overall attendance percentage
- Open Issues - Number of unresolved issues
Filtering
Use the dropdown filters to narrow results:
- Year Filter - View data for specific years
- Course Type Filter - Show Programs only or Short Courses only
Charts
Interactive charts display progress/attendance averages and cohort status distribution.
Export
Click Export Summary or Export Cohorts to download CSV reports.
Cohort Details
View detailed information about each cohort including:
- Program name and type
- Location and trainer
- Start and end dates
- Current phase/stage
- Progress and attendance percentages
- Associated units and their completion status
Use the Cohort Filter dropdown to view specific cohorts.
Issues Tracker
Adding Issues
Click Add Issue to log a new issue:
- Select the related cohort
- Describe the issue
- Suggest a resolution action
- Set a deadline
Issue Status
- Open - Issue requires attention
- In Progress - Issue is being addressed
- Resolved - Issue has been resolved
- Closed - Issue closed without resolution
Resolved By Tracking
When you mark an issue as resolved, you'll be prompted to enter your name. This creates an audit trail showing:
- Who resolved the issue
- When it was resolved (date)
This helps maintain accountability and provides a clear record of issue resolution.
Trainer Dashboard
The Trainer Dashboard provides tools for managing daily cohort activities:
1. Select a Cohort
Choose a cohort from the dropdown to begin managing attendance and progress.
2. Attendance Register
Track daily attendance for all students (see Attendance Register section below).
3. Cohort Progress
Use the slider to update overall cohort progress percentage and click Update to save.
4. Unit Progress Log
Update individual unit completion rates and status for each cohort. Options include:
- Not Started - Unit training has not begun
- In Progress - Unit training is ongoing
- Completed - Unit has been completed
5. Student Assessments
Record and track competency-based assessments for each student:
- Click Record Assessment to add a new assessment
- Select student, unit, assessment type, and date
- Enter score percentage (optional) and competency status
- Add assessor name and feedback notes
Assessment types include: Written Test, Practical, Portfolio, Observation, Project, and Oral.
Assessment & Grading
Competency Status Codes
| Code | Status | Description |
|---|---|---|
| C | Competent | Student has demonstrated competency |
| NYC | Not Yet Competent | Student needs more practice/training |
| NA | Not Assessed | Assessment not yet completed |
| R | Reassessment | Reassessment required |
Student Transcript
View a complete summary of a student's assessment results across all units. The transcript shows:
- Student and program information
- Completion progress bar
- Unit-by-unit competency status
- Number of assessment attempts per unit
User Roles
The system supports role-based access control with four user roles:
| Role | Permissions |
|---|---|
| Admin | Full access to all features including program/cohort management, user management, and data deletion |
| Trainer | Manage students, attendance, and assessments. View all data and export reports |
| Assessor | Record and manage assessments. View student data and export reports |
| Student | View own progress and assessment results (limited access) |
Use the role selector in the top navigation bar to switch between roles.
Attendance Register
Spreadsheet-Style Interface
The attendance register uses an intuitive spreadsheet layout:
- Rows - Each row represents a student
- Columns - Each column represents a date
- Cells - Click to cycle through status codes
Adding Dates (Columns)
Use the date picker in the header to add new attendance columns. Each date can only be added once.
Adding Students (Rows)
Type a student name in the input field at the bottom of the grid and press Enter to add a new student.
Status Codes
Click any cell to cycle through attendance statuses:
| Code | Status | Description |
|---|---|---|
| P | Present | Student attended the session |
| A | Absent | Student was absent without excuse |
| L | Late | Student arrived late |
| N | No Show | Student did not appear (expected) |
| E | Excused | Absence was excused (not counted) |
Attendance Calculation
Attendance percentage is calculated as: (Present + 0.75 * Late) / (Total - Excused) * 100. Excused absences are not counted against attendance.
Manage Data
Adding Data
- Add Program/Short Course - Create new programs with ID, name, accreditation status, level, and provider
- Add Cohort - Create cohorts linked to programs with location, trainer, and phase
- Add Unit - Create units linked to cohorts with code, title, and status
Unit Templates
Unit templates allow you to define a standard set of units for each program or short course. When you create a new cohort, these units are automatically added, eliminating repetitive data entry.
How to use:
- In the Unit Templates section, select a program or short course from the dropdown
- Enter the unit code (e.g., BSBWHS301), title, and display order
- Click Add Template to save the template
- Repeat for all units in the program's curriculum
Template Options:
- Display Order - Controls the sequence in which units appear (lower numbers appear first)
- Active/Inactive - Toggle templates on or off. Inactive templates are not copied to new cohorts
Unit Library
The Unit Library provides a comprehensive view of all units across all programs and short courses in the system. It shows both unit templates and actual cohort units in a single searchable table.
Features:
- Search - Find units by code or title using the search box
- Filter by Course Type - View only Program units or Short Course units
- Type Indicator - Shows whether a unit is a Template or a Cohort Unit
- Status - Displays Active/Inactive for templates or completion status for cohort units
- Unit Type - Shows Core (blue) or Elective (cyan) classification for each unit
Deleting Data
Warning: Delete operations are permanent and cascade to related data:
- Deleting a Program removes ALL its cohorts, units, students, attendance records, issues, and unit templates
- Deleting a Cohort removes ALL its units, students, attendance records, and issues
Always confirm before deleting. This action cannot be undone.
AI Assistant
The AI Assistant is an intelligent chat feature designed to help you navigate and use the DVTPD Tracking System more effectively.
What Can the AI Assistant Help With?
- System Navigation - Learn how to use different features like dashboards, cohort management, and data entry
- Programs & Short Courses - Get information about available programs and courses in the system
- Feature Guidance - Understand how to track attendance, manage units, log issues, and record assessments
- System Updates - Learn about recent changes and new features
How to Use
- Click AI Assistant in the sidebar navigation
- Type your question in the message box at the bottom
- Press Enter or click Send to submit your question
- The AI will respond with helpful guidance
Recent Changes & Updates
This section provides detailed information about recent system updates, changes, and any actions you may need to take.
Latest: Version 1.3.0
Released November 2025What's New in v1.3.0
Attendance percentage now counts ALL session dates. Unfilled/empty days count as Absent (0%) for realistic tracking. Encourages complete record-keeping.
FeatureWhite text for "DVTPD Tracking System" navbar and "Student Assessments" headers. Better visibility on colored backgrounds.
UI/UXPrevious Improvements
- Unit Code Normalization (v1.2.7): SQLAlchemy validators auto-normalize unit codes (trim whitespace, uppercase) to prevent duplicates
- Unit Template Sync (v1.2.6): Auto-sync new templates to existing cohorts with manual sync option
- Unit Count Display (v1.2.4): Unit Progress Log shows total unit count dynamically
- Unit Classification (v1.2.3): Core/Elective unit types with visual badges (blue/cyan)
- Performance Optimization: Cohort selection loads 3-4x faster with parallel data loading
- Enhanced Trainer Dashboard: Full-width attendance register with improved layout
- Unit Templates: Create reusable templates that auto-copy to new cohorts
- Unit Library: View all units across all programs with search and filter
- Resolved By Tracking: Issues show who resolved them and when
Action Required
No action required for this update.
All changes are backward compatible. Your existing data remains intact. New features are available immediately.
Version History
v1.3.0 Accurate Attendance & Production Ready
November 2025- Attendance calculation: ALL session dates now count - unfilled days = Absent (0%)
- Realistic tracking: Encourages complete attendance record-keeping
- White text headers: Improved contrast for navbar and assessment headers
- Production ready: Debug logging disabled, FLASK_DEBUG removed
v1.2.9 Draggable Modal & Enhanced Note Icons
November 2025- UI enhancement: Professional draggable Bootstrap modal for editing attendance date notes
- Date display: Full formatted dates with calendar icon
- Icon improvements: Upgraded note icons to 14px clipboard icons
v1.2.8 Assessment System Fix & Database Update
November 2025- Bug fix: Resolved assessment recording error (IntegrityError) when saving assessments
- Schema update: Assessments now use unit_id (integer) instead of unit_code for proper foreign key relationships
- Database migration: unit_code column made nullable, unit_id set as required field
- Frontend update: Assessment form and filters now use unit ID for reliable data handling
- Data integrity: Includes unit code normalization from v1.2.7 (trim whitespace, uppercase)
v1.2.7 Unit Code Normalization
November 2025- SQLAlchemy validators auto-normalize unit codes (trim whitespace, uppercase)
- All existing unit codes cleaned and normalized to prevent duplicates
- Defense-in-depth protection against duplicate entries
v1.2.6 Unit Template Sync
November 2025- Auto-sync: New unit templates automatically add to all existing cohorts
- Manual sync button in Unit Progress Log for on-demand syncing
- Real-time refresh: Trainer Dashboard updates when switching tabs
- Smart sync: Prevents duplicate units using unit code matching
- Feedback: Shows count of synced units in toast notifications
v1.2.5 AI Assistant Integration
November 2025- New AI Assistant tab in sidebar navigation
- Interactive chat interface for system help and guidance
- Get information about programs, short courses, and system features
- Powered by OpenAI via Replit's integrated AI service
- Professional UI with message history and loading states
v1.2.4 Unit Count Display
November 2025- Unit Progress Log header now displays total unit count (e.g., "11 Units")
- Count updates dynamically when switching between cohorts
- Black text on light badge for improved visibility
- Proper singular/plural handling ("1 Unit" vs "11 Units")
v1.2.3 Unit Classification (Core/Elective)
November 2025- Unit Type field added to distinguish Core vs Elective units
- Unit type automatically inherited from templates to new cohort units
- Visual badges for easy classification (Core: blue, Elective: cyan)
- Unit Library shows new classification in searchable table
- Backward compatible - existing units default to Core
v1.2.2 Performance & UI Enhancements
November 2025- Cohort selection now loads ~3-4x faster with parallel API loading
- Trainer Dashboard layout improved: Full-width attendance register, compact cohort progress bar
- Enhanced attendance visuals: gradient buttons, zebra-striped rows, sticky student column
v1.2.1 Issue Resolution Tracking
November 2025- Resolved By column in Issues Tracker showing who resolved and when
- Compact sidebar design for better content visibility
- Recent Changes section in System Manual
v1.2.0 Program Unit Templates
November 2025- Unit Templates - Define reusable unit templates for programs and short courses
- Unit Library - View all units in the system with search and filter
- Automatic unit creation when new cohorts are added
- Template management with display order and active/inactive status
- Professional toast notification system
- Improved unit model for better data flexibility
v1.1.0 Assessment & RBAC
November 2025- Competency-based assessment tracking per student/unit
- Assessment types: Written Test, Practical, Portfolio, Observation, Project, Oral
- Student transcript generation with competency status
- Role-Based Access Control (Admin, Trainer, Assessor, Student)
- Role-specific sidebar navigation and permissions
v1.0.0 Initial Release
November 2025- Program and Short Course management with accreditation tracking
- Cohort management with location, trainer, and phase tracking
- Date-based attendance register with spreadsheet-style UI
- Status codes: Present, Absent, Late, No Show, Excused
- Unit progress logging with completion tracking
- Issues tracker with status management
- Visual analytics dashboard with Chart.js
- Year-based filtering for historical data
- CSV export for summary and cohort data
- Session-based access code authentication
- PostgreSQL database backend
- Responsive design with Bootstrap 5
Roadmap - Planned Features
- Full Student Registration Database with demographics
- Student enrollment workflows and documentation
- Advanced reporting and analytics
- Email notifications for issues and deadlines
- Student portal for viewing progress
- Certificate generation upon completion
AI Assistant
Powered by OpenAIAsk me anything about TVET programs, training, or get help with the system!