Portals Overview

SaaniCare consists of multiple portals, each designed for specific user roles and responsibilities.

Core Portals

Parent Portal (parent-web, parent-mobile)

• Purpose: For parents to track children’s learning progress
• Users: PARENT role
• Platforms: Web and Mobile (iOS/Android)
• Key Features: Activity tracking, progress reports, communication with teachers

Teacher Portal (teacher-web, teacher-mobile)

• Purpose: For teachers to manage classrooms and student progress
• Users: TEACHER, ASSISTANT_TEACHER, SUBSTITUTE_TEACHER, SUBJECT_COORDINATOR roles
• Platforms: Web and Mobile (iPad)
• Key Features: Classroom management, lesson planning, student tracking

Admin Portal (admin-web)

• Purpose: For school administrators to manage school operations
• Users: ADMIN, VICE_PRINCIPAL, CURRICULUM_COORDINATOR roles
• Platforms: Web (primary), iPad
• Key Features: School management, user administration, reports, billing

Child Portal (child-web)

• Purpose: Child-friendly interface for students
• Users: CHILD role
• Platforms: Web
• Key Features: View activities, complete tasks, track progress

District & System Portals

School District Portal (school-district-web)

• Purpose: District-wide management and coordination
• Users: DISTRICT_ADMIN role
• Platforms: Web
• Key Features: Multi-school management, district-wide sessions, analytics

Superadmin Portal (superadmin-web)

• Purpose: System-wide administration
• Users: SUPERADMIN role
• Platforms: Web
• Key Features: Platform management, all-school oversight, system configuration

Financial & Administrative Portals

Accountant Portal (accountant-web)

• Purpose: Financial management and accounting
• Users: ACCOUNTANT, BURSAR roles
• Platforms: Web
• Key Features: Financial reports, billing, payments, accounting integration

Registrar Portal (registrar-web)

• Purpose: Student enrollment and registration
• Users: REGISTRAR role
• Platforms: Web
• Key Features: Enrollment management, transcripts, student records

Health & Support Portals

Health & Counselor Portal (health-counselor-web)

• Purpose: Combined health and counseling services
• Users: NURSE, COUNSELOR, HEALTH_COORDINATOR, SPECIAL_EDUCATION_COORDINATOR roles
• Platforms: Web
• Key Features: Health records, medication management, counseling sessions, IEP management

Childcare Specialist Portal (childcare-specialist-web)

• Purpose: Child development consultations
• Users: CHILDCARE_SPECIALIST role
• Platforms: Web
• Key Features: Appointment scheduling, consultation notes, development reviews

Operational Portals

Transportation Portal (transportation-web)

• Purpose: School transportation management
• Users: TRANSPORTATION_COORDINATOR role
• Platforms: Web (with mobile coordination)
• Key Features: Route management, driver assignments, fleet management

Librarian Portal (librarian-web)

• Purpose: Library resource management
• Users: LIBRARIAN role
• Platforms: Web
• Key Features: Book inventory, checkouts, reading programs

Receptionist Portal (receptionist-web)

• Purpose: Front desk operations
• Users: RECEPTIONIST role
• Platforms: Web
• Key Features: Visitor management, appointment scheduling, inquiries

Cafeteria Portal (cafeteria-web)

• Purpose: Meal planning and cafeteria management
• Users: CAFETERIA_MANAGER role
• Platforms: Web
• Key Features: Meal planning, orders, dietary management, inventory

IT Coordinator Portal (it-coordinator-web)

• Purpose: Technology and user management
• Users: IT_COORDINATOR role
• Platforms: Web
• Key Features: User accounts, support tickets, device management

Facilities Portal (facilities-web)

• Purpose: Building and facility management
• Users: FACILITIES_MANAGER role
• Platforms: Web
• Key Features: Maintenance requests, facility management, vendor coordination

Mobile Apps

Driver Mobile (driver-mobile)

• Purpose: Bus route management for drivers
• Users: DRIVER role
• Platforms: Mobile (iOS/Android)
• Key Features: Route viewing, attendance, incident reporting

Security Mobile (security-mobile)

• Purpose: Security and visitor management
• Users: SECURITY_GUARD role
• Platforms: Mobile (iOS/Android)
• Key Features: Visitor check-in, incident reporting, access control

Other Applications

API (api)

• Purpose: Backend API server
• Platforms: Serverless (Vercel)
• Key Features: RESTful API, authentication, data management

Frontpage Web (frontpage-web)

• Purpose: Marketing and landing pages
• Platforms: Web
• Key Features: Public website, marketing content

Docs Web (docs-web)

• Purpose: Documentation website
• Platforms: Web
• Key Features: Project documentation, user guides, API reference

Portal Architecture

Shared Components

• All portals use shared @saanicare/ui-web component library
• Consistent design system and styling
• Shared authentication via Auth0
• Common API client (@saanicare/api-client)

Multi-Tenancy

• All portals support school-based multi-tenancy
• Data isolation by school ID
• District-level management for district portals

Deployment

• All web portals deploy to Vercel
• Mobile apps deploy to app stores
• API deploys to Vercel serverless functions

Portal Access

Each portal is accessible via its subdomain:

• parent.saanicare.dev - Parent Portal
• teacher.saanicare.dev - Teacher Portal
• schooladmin.saanicare.dev - Admin Portal
• accountant.saanicare.dev - Accountant Portal
• health.saanicare.dev - Health & Counselor Portal
• childcare.saanicare.dev - Childcare Specialist Portal
• registrar.saanicare.dev - Registrar Portal
• transportation.saanicare.dev - Transportation Portal
• librarian.saanicare.dev - Librarian Portal
• receptionist.saanicare.dev - Receptionist Portal
• cafeteria.saanicare.dev - Cafeteria Portal
• it.saanicare.dev - IT Coordinator Portal
• facilities.saanicare.dev - Facilities Portal
• driver.saanicare.dev - Driver Portal
• security.saanicare.dev - Security Portal
• docs.saanicare.dev - Documentation