How jetychodipilli/v2_brainserve_connect_gstack works
BrainServe Connect manages visitor appointments and physical access, alongside employee administration and operational records. The main journey runs from public booking and tracking through host decisions, reception check-in with badge allocation, security visibility, and reception checkout. The React frontend reaches the Spring controllers through its API client; backend application services coordinate domain work, persistence, audit, and transactional outbox events. The README documents additional dashboards, availability, compensation, identity and organization capabilities. Sampled service excerpts support several cross-domain calls; other documented subsystem wiring is not inferred.
Main entry points: AppointmentService.java Appointment workflow · ReceptionService.java Reception access · EmployeeService.java Employee service · client.ts API client
Components 27
Public experience
- Frontend routing
frontend/src/App.tsx - Booking page
frontend/src/pages/BookingPage.tsx - Tracking page
frontend/src/pages/TrackPage.tsx - Role dashboards
frontend/src/pages/DashboardPage.tsx - API client
frontend/src/api/client.ts - Auth state
frontend/src/state/auth.tsx
Visits and operations
- Appointment API
backend/src/main/java/com/brainserve/appointment/appointment/api/AppointmentController.java - Appointment workflow
backend/src/main/java/com/brainserve/appointment/appointment/application/AppointmentService.java - Appointment records
backend/src/main/java/com/brainserve/appointment/appointment/infrastructure/AppointmentRepository.java - Visitor records
backend/src/main/java/com/brainserve/appointment/visitor/application/VisitorService.java - Reception access
backend/src/main/java/com/brainserve/appointment/reception/application/ReceptionService.java - Access and badges
backend/src/main/java/com/brainserve/appointment/reception/infrastructure - Availability
backend/src/main/java/com/brainserve/appointment/availability/application/AvailabilityService.java
Workforce administration
- Employee service
backend/src/main/java/com/brainserve/appointment/employee/application/EmployeeService.java - Employee endpoints
backend/src/main/java/com/brainserve/appointment/employee/api - Organization setup
backend/src/main/java/com/brainserve/appointment/organization/application/OrganizationService.java - Compensation
backend/src/main/java/com/brainserve/appointment/compensation/application/CompensationService.java
Identity and shared services
- Authentication and roles
backend/src/main/java/com/brainserve/appointment/iam/application - Auth endpoints
backend/src/main/java/com/brainserve/appointment/iam/api/AuthController.java - Audit logging
backend/src/main/java/com/brainserve/appointment/shared/audit/AuditService.java - Audit records
backend/src/main/java/com/brainserve/appointment/shared/audit/AuditRepository.java - Event outbox
backend/src/main/java/com/brainserve/appointment/notification/application/OutboxService.java - Outbox records
backend/src/main/java/com/brainserve/appointment/notification/infrastructure/OutboxRepository.java - Dashboards and emergency list
backend/src/main/java/com/brainserve/appointment/reporting/api
Other components
- Visitor
- Host and staff
- Security
Connections 42
- Visitor → Frontend routing: uses
- Frontend routing → Booking page: routes
- Frontend routing → Tracking page: routes
- Host and staff → Frontend routing: uses
- Security → Role dashboards: views
- Booking page → API client: submits booking
- Tracking page → API client: requests status
- Role dashboards → API client: requests operations
- API client → Appointment API: calls
- Appointment API → Appointment workflow: dispatches
- Appointment workflow → Appointment records: reads and writes
- Appointment workflow → Visitor records: registers visitor
- Appointment workflow → Employee service: checks host
- Appointment workflow → Audit logging: records decisions
- Appointment workflow → Event outbox: publishes events
- Appointment workflow → Availability: checks slot
- Availability → Appointment records: checks bookings
- Host and staff → Reception access: checks in and out
- Reception access → Appointment workflow: validates access
- Reception access → Visitor records: verifies visitor
- Reception access → Employee service: looks up host
- Reception access → Access and badges: allocates badge and records visit
- Reception access → Audit logging: records transitions
- Reception access → Event outbox: publishes events
- Employee endpoints → Employee service: dispatches
- Employee service → Organization setup: validates assignment
- Employee service → Audit logging: records changes
- Employee service → Event outbox: publishes events
- Host and staff → Availability: manages slots
- Host and staff → Organization setup: manages structure
- Host and staff → Compensation: manages compensation
- API client → Auth endpoints: calls
- Auth endpoints → Authentication and roles: dispatches
- Auth state → API client: uses session API
- Authentication and roles → Audit logging: records security actions
- Compensation → Employee service: validates employee
- Compensation → Audit logging: records access and decisions
- Compensation → Event outbox: publishes events
- Audit logging → Audit records: persists
- Event outbox → Outbox records: persists events
- Role dashboards → Dashboards and emergency list: requests dashboards
- Dashboards and emergency list → Access and badges: reads access records