How chis132060/connectguidance works
GuidanceConnect is a role-based counseling management application. Students book or cancel appointments and submit wellness check-ins; counselors manage appointments and encrypted case notes; receptionists book walk-ins; administrators manage users, analytics, audits, and exports. Django role-specific views handle requests and delegate business operations to services backed by shared domain models. The README documents these capabilities, while source excerpts and the SOURCE INDEX support the specific service-call relationships shown. Some subsystems are represented by their exact enclosing directory because their implementation was not excerpted.
Main entry points: appointments.py Appointment Lifecycle · student.py Student Routes · admin_views.py Admin Routes · models.py Guidance Domain Models
Components 27
Access and Roles
- Authentication
core/views/auth.py - Input Forms
core/forms.py - Role Guards
core/guards.py
Appointments
- Student Routes
core/views/student.py - Counselor Routes
core/views/counselor.py - Reception Routes
core/views/receptionist.py - Slot Availability
core/services/slots.py - Appointment Lifecycle
core/services/appointments.py - Walk-in Booking
core/services/receptionist.py
Counseling and Wellness
- Mood Check-ins
core/services/mood.py - Chat Endpoint
core/views/chat.py - AI Chat and Safety
core/services/chat.py - Encrypted Case Notes
core/services/case_notes.py - Note Encryption
core/services/encryption.py
Administration
- Admin Routes
core/views/admin_views.py - User Safeguards
core/services/admin_users.py - Executive Metrics
core/services/metrics.py - Reports and Exports
core/services/reports.py - Audit Logging
core/services/audit.py
Domain Data
- Guidance Domain Models
core/models.py - Relational Database
- Domain Choices
core/choices.py
Other components
- Student
- Counselor
- Receptionist
- Administrator
- LLM Providers
Connections 35
- Student → Authentication: signs in
README.md - Student → Student Routes: uses
README.md - Counselor → Counselor Routes: uses
README.md - Receptionist → Reception Routes: uses
README.md - Administrator → Admin Routes: uses
README.md - Authentication → Input Forms: validates registration
core/views/auth.py - Student Routes → Role Guards: enforces role
core/views/student.py - Counselor Routes → Role Guards: enforces role
core/views/counselor.py - Reception Routes → Role Guards: enforces role
core/views/receptionist.py - Admin Routes → Role Guards: enforces role
core/views/admin_views.py - Student Routes → Appointment Lifecycle: books or cancels
core/views/student.py - Student Routes → Slot Availability: requests availability
core/views/student.py - Appointment Lifecycle → Slot Availability: checks conflicts
core/services/appointments.py - Reception Routes → Walk-in Booking: requests walk-in booking
core/views/receptionist.py - Walk-in Booking → Appointment Lifecycle: books appointment
core/services/receptionist.py - Walk-in Booking → Slot Availability: finds next slot
core/services/receptionist.py - Student Routes → Mood Check-ins: processes check-in
core/views/student.py - Chat Endpoint → AI Chat and Safety: streams chat
core/views/chat.py - AI Chat and Safety → LLM Providers: streams completion
core/services/chat.py - Counselor Routes → Appointment Lifecycle: updates status
core/views/counselor.py - Counselor Routes → Encrypted Case Notes: manages notes
core/views/counselor.py - Encrypted Case Notes → Note Encryption: encrypts content
core/services/case_notes.py - Admin Routes → User Safeguards: manages accounts
core/views/admin_views.py - Admin Routes → Executive Metrics: loads analytics
core/views/admin_views.py - Admin Routes → Reports and Exports: generates exports
core/views/admin_views.py - Reports and Exports → Executive Metrics: uses analytics
core/services/reports.py - Appointment Lifecycle → Audit Logging: records actions
core/services/appointments.py - Encrypted Case Notes → Audit Logging: records actions
core/services/case_notes.py - User Safeguards → Audit Logging: records changes
core/services/admin_users.py - Reports and Exports → Audit Logging: records exports
core/services/reports.py - Guidance Domain Models → Relational Database: persists domain data
README.md - Appointment Lifecycle → Guidance Domain Models: reads and writes
core/services/appointments.py - Slot Availability → Guidance Domain Models: reads appointments
core/services/slots.py - Audit Logging → Guidance Domain Models: writes audit entries
core/services/audit.py - Guidance Domain Models → Domain Choices: defines field values
core/models.py