How manastg/emptyclassroomfinder works
Empty Classroom Finder scrapes IILM timetable data, stores it as JSON, and serves available classrooms for a selected day and period. The main request path is browser interface → Flask endpoint → availability calculation, which reads the timetable and classroom catalogue. A separate scraper and catalogue-generation step maintain those inputs; browser code can cache today’s results. The graph reflects README-described capabilities and shown calls; the HTML and JSON data contents were not sampled, so their detailed structure and wiring are not inferred.
Main entry points: app.py Flask app · emptyClassroom.py Availability finder · script.js Search interface · timetable.json Timetable JSON
Components 12
Timetable collection
- Timetable scraper
scraper/scraper.py
Timetable data
- Timetable JSON
timetable.json - Catalogue generator
src/allClassroom.py - Classroom catalogue
src/allClassroom.json
Availability service
- Flask app
app.py - Availability finder
src/emptyClassroom.py
Browser interface
- Web page
frontend/index.html - Search interface
frontend/script.js - Today cache loader
frontend/cache.js - Browser local storage
Other components
- User
- IILM timetable
Connections 14
- Timetable scraper → IILM timetable: loads timetable
scraper/scraper.py - Timetable scraper → Timetable JSON: writes JSON
scraper/scraper.py - Catalogue generator → Timetable JSON: reads JSON
src/allClassroom.py - Catalogue generator → Classroom catalogue: writes JSON
src/allClassroom.py - User → Web page: opens interface
README.md - Flask app → Web page: serves page
app.py - Search interface → Flask app: fetches results
frontend/script.js - Today cache loader → Flask app: fetches periods
frontend/cache.js - Flask app → Availability finder: calls finder
app.py - Availability finder → Timetable JSON: reads schedule
src/emptyClassroom.py - Availability finder → Classroom catalogue: reads rooms
src/emptyClassroom.py - Flask app → Search interface: returns room list
app.py - Search interface → Browser local storage: reads and writes
frontend/script.js - Today cache loader → Browser local storage: stores results
frontend/cache.js