mars-employee

byKushmitha L

Build a complete Employee Management Web Application using the following requirements. ๐Ÿ”น Tech Stack: - Frontend: HTML, CSS, JavaScript (or React.js if advanced) - Backend: PHP (use XAMPP server) - Database: MySQL (preferred) or Supabase / NoSQL (optional) - Use APIs wherever required - Use GitHub for version control ๐Ÿ”น Core Features: 1. Admin Panel: - View total employees report - Export reports to Excel or Google Sheets - View individual employee reports - Calculate salary based on working hours - Track employee working period 2. Employee Dashboard: - Display number of projects - Show ongoing projects - Track number of leads used - Show positive leads - Show junk leads - Allow employee to submit daily report (EOD update) 3. Attendance & Salary Logic: - Monthly working days = 29 + 2 - Full Day = if working hours โ‰ฅ 8 hours - Half Day = if working hours โ‰ฅ 4 hours - If working hours < 4 โ†’ consider as Holiday - Every Monday should be automatically marked as week off - Salary should be calculated based on total working hours 4. Leave Management: - Create a leave approval page - Employees can request leave - Admin can approve/reject leave ๐Ÿ”น Backend Requirements: - Create REST APIs using PHP - Handle CRUD operations (Create, Read, Update, Delete) - Secure login system for Admin and Employees - Use MySQL database with proper schema ๐Ÿ”น Database Tables: - Employees (id, name, email, password) - Attendance (id, emp_id, date, hours) - Projects (id, emp_id, total_projects, ongoing_projects, leads_used, positive_leads, junk_leads) - Leaves (id, emp_id, from_date, to_date, status) ๐Ÿ”น Additional Features: - Authentication (Login & Logout) - Responsive UI design - Dashboard with summary cards - Error handling and validations - Clean and modular code ๐Ÿ”น Deployment Setup: - Use XAMPP (Apache + MySQL + PHP) - Project should run on localhost - Provide clear folder structure ๐Ÿ”น Output Required: - Full source code (frontend + backend) - Database schema (SQL file) - Instructions to run the project - Optional: React version of frontend ๐Ÿ”น Bonus (if possible): - Export reports to Excel - Use Chart.js for analytics dashboard - Clean UI design

LandingLoginDashboard
Landing

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirement Document
Page 1 of 4

mars-employee System Requirements Document

Introduction

The "mars-employee" project is an Employee Management Web Application designed to streamline and automate the management of employee data, attendance, salary calculations, and leave management. This document outlines the system requirements for the development and deployment of the application.

System Overview

The mars-employee application will provide a comprehensive solution for managing employee-related tasks within an organization. It includes features for both administrators and employees, ensuring efficient data handling, reporting, and user interaction. The application will be built using a robust tech stack, ensuring scalability and ease of maintenance.

Page 2 of 4

Functional Requirements

  • As an Admin, I should be able to view total employees report.
  • As an Admin, I should be able to export reports to Excel or Google Sheets.
  • As an Admin, I should be able to view individual employee reports.
  • As an Admin, I should be able to calculate salary based on working hours.
  • As an Admin, I should be able to track employee working periods.
  • As an Employee, I should be able to view the number of projects.
  • As an Employee, I should be able to see ongoing projects.
  • As an Employee, I should be able to track the number of leads used.
  • As an Employee, I should be able to see positive leads.
  • As an Employee, I should be able to see junk leads.
  • As an Employee, I should be able to submit a daily report (EOD update).
  • As an Admin, I should be able to manage attendance and salary logic.
  • As an Admin, I should be able to create a leave approval page.
  • As an Employee, I should be able to request leave.
  • As an Admin, I should be able to approve or reject leave requests.

User Personas

  • Admin: Responsible for managing employee data, reports, and leave approvals.
  • Employee: Can view personal project details, submit reports, and request leaves.
Page 3 of 4

Visuals Colors and Theme

  • primary: #2A9D8F (Teal)
  • primary_light: #A8DADC (Light Teal)
  • secondary: #E63946 (Crimson)
  • accent: #F4A261 (Orange)
  • highlight: #E9C46A (Gold)
  • bg: #F1FAEE (Off White)
  • surface: rgba(233, 233, 233, 0.8)
  • text: #264653 (Dark Blue)
  • text_muted: #6D6875 (Muted Gray)
  • border: rgba(38, 70, 83, 0.2)

Signature Design Concept

The mars-employee application will feature an interactive galaxy map on the homepage, where each star represents a feature or section of the application. Users can click on stars to open task cards, drag to rotate the cluster, and hover to highlight connections. This concept will be brought to life using @react-three/fiber and @react-three/drei for 3D interactions, providing a unique and engaging user experience.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, creating a layered depth effect as users scroll. Decorative elements will move at different speeds, enhancing the storytelling aspect of the application. Internal pages will maintain a "static" interaction model for clarity and ease of use.

Page 4 of 4

Non-Functional Requirements

  • The system should be responsive and accessible on various devices.
  • Ensure data security and privacy for all user information.
  • Maintain high performance and quick load times.

Tech Stack

  • Frontend: HTML, CSS, JavaScript (React.js optional)
  • Backend: PHP (XAMPP server)
  • Database: MySQL (preferred), Supabase/NoSQL (optional)
  • Version Control: GitHub

Assumptions and Constraints

  • The application will be deployed on a local server using XAMPP.
  • The system will handle a moderate number of concurrent users.
  • The application will be developed with scalability in mind for future enhancements.

Glossary

  • EOD: End of Day
  • CRUD: Create, Read, Update, Delete
  • REST API: Representational State Transfer Application Programming Interface

This document provides a comprehensive overview of the requirements and design for the mars-employee project, ensuring a clear path forward for development and deployment.

Landing design preview
Landing: View App
Login: Sign In
Dashboard: View Summary
Reports: View Total Employees
Reports: Export to Excel
Reports: View Individual Employee
Salary: Calculate by Hours
Attendance: Track Working Period
Leave: Review Requests
Leave: Approve or Reject
Employees: Manage Records