Raymacmillan/Industrial-Attachement-Management-System-IAMS-

A web-based management system for the University of Botswana's industrial attachment program, automating registration, student-organization matching, and progress tracking using React and Supabase. # Industrial Attachment Management System Digitizing the industrial attachment lifecycle for the University of Botswana. Live Demo · Test Docs · Report a Bug --- ## Table of Contents - Overview - Screenshots - Tech Stack - Architecture - Features - Project Structure - Getting Started - Environment Variables - Database - Edge Functions - Testing - Deployment - Release History - Future Improvements - Acknowledgements - Contributing --- ## Overview The Department of Computer Science at the University of Botswana manages hundreds of student industrial attachments annually through a fragmented, paper-based workflow. Coordinators manually match students to organisations, supervisors chase handwritten logbooks, and students receive no real-time feedback on their placement status. **IAMS** replaces this entirely. It is a full-stack web platform that handles the complete industrial attachment lifecycle — from student onboarding and organisation registration, through intelligent algorithmic matching and placement management, to weekly digital logbooks, supervisor assessments, and legally-formatted PDF report generation. ### What Makes IAMS Different | Traditional System | IAMS | |---|---| | Paper logbooks, prone to loss | Digital weekly logbook with auto-save and three structured templates | | Manual matching by coordinator | Heuristic scoring engine with slot-aware deduplication | | No document enforcement | Allocation blocked if required documents are missing | | Supervisor visits uncoordinated | Two-phase visit scheduling with student email notification | | No audit trail | Every approval digitally stamped with supervisor name, title, and timestamp | | Physical PDF reports | Legally-formatted document with UB letterhead and signature blocks | --- ## Screenshots ### Landing Page ### Coordinator — Heuristic Matching Engine ### Student — Weekly Logbook ### Industrial Supervisor — Week Review ### University Supervisor — Visit Assessment ### Offi …