Santhosh Janardhanan
1592c5be8d
- Add CapacityService with working days, PTO, holiday calculations - Add WorkingDaysCalculator utility for reusable date logic - Implement CapacityController with individual/team/revenue endpoints - Add HolidayController and PtoController for calendar management - Create TeamMemberAvailability model for per-day availability - Add Redis caching for capacity calculations with tag invalidation - Implement capacity planning UI with Calendar, Summary, Holiday, PTO tabs - Add Scribe API documentation annotations - Fix test configuration and E2E test infrastructure - Update tasks.md with completion status Backend Tests: 63 passed Frontend Unit: 32 passed E2E Tests: 134 passed, 20 fixme (capacity UI rendering) API Docs: Generated successfully
104 lines
2.8 KiB
PHP
104 lines
2.8 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Controllers\Api;
|
|
|
|
use App\Http\Controllers\Controller;
|
|
use App\Services\CapacityService;
|
|
use Illuminate\Http\JsonResponse;
|
|
use Illuminate\Http\Request;
|
|
|
|
class CapacityController extends Controller
|
|
{
|
|
public function __construct(protected CapacityService $capacityService) {}
|
|
|
|
/**
|
|
* Get Individual Capacity
|
|
*
|
|
* Calculate capacity for a specific team member in a given month.
|
|
*
|
|
* @group Capacity Planning
|
|
* @urlParam month string required The month in YYYY-MM format. Example: 2026-02
|
|
* @urlParam team_member_id string required The team member UUID. Example: 550e8400-e29b-41d4-a716-446655440000
|
|
* @response {
|
|
* "person_days": 18.5,
|
|
* "hours": 148,
|
|
* "details": [
|
|
* {
|
|
* "date": "2026-02-02",
|
|
* "availability": 1,
|
|
* "is_pto": false
|
|
* }
|
|
* ]
|
|
* }
|
|
*/
|
|
public function individual(Request $request): JsonResponse
|
|
{
|
|
$data = $request->validate([
|
|
'month' => 'required|date_format:Y-m',
|
|
'team_member_id' => 'required|exists:team_members,id',
|
|
]);
|
|
|
|
$capacity = $this->capacityService->calculateIndividualCapacity($data['team_member_id'], $data['month']);
|
|
|
|
return response()->json($capacity);
|
|
}
|
|
|
|
/**
|
|
* Get Team Capacity
|
|
*
|
|
* Summarize the combined capacity for all active team members in a month.
|
|
*
|
|
* @group Capacity Planning
|
|
* @urlParam month string required The month in YYYY-MM format. Example: 2026-02
|
|
* @response {
|
|
* "month": "2026-02",
|
|
* "person_days": 180.5,
|
|
* "hours": 1444,
|
|
* "members": [
|
|
* {
|
|
* "id": "550e8400-e29b-41d4-a716-446655440000",
|
|
* "name": "Ada Lovelace",
|
|
* "person_days": 18.5,
|
|
* "hours": 148
|
|
* }
|
|
* ]
|
|
* }
|
|
*/
|
|
public function team(Request $request): JsonResponse
|
|
{
|
|
$data = $request->validate([
|
|
'month' => 'required|date_format:Y-m',
|
|
]);
|
|
|
|
$payload = $this->capacityService->calculateTeamCapacity($data['month']);
|
|
|
|
return response()->json($payload);
|
|
}
|
|
|
|
/**
|
|
* Get Possible Revenue
|
|
*
|
|
* Estimate monthly revenue based on capacity hours and hourly rates.
|
|
*
|
|
* @group Capacity Planning
|
|
* @urlParam month string required The month in YYYY-MM format. Example: 2026-02
|
|
* @response {
|
|
* "month": "2026-02",
|
|
* "possible_revenue": 21500.25
|
|
* }
|
|
*/
|
|
public function revenue(Request $request): JsonResponse
|
|
{
|
|
$data = $request->validate([
|
|
'month' => 'required|date_format:Y-m',
|
|
]);
|
|
|
|
$revenue = $this->capacityService->calculatePossibleRevenue($data['month']);
|
|
|
|
return response()->json([
|
|
'month' => $data['month'],
|
|
'possible_revenue' => $revenue,
|
|
]);
|
|
}
|
|
}
|