feat: Implement GraphQL API with optimized dashboard queries
Implemented complete GraphQL API with Apollo Server for efficient data fetching:
Backend Changes:
- Installed @nestjs/graphql@13.2.0, @nestjs/apollo@13.2.1, graphql@16.11.0, dataloader@2.2.3
- Configured Apollo Server with auto schema generation (src/schema.gql)
- GraphQL Playground enabled in non-production environments
- JWT authentication via GqlAuthGuard
- Custom error formatting
GraphQL Types (src/graphql/types/):
- UserType with family relationships
- ChildType with birthDate, gender, photoUrl
- FamilyMemberType with role and user relation
- ActivityGQLType with startedAt, endedAt, metadata
- DashboardType aggregating all dashboard data
- DailySummaryType with activity counts and totals
- Enum types: ActivityType, FamilyRole, Gender, FeedingMethod, DiaperType
Dashboard Resolver (src/graphql/resolvers/dashboard.resolver.ts):
- Query: dashboard(childId?: ID) returns DashboardType
- Single optimized query replacing 4+ REST API calls:
* GET /api/v1/children
* GET /api/v1/tracking/child/:id/recent
* GET /api/v1/tracking/child/:id/summary/today
* GET /api/v1/families/:id/members
- Aggregates children, activities, family members, summaries in one query
- ResolveField decorators for child and logger relations
- Calculates daily summary (feeding, sleep, diaper, medication counts)
- Uses Between for date range filtering
- Handles metadata extraction for activity details
DataLoader Implementation (src/graphql/dataloaders/):
- ChildDataLoader: batchChildren, batchChildrenByFamily
- UserDataLoader: batchUsers
- REQUEST scope for per-request instance
- Prevents N+1 query problem when resolving relations
- Uses TypeORM In() for batch loading
GraphQL Module (src/graphql/graphql.module.ts):
- Exports ChildDataLoader and UserDataLoader
- TypeORM integration with Child, Activity, FamilyMember, User entities
- DashboardResolver provider
Example Queries (src/graphql/example-queries.gql):
- GetDashboard with childId parameter
- GetDashboardAllChildren for listing
- Documented usage and expected results
Files Created (11 total):
- src/graphql/types/ (5 files)
- src/graphql/dataloaders/ (2 files)
- src/graphql/resolvers/ (1 file)
- src/graphql/guards/ (1 file)
- src/graphql/graphql.module.ts
- src/graphql/example-queries.gql
Performance Improvements:
- Dashboard load reduced from 4+ REST calls to 1 GraphQL query
- DataLoader batching eliminates N+1 queries
- Client can request only needed fields
- Reduced network overhead and latency
Usage:
- Endpoint: http://localhost:3020/graphql
- Playground: http://localhost:3020/graphql (dev only)
- Authentication: JWT token in Authorization header
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Andrei
b695c2b9c1