How gikeeeeeee/cs361_g06 works
Smart Faculty Navigator is a read-only campus place-information app: users discover buildings, inspect floors and plans, then look up rooms or facilities. The frontend routes pages and loads domain data through a campus-service abstraction; the backend routes API requests to use cases and an S3-backed data source. The README also describes bilingual place details and external map integration. Some frontend components and service implementations were not excerpted, so uncertain links are omitted; the service selector is explicitly configured to use mock data.
Main entry points: handler.py Request router · App.tsx Route application · floor_service.py Floor use case · index.ts Campus service selector
Components 32
Place discovery
- Route application
frontend/src/App.tsx - Home page
frontend/src/pages/HomePage.tsx - Campus map UI
frontend/src/features/homepage/components/CampusMapContainer.tsx - Map filtering
frontend/src/features/homepage/hooks/useMapFilter.ts - Directory types
frontend/src/features/homepage/types/mapDirectory.types.ts
Place details
- Building page
frontend/src/pages/BuildingDetailPage.tsx - Building details UI
frontend/src/features/building-info/components/BuildingHero.tsx - Building loader
frontend/src/features/building-info/hooks/useBuildingDetails.ts - Floor plan viewer
frontend/src/features/floor-viewer/components/FloorPlanContainer.tsx - Room page
frontend/src/pages/RoomDetailPage.tsx - Room detail UI
frontend/src/features/room-detail/components/RoomHero.tsx - Room loader
frontend/src/features/room-detail/hooks/useRoomDetail.ts - Facility page
frontend/src/pages/FacilityDetailPage.tsx - Facility loader
frontend/src/features/room-detail/hooks/useFacilityDetail.ts
Frontend data
- Campus service selector
frontend/src/services/index.ts - Campus API adapter
frontend/src/services/campus.api.ts - HTTP client
frontend/src/services/api/apiClient.ts - API contracts
frontend/src/shared/types/api.contracts.ts
Backend API
- Request router
backend/handler.py - Building use case
backend/services/building_service.py - Floor use case
backend/services/floor_service.py - Room use case
backend/services/room_service.py - Facility use case
backend/services/facility_service.py - Building model
backend/models/building.py - Floor model
backend/models/floor.py - Room model
backend/models/room.py - Facility model
backend/models/facility.py
Data access
- Building data port
backend/ports/building_source.py - S3 repository
backend/repositories/building_repository.py
Other components
- Campus user
- Map service
- Amazon S3
Connections 37
- Campus user → Route application: opens
frontend/src/App.tsx - Route application → Home page: routes to
frontend/src/App.tsx - Route application → Building page: routes to
frontend/src/App.tsx - Route application → Room page: routes to
frontend/src/App.tsx - Route application → Facility page: routes to
frontend/src/App.tsx - Home page → Campus map UI: renders
frontend/src/pages/HomePage.tsx - Home page → Map filtering: uses
frontend/src/pages/HomePage.tsx - Map filtering → Campus service selector: queries
frontend/src/features/homepage/hooks/useMapFilter.ts - Map filtering → Directory types: uses types
frontend/src/features/homepage/hooks/useMapFilter.ts - Map service → Campus map UI: map integration
README.md - Building page → Building loader: loads data
frontend/src/pages/BuildingDetailPage.tsx - Building page → Building details UI: renders
frontend/src/pages/BuildingDetailPage.tsx - Building loader → Campus service selector: fetches building and floor
frontend/src/features/building-info/hooks/useBuildingDetails.ts - Building page → Floor plan viewer: floor plan display
- Room page → Room loader: loads data
frontend/src/pages/RoomDetailPage.tsx - Room page → Room detail UI: renders
frontend/src/pages/RoomDetailPage.tsx - Room loader → Campus service selector: fetches room
frontend/src/features/room-detail/hooks/useRoomDetail.ts - Facility page → Facility loader: loads data
frontend/src/pages/FacilityDetailPage.tsx - Facility loader → Campus service selector: fetches facility
frontend/src/features/room-detail/hooks/useFacilityDetail.ts - Campus service selector → Campus API adapter: selects adapter
frontend/src/services/index.ts - Campus API adapter → HTTP client: HTTP requests
- HTTP client → API contracts: returns typed data
- Request router → Building use case: dispatches building routes
backend/handler.py - Request router → Floor use case: dispatches floor routes
backend/handler.py - Request router → Room use case: dispatches room routes
backend/handler.py - Request router → Facility use case: dispatches facility routes
backend/handler.py - Request router → S3 repository: wires source
backend/handler.py - Building use case → Building data port: reads data
backend/services/building_service.py - Floor use case → Building data port: reads floor and plan
backend/services/floor_service.py - Floor use case → Floor model: locates floor
backend/services/floor_service.py - Floor use case → Room model: projects room pins
backend/services/floor_service.py - Floor use case → Facility model: projects facility pins
backend/services/floor_service.py - Room use case → Building data port: reads building data
backend/services/room_service.py - Room use case → Room model: finds room
backend/services/room_service.py - Facility use case → Building data port: reads data and plan URL
backend/services/facility_service.py - Facility use case → Facility model: finds facility
backend/services/facility_service.py - S3 repository → Amazon S3: reads JSON and signs URLs
backend/repositories/building_repository.py