How dreamybriary/biringan-employee-management-system works
Biri-Go is a Flask employee-management system with role-specific browser portals backed by shared MySQL records; it can also run in a native desktop window. The principal workflow is staff sign-in, role-authorized portal actions, and database-backed results such as employee records, attendance, leave decisions, payroll, and reports. HR, admin, owner, and employee capabilities are distinct. The README documents several major features whose detailed implementation was not sampled; those are represented at their documented route or subsystem level. Edges are limited to documented relationships or sampled caller behavior.
Main entry points: admin.py Admin portal · employee.py Employee portal · hr.py HR portal · main.py Sign-in and activity
Components 21
Access and portals
- Sign-in and activity
system/backend/main.py - Admin portal
system/backend/routes/admin.py - HR portal
system/backend/routes/hr.py - Owner portal
system/backend/routes/owner.py - Employee portal
system/backend/routes/employee.py - Portal pages and scripts
system/template
People operations
- Employee accounts
system/backend/main.py - Departments and positions
system/backend/routes/admin.py - Attendance
system/backend/routes/employee.py - Leave management
system/backend/routes/admin.py - HR tools and reports
system/backend/routes/hr.py
Pay and records
- Payroll processing
system/backend/routes/hr.py - Payslips and acknowledgment
system/backend/routes/my_pay.py - Employee documents
system/backend/employee_documents.py
Shared platform
- Backup and restore
system/backend/backup_restore.py - Profile pictures
system/backend/profile_pictures.py - Role authorization
system/backend/auth.py - Database access and rules
system/backend/db.py - MySQL database
- Desktop wrapper
system/backend/desktop.py
Other components
- Staff user
Connections 33
- Staff user → Sign-in and activity: signs in
README.md - Sign-in and activity → Admin portal: role routes
README.md - Sign-in and activity → HR portal: role routes
README.md - Sign-in and activity → Owner portal: role routes
README.md - Sign-in and activity → Employee portal: role routes
README.md - Admin portal → Portal pages and scripts: serves portal
README.md - HR portal → Portal pages and scripts: serves portal
README.md - Owner portal → Portal pages and scripts: serves portal
README.md - Employee portal → Portal pages and scripts: serves portal
README.md - Admin portal → Employee accounts: manages
README.md - Admin portal → Departments and positions: manages
system/backend/routes/admin.py - HR portal → Attendance: records
README.md - Employee portal → Attendance: checks in
system/backend/routes/employee.py - Employee portal → Leave management: requests leave
system/backend/routes/employee.py - Admin portal → Leave management: reviews
system/backend/routes/admin.py - HR portal → HR tools and reports: manages
README.md - HR portal → Payroll processing: generates
README.md - Employee portal → Payslips and acknowledgment: views pay
README.md - Payslips and acknowledgment → Payroll processing: reads payroll
system/backend/routes/my_pay.py - Employee portal → Employee documents: manages files
README.md - Admin portal → Backup and restore: runs backups
README.md - Staff user → Profile pictures: updates profile
README.md - Admin portal → Role authorization: guards actions
system/backend/routes/admin.py - HR portal → Role authorization: guards actions
system/backend/routes/hr.py - Owner portal → Role authorization: guards actions
system/backend/routes/owner.py - Employee portal → Role authorization: guards actions
system/backend/routes/employee.py - Admin portal → Database access and rules: queries
system/backend/routes/admin.py - HR portal → Database access and rules: queries
system/backend/routes/hr.py - Owner portal → Database access and rules: queries
system/backend/routes/owner.py - Employee portal → Database access and rules: queries
system/backend/routes/employee.py - Database access and rules → MySQL database: reads and writes
system/backend/db.py - Backup and restore → MySQL database: exports and restores
system/backend/backup_restore.py - Desktop wrapper → Sign-in and activity: wraps app
system/backend/desktop.py