Program & Short Course Summary

Average Progress & Attendance
Cohort Status Distribution
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

Changes auto-sync to overview
Select a cohort to start updating
Choose a cohort from the dropdown above

Manage Data

Add Program / Short Course
Add Cohort
Add Unit

Unit Templates

Define unit templates for each program or short course. When you create a new cohort, these units will be automatically added.

Add Unit Template
Existing Templates
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.

All Units
Unit Code Title Program / Short Course Course Type Type Unit Type Status
Loading unit library...

Delete Data
Delete Program

This will delete the program and ALL its cohorts, units, students, and attendance records.

Delete Cohort

This will delete the cohort and ALL its units, students, and attendance records.

System Manual

Version 1.3.0
Overview

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
CCompetentStudent has demonstrated competency
NYCNot Yet CompetentStudent needs more practice/training
NANot AssessedAssessment not yet completed
RReassessmentReassessment 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
PPresentStudent attended the session
AAbsentStudent was absent without excuse
LLateStudent arrived late
NNo ShowStudent did not appear (expected)
EExcusedAbsence 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:

  1. In the Unit Templates section, select a program or short course from the dropdown
  2. Enter the unit code (e.g., BSBWHS301), title, and display order
  3. Click Add Template to save the template
  4. 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
When you create a new cohort for a program with templates, all active units are automatically added with "Not Started" status. The success message will indicate how many units were created.
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
  1. Click AI Assistant in the sidebar navigation
  2. Type your question in the message box at the bottom
  3. Press Enter or click Send to submit your question
  4. The AI will respond with helpful guidance
Note: The AI Assistant is focused on helping you with the DVTPD Tracking System. For questions outside this scope, it will politely redirect you to system-related topics.
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 2025
Current
What's New in v1.3.0
Accurate Attendance Calculation

Attendance percentage now counts ALL session dates. Unfilled/empty days count as Absent (0%) for realistic tracking. Encourages complete record-keeping.

Feature
Improved Header Contrast

White text for "DVTPD Tracking System" navbar and "Student Assessments" headers. Better visibility on colored backgrounds.

UI/UX
Previous 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 OpenAI
Chat with AI Assistant

Ask me anything about TVET programs, training, or get help with the system!

This AI assistant uses Replit's integrated AI service. Usage is billed to your Replit credits.