How cvarad96/employee-rating-system works
Project type and purpose
• This is a monolithic, full-stack PHP web application (“Employee Rating System”) backed by a MySQL database.
• It serves two user roles (Admin and Manager), has both synchronous user-facing flows (through PHP views and JS/CSS assets) and asynchronous processes (cron jobs for reminders and report generation), plus an API endpoint for push notifications.
File structure
• Top-level “api” folder holds an API endpoint (push.php) for web-push.
• “assets”, “css”, and “js” folders contain front-end resources (Bootstrap + custom CSS/JS).
• “views” is subdivided into “admin”, “manager”, “auth” – the presentation layer.
• “classes” contains domain models and services (User, Employee, Department, EmailService, ReportGenerator, Notification, AuditLog, PasswordReset, etc.).
• “includes” has shared scripts (auth guard, header/footer, common functions, notification snippets).
• “config” holds application and database configuration templates.
• “cron” contains CLI scripts for weekly reminders and report emails.
• “tools” includes helper scripts (key generation, password hashing).
• “vendor” and composer.json/lock show use of Composer for third-party libraries.
README for technical stack and behavior
• PHP 7.4+, MySQL 5.7+
• Email and push-notification support
• Responsive UI
• Cron-driven weekly jobs for reminders and reports
Elements
• Annotations for technologies (PHP-FPM, MySQL, Bootstrap, Composer).