feat: add employee management, backend health check, and UI improvements

server/src/app/api/v1/endpoints/employees.py

@@ -2,25 +2,37 @@ from __future__ import annotations
 
 from typing import Annotated
 
-from fastapi import APIRouter, Depends, HTTPException, status
+from fastapi import APIRouter, Depends, HTTPException, Query, status
 from sqlalchemy.orm import Session
 
 from app.api.deps import get_db
-from app.schemas.employee import EmployeeCreate, EmployeeRead
+from app.schemas.employee import EmployeeCreate, EmployeeMetaRead, EmployeeRead
 from app.services.employee import EmployeeService
 
 router = APIRouter()
 DbSession = Annotated[Session, Depends(get_db)]
 
 
+@router.get("/meta", response_model=EmployeeMetaRead)
+def get_employee_meta(db: DbSession) -> EmployeeMetaRead:
+    return EmployeeService(db).get_employee_meta()
+
+
 @router.get("", response_model=list[EmployeeRead])
-def list_employees(db: DbSession) -> list[EmployeeRead]:
-    return EmployeeService(db).list_employees()
+def list_employees(
+    db: DbSession,
+    status_filter: Annotated[str | None, Query(alias="status")] = None,
+    keyword: str | None = None,
+) -> list[EmployeeRead]:
+    return EmployeeService(db).list_employees(status=status_filter, keyword=keyword)
 
 
 @router.post("", response_model=EmployeeRead, status_code=status.HTTP_201_CREATED)
 def create_employee(payload: EmployeeCreate, db: DbSession) -> EmployeeRead:
-    return EmployeeService(db).create_employee(payload)
+    try:
+        return EmployeeService(db).create_employee(payload)
+    except ValueError as exc:
+        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(exc)) from exc
 
 
 @router.get("/{employee_id}", response_model=EmployeeRead)