Energy Retrofit Program Training Platform

A comprehensive learning management system for Community-Based Organization (CBO) staff supporting residential energy efficiency programs.

---

🎯 Overview

This interactive training platform provides professional development for CBO staff across the entire energy retrofit program lifecycle—from community outreach through installation delivery and quality assurance.

Key Features:

• 🎓 13 learning modules across 3 program phases
• 📊 Progress tracking with time spent and quiz scores
• 🏆 Achievement system and gamification
• 📄 22 field-ready templates and tools
• 🔗 31 authoritative external resources
• 📱 Fully responsive design
• 💾 Local/session storage support

---

📚 Learning Modules

Phase 1: Outreach (6 modules)

• Community Engagement Fundamentals
• Door-to-Door Outreach Best Practices
• Digital Marketing for Energy Programs
• Community Event Planning
• Working with Landlords and Property Owners

Phase 2: Navigation (4 modules)

• Program Eligibility and Application Support
• Overcoming Barriers to Enrollment
• Case Management for Complex Households
• Energy Efficiency Basics (Assessment)

Phase 3: Delivery (3 modules)

• Coordinating Retrofit Installations
• Managing Household Expectations
• Quality Assurance and Post-Installation Support

---

🚀 Quick Start

Local Development

1. Clone the repository:

   git clone https://github.com/kamrawr/lms-interactive-platform.git
   cd lms-interactive-platform

2. Open in browser:

   open index.html

   Or use a local server:

   python -m http.server 8000
   # Visit http://localhost:8000

Deployment

Deploy to GitHub Pages or any static hosting service. No build process required—all assets are self-contained.

---

📁 Project Structure

├── index.html              # Main application entry point
├── README.md               # Documentation
├── src/                    # Source code
│   ├── js/                 # JavaScript modules
│   │   ├── app.js         # Core application logic
│   │   └── lesson-content.js  # Lesson rendering
│   ├── css/               # Stylesheets
│   │   └── styles.css     # UI styling
│   └── data/              # JSON data files
│       ├── data-modules.json  # Learning modules
│       ├── data-quizzes.json  # Knowledge checks
│       └── data-resources.json # External resources
├── templates/             # Downloadable templates (22 files)
│   ├── barriers_tracker.md
│   ├── door_script.md
│   └── ...
├── docs/                  # System documentation
│   ├── resources_reference.csv
│   ├── templates_reference.csv
│   └── RESOURCES_AND_TEMPLATES.md
├── scripts/               # Utility scripts
│   ├── generate_reference.js
│   └── cleanup.sh
└── archive/               # Legacy files

---

🛠️ Technology Stack

• Frontend: Vanilla JavaScript (ES6+)
• Styling: PicoCSS + Custom CSS
• Data Storage: localStorage / sessionStorage
• Assets: Self-contained (no external dependencies)

---

📊 Features

For Learners

• Personalized Learning Paths: Content adapts based on role and experience
• Progress Tracking: See time spent, completion rates, and quiz scores
• Knowledge Checks: 70% passing score required to complete modules
• Certificates: Download completion certificates with performance data
• Gamification: XP system, levels, and achievements

For Administrators

• Export/Import: Database backup and restore functionality
• Analytics: Track completion rates and time spent per module
• Resource Management: All templates and resources catalogued in CSV format
• Easy Updates: JSON-based content management

---

📖 Resources & Templates

External Resources (31)

Curated links to authoritative guidance from:

• DOE/NREL, EPA/ENERGY STAR, ASHRAE, BPI
• HUD, OSHA, NIOSH, ACEEE
• PNNL/BASC, SAMHSA, and more

Internal Templates (22)

Field-ready tools including:

• Outreach scripts and marketing calendars
• Intake forms and documentation checklists
• Installation schedules and QA checklists
• Referral lists and ROI templates

Full catalog: See docs/resources_reference.csv and docs/templates_reference.csv

---

🔧 Maintenance

Update Content

Add a new module:

1. Add module definition to src/data/data-modules.json
2. Add quiz questions to src/data/data-quizzes.json
3. Regenerate documentation: node scripts/generate_reference.js

Add a new resource:

1. Add entry to src/data/data-resources.json
2. Reference in module's resources array
3. Regenerate documentation

Add a new template:

1. Create .md file in templates/ directory
2. Add mapping to getTemplateFile() in src/js/app.js
3. Reference in module's Artifacts array as [Template Name]
4. Regenerate documentation

Generate Documentation

node scripts/generate_reference.js

This updates:

• docs/resources_reference.csv
• docs/templates_reference.csv
• docs/RESOURCES_AND_TEMPLATES.md

---

📝 Module Structure

Each learning module includes:

• Overview: Context and real-world application
• Key Facts: Evidence-based insights with source citations
• Concepts: Core professional competencies
• Applications: Practical scenarios with step-by-step guidance
• Knowledge Check: True/false and multiple choice quiz
• Templates: Downloadable tools for immediate use

---

🎓 Learning Features

Adaptive Content

• Role-based recommendations (Outreach Worker, Navigator, Case Manager, etc.)
• Experience-level filtering (Beginner, Intermediate, Advanced)
• Topic-based learning paths (Outreach, Navigation, Delivery)

Assessment

• Knowledge checks with instant feedback
• 70% passing score requirement
• Unlimited retakes with learning prompts
• Quiz scores saved to learner profile

Certificates

Generated certificates include:

• Learner name and completion date
• Module title and phase
• Time spent on module
• Quiz score achieved
• Learner profile (roles, experience level)

---

📄 License

This project is intended for educational and training purposes for Community-Based Organizations supporting residential energy efficiency programs.

---

🤝 Contributing

This is a training platform for CBO staff. For content updates or suggestions:

1. Review existing modules and resources
2. Ensure changes align with authoritative sources (DOE, EPA, ASHRAE, etc.)
3. Test changes locally before committing
4. Regenerate documentation after updates

---

📧 Support

For questions about platform usage or content:

• Review the documentation in docs/
• Check module definitions in src/data/data-modules.json
• See resource catalog in docs/resources_reference.csv

---

🔄 Version History

• v1.0 - Initial release with 13 modules, 22 templates, 31 resources
• Full audit completed October 2025
• All resources and templates verified and linked
• CSV-based reference documentation system

---

Built for Community-Based Organizations supporting energy equity and residential efficiency.

Empowering frontline staff with professional training and field-ready tools.