How aryan-tembhurne5xx5/house-help-hub works
House Help Hub connects households seeking daily services with registered helpers, supporting booking updates, worker onboarding, and location-based discovery/tracking. The main user flow runs from role-aware web routes through booking and nearby-worker screens, the API/GraphQL client, and backend resolvers to MySQL. Separate worker and admin workflows cover service setup and platform management. The README documents map tracking, radius filtering, recommendations, and geocoding; their detailed implementation is not present in the supplied tree. Backend and several page links are limited to the SOURCE INDEX and documented capabilities.
Main entry points: index.js Resolver registry · App.tsx Role routes · api.ts API operations · server.js GraphQL server
Components 32
Web application
- Role routes
src/App.tsx - Authentication
src/pages/Auth.tsx - Session utilities
src/utils/auth.ts - Shared layout
src/components/Layout.tsx
Booking and location
- Book service
src/pages/user/BookService.tsx - Nearby workers
src/pages/user/NearbyWorkers.tsx - Map selection
src/components/MapPicker.tsx - Location utilities
src/utils/location.ts - Date utilities
src/utils/dateUtils.ts - Booking resolvers
backend/graphql/resolvers/booking.resolvers.js - Location calculations
backend/utils/location.js
API and backend
- API operations
src/utils/api.ts - GraphQL operations
src/graphql/queries.ts - GraphQL mutations
src/graphql/mutations.ts - Apollo client
src/lib/apolloClient.ts - GraphQL server
backend/server.js - GraphQL schema
backend/graphql/schema.js - Resolver registry
backend/graphql/resolvers/index.js - Auth resolvers
backend/graphql/resolvers/auth.resolvers.js - Auth middleware
backend/middleware/auth.js - Permissions
backend/middleware/permissions.js - Database connection
backend/db.js
Platform operations
- Worker setup
src/pages/worker/SetupServices.tsx - Worker administration
src/pages/admin/WorkersList.tsx - Worker resolvers
backend/graphql/resolvers/worker.resolvers.js - Admin resolvers
backend/graphql/resolvers/admin.resolvers.js - Notifications
backend/graphql/resolvers/notification.resolvers.js - Reviews
backend/graphql/resolvers/review.resolvers.js
Other components
- Household
- Helper
- Administrator
- MySQL
Connections 34
- Household → Role routes: uses
src/App.tsx - Helper → Role routes: uses
src/App.tsx - Administrator → Role routes: uses
src/App.tsx - Role routes → Authentication: routes to
src/App.tsx - Role routes → Book service: routes to
src/App.tsx - Role routes → Worker setup: routes to
src/App.tsx - Role routes → Worker administration: routes to
src/App.tsx - Authentication → Session utilities: uses
src/pages/Auth.tsx - Book service → Shared layout: renders
src/pages/user/BookService.tsx - Book service → API operations: requests services
src/pages/user/BookService.tsx - Book service → Map selection: uses
src/pages/user/BookService.tsx - Nearby workers → API operations: searches workers
src/pages/user/NearbyWorkers.tsx - Map selection → Location utilities: uses
src/components/MapPicker.tsx - Worker setup → API operations: registers services
src/pages/worker/SetupServices.tsx - Worker setup → Shared layout: renders
src/pages/worker/SetupServices.tsx - Worker administration → API operations: manages workers
src/pages/admin/WorkersList.tsx - API operations → Apollo client: queries and mutates
src/utils/api.ts - API operations → GraphQL operations: uses queries
src/utils/api.ts - API operations → GraphQL mutations: uses mutations
src/utils/api.ts - Apollo client → GraphQL server: sends GraphQL
- GraphQL server → GraphQL schema: loads schema
backend/server.js - GraphQL server → Resolver registry: loads resolvers
backend/server.js - GraphQL server → Database connection: uses connection
backend/server.js - GraphQL server → Auth middleware: uses middleware
backend/server.js - Database connection → MySQL: connects
- Resolver registry → Booking resolvers: dispatches
- Resolver registry → Auth resolvers: dispatches
- Resolver registry → Worker resolvers: dispatches
- Resolver registry → Admin resolvers: dispatches
- Resolver registry → Notifications: dispatches
- Resolver registry → Reviews: dispatches
- Worker resolvers → Location calculations: uses
backend/graphql/resolvers/worker.resolvers.js - Auth resolvers → Auth middleware: uses
backend/graphql/resolvers/auth.resolvers.js - Reviews → Permissions: uses
backend/graphql/resolvers/review.resolvers.js