Skip to content

README.md

Latest commit

 

History

History
100 lines (72 loc) · 3.71 KB

README.md

File metadata and controls

100 lines (72 loc) · 3.71 KB
Raw

Gearment Fullstack Homework

A take-home assignment for evaluating fullstack engineers with a focus on relational database design, REST API development, and responsive UI implementation using ReactJS.

📘 Objective

Design and implement a simple Leave Management System where employees can request leave and managers can approve/reject them.

📌 Basic Requirements (For All Candidates)

These are required for Junior, Mid, and Senior candidates.

🗄️ Backend

  • POST /login with mock or hardcoded login (employee vs. manager)
  • POST /leave-request: Submit a new leave request
  • GET /leave-request: View your own leave requests
  • PATCH /leave-request/:id: Approve/reject (manager only)
  • GET /leave-balance: Show available leave days
  • Design relational schema with:
    • users table
    • leave_requests table
    • leave_balances table

💻 Frontend (React)

  • Login switch for user role (employee/manager)
  • Dashboard:
    • Display leave balance
    • Table of previous leave requests
  • Form to submit leave request
  • Manager view to approve/reject requests
  • Responsive layout using Bootstrap

🟢 Junior-Level – Optional Extras

These are optional, but will help you stand out.

  • Basic frontend form validation (e.g. required fields, valid dates)
  • Filter or sort leave requests table by status or date
  • Use reusable React components (FormGroup, TableRow, etc.)
  • Meaningful commit history and README

🟡 Mid-Level – Additional Requirements

If you’re applying for a Mid-Level position, you are expected to complete some of the following.

  • Add support for leave types (annual, sick, unpaid)
  • Block overlapping leave requests
  • Backend folder structure: handlers/, services/, repos/
  • Frontend folder structure: components/, pages/, services/
  • 1–2 backend unit tests for key logic
  • Include Dockerfile or docker-compose.yml to run fullstack

🔴 Senior-Level – Advanced Requirements

If you’re applying for a Senior role, you are expected to complete several of the following.

  • Apply Clean Architecture or layered design to backend
  • Middleware for Role-Based Access Control (RBAC)
  • 4–5 unit/integration tests (e.g. for approval, validation, access control)
  • GitHub Actions (or CI pipeline) for test/lint/build
  • Add /docs/decisions.md with 3–5 architecture or design decisions
  • Generate OpenAPI (Swagger) spec for API docs
  • Use React Context API or simple state management for leave state
  • Handle UI edge cases (e.g. error boundaries, toast feedback)

📎 Tip

  • You’re not expected to finish everything.
  • Prioritize clarity, structure, and engineering maturity over flashy features.
  • Bonus items are a chance to go deeper based on your experience level.

Good luck!

📦 Folder Structure

fullstack-homework/
├── frontend/           # React + Bootstrap
├── backend/            # REST API
├── database/           # SQL schema / migrations
├── README.md           # This file
└── docker-compose.yml  # (Optional for fullstack setup)

🕐 Estimated Time

Working days: 7 days, bonus points come with the earlier submission

✅ Submission Guidelines

  1. Fork this repository or upload to your GitHub
  2. Include setup steps in a README.md inside each folder (frontend/, backend/)
  3. Optionally deploy or record a demo video
  4. Submit the repo link for review

📮 Questions?

If you have any questions or need clarifications, feel free to reach out to the hiring team at tech@gearment.com.

Good luck and have fun!