How bananharappulan-beep/attendance-monitor works
Attendance Monitor collects attendance reports from ESSL, replaces per-branch rows in Neon PostgreSQL, then serves dashboard data and derived attendance views through a Flask app. Users can inspect daily records and P/H/A matrices; the product also documents summary, inactive-employee, report-download, and developer sync capabilities. The daily fetch may run automatically or be triggered manually. Some UI and route wiring is unsampled, so the graph omits uncertain links rather than inferring calls.
Main entry points: db.py Database access · data_fetch.py Report fetcher · app.py Flask API · neon_sync.py Dashboard data and matrices
Components 17
Attendance ingestion
- Report fetcher
data_fetch.py - Runtime configuration
config.py - Daily scheduler
app.py
Neon data layer
- Database access
db.py - Neon PostgreSQL
Dashboard and access
- Dashboard interface
static/js/app.js - Account interface
static/js/auth-ui.js - Authentication and roles
auth.py - Flask API
app.py - Punch-in view
static/js/punchin.js - Punch-out view
static/js/punchout.js - Monthly view
static/js/monthly.js
Attendance views
- Dashboard data and matrices
neon_sync.py - Inactive employee matrices
inaactive.py - Downloadable reports
report.py
Other components
- ESSL attendance
- Dashboard user
Connections 15
- ESSL attendance → Report fetcher: provides reports
README.md - Report fetcher → Database access: replaces rows
data_fetch.py - Database access → Neon PostgreSQL: writes and cleans
README.md - Report fetcher → Runtime configuration: reads settings
data_fetch.py - Database access → Runtime configuration: reads connection
db.py - Daily scheduler → Report fetcher: runs daily fetch
README.md - Dashboard user → Dashboard interface: uses dashboard
README.md - Dashboard interface → Flask API: requests dashboard data
- Account interface → Flask API: calls account routes
static/js/auth-ui.js - Flask API → Authentication and roles: registers access control
app.py - Flask API → Dashboard data and matrices: reads dashboard data
app.py - Dashboard data and matrices → Database access: reads branch rows
neon_sync.py - Database access → Neon PostgreSQL: reads rows
README.md - Inactive employee matrices → Dashboard data and matrices: builds matrices from
inaactive.py - Downloadable reports → Dashboard data and matrices: reads attendance data
report.py