Parlami: Online Therapy Platform

Overview

Parlami is a comprehensive online therapy platform that connects adults and children with licensed psychologists for secure video therapy sessions. The platform handles the complete therapy journey from initial assessment through booking, payment, and conducting video sessions, all while managing complex family relationships and ensuring data privacy.

The Challenge

Mental health services face significant barriers to access, especially for families seeking therapy for children. Traditional therapy requires physical appointments, making it difficult for busy families or those in remote areas. Additionally, the industry needed a solution that could:

Provide secure, HIPAA-compliant video conferencing for therapy sessions
Handle complex family dynamics where parents manage their children's accounts
Process payments through a credit-based system that's transparent and flexible
Support multiple languages and timezones for international users
Ensure proper consent and legal compliance for minors
Match patients with appropriate psychologists based on detailed assessments
Send automated reminders to reduce no-shows

Key Features

1. Role-Based Multi-Portal Architecture

Instead of a one-size-fits-all interface, Parlami features distinct portals for each user type.

Four Specialized Portals:

Adult Portal: Full account management, family member management, booking for self or children
Child Portal: Age-appropriate interface with limited access, supervised by parents
Psychologist Portal: Availability management, appointment handling, patient notes, document uploads
Admin Portal: User management, questionnaire configuration, platform oversight

What this means for users: Each portal has its own dashboard, navigation, and features tailored to that role's needs. Users only see what's relevant to them, reducing confusion and improving security. Parents get full control, children get age-appropriate access, psychologists get professional tools, and admins get oversight capabilities.

2. Family Account Management

One of the most complex features is the parent-child relationship system that handles real-world family dynamics.

Unified Family Accounts:

Parents can create and manage accounts for their children from a single login
Smart notification routing: When a parent books for a child, all notifications go to the parent's email
Separate therapy spaces: Each child has their own therapy history and psychologist relationship
Privacy controls: Children can have private sessions while parents retain administrative control

What this means for users: Families need multiple therapy services but don't want to manage multiple accounts and payment methods. Parents can manage their entire family's therapy from one account, use one payment method for everyone, and receive all notifications in one place—while each family member maintains their own therapeutic relationship.

3. Credit-Based Billing System

Instead of traditional per-session payments, Parlami implements a flexible credit system that's transparent and user-friendly.

How It Works:

Users purchase credit packages through Stripe (e.g., 5 sessions, 10 sessions, 20 sessions)
Each therapy session costs 1 credit
Credits are deducted when booking is confirmed
Automatic refunds if psychologist rejects or user cancels with proper notice

Smart Features:

First Session Free: New users can book one free session to try the platform
Idempotent Transactions: Webhook-based system prevents duplicate charges even if Stripe sends multiple notifications
Transparent Ledger: Complete audit trail of all credit transactions (purchases, bookings, refunds)
Family Sharing: Parents' credits can be used for any family member's sessions

What this means for users: No surprise charges or complicated billing. Buy credits upfront, use them for any family member, and see exactly where each credit goes. Try the platform risk-free with a free first session. If appointments are cancelled or rejected, credits are automatically refunded—no need to contact support.

4. Secure Video Conferencing

Built-in video therapy sessions with professional-grade features designed specifically for mental health services.

Professional Video Features:

Just-In-Time Room Creation: Video rooms are created automatically when appointments start
15-Minute Buffer: Participants can join 15 minutes early to test their setup
Automatic Cleanup: Rooms are deleted after sessions end to ensure privacy
Role-Based Permissions: Psychologists have host controls, patients are participants
Session Recording: Optional recording capability for clinical documentation
Network Quality Indicators: Real-time feedback on connection quality

What this means for users: No need for third-party video tools or sharing meeting links. Everything happens within the platform with secure authentication. Join early to test your camera and microphone. Sessions are automatically cleaned up for privacy. Psychologists can record sessions for clinical notes when needed.

5. Automated Appointment Reminder System

To reduce no-shows and improve attendance, Parlami features a comprehensive automated reminder system.

Smart Reminders:

Multiple Reminder Intervals: Configurable reminders (default: 24 hours and 1 hour before)
Smart Recipient Logic: Respects family relationships (sends to parent when booking for child)
Reliable Delivery: All emails are sent via background jobs for reliability
Both Parties Notified: Both psychologist and patient receive reminders

What this means for users: Never miss an appointment with automatic reminders sent at the right time. Parents receive reminders for their children's appointments. Psychologists are reminded of upcoming sessions. The system runs automatically in the background, ensuring reliable delivery even during high traffic.

6. Multi-Language Support

Full internationalization with Italian as the primary language, designed for global expansion.

Complete Localization:

Complete Translation System: Every label, message, and notification is translatable
Language Persistence: User's language choice is remembered across sessions
Admin-Configurable Content: Questionnaires and system messages can be managed in multiple languages
Email Localization: All automated emails respect the recipient's language preference

What this means for users: Use the platform in your preferred language with all content properly translated. Your language choice is remembered across devices. Receive emails in your language. Administrators can easily add new languages or update translations without code changes.

7. Comprehensive Assessment System

Detailed questionnaires help match patients with appropriate psychologists and inform treatment approaches.

Assessment Features:

Role-Specific Questionnaires: Different assessments for adults vs. children
Admin-Configurable: Questions can be added, edited, or removed without code changes
Multi-Language Support: Questionnaires available in all supported languages
Data-Driven Matching: Responses help administrators match patients with suitable psychologists

What this means for users: Complete a thorough assessment that helps find the right psychologist for your needs. Questions are appropriate for your age and situation. Your responses inform your treatment plan and help psychologists understand your needs before the first session.

8. Psychologist Availability Management

Psychologists have full control over their schedules with an intuitive availability management system.

Scheduling Features:

Flexible Availability: Set recurring weekly availability or one-time slots
Easy Updates: Modify availability anytime with immediate effect
Automatic Booking Prevention: System prevents double-booking automatically
Timezone Support: Availability displays correctly for patients in different timezones

What this means for users: Psychologists set their schedule once and the system handles bookings automatically. No manual coordination needed. Patients see available times in their own timezone. The system prevents conflicts and double-bookings automatically.

9. Secure Authentication & Access Control

Robust security system protecting sensitive mental health data with role-based permissions.

Security Features:

Secure Authentication: Industry-standard authentication with automatic session expiration
Role-Based Access Control: Users can only access features appropriate for their role
Encrypted Password Storage: Passwords are never stored in plain text
Audit Logging: Sensitive operations are logged for security and compliance
Terms & Conditions Tracking: Legal acceptance is tracked and timestamped

What this means for users: Your sensitive mental health data is protected with industry-standard security. Each user type has appropriate access—children can't access parent features, patients can't see psychologist tools. All sensitive operations are logged for accountability and compliance.

10. Admin Dashboard & Platform Management

Comprehensive administrative interface for platform oversight and configuration.

Admin Capabilities:

User Management: View, edit, and manage all user accounts
Questionnaire Configuration: Create and modify assessment questionnaires
Appointment Oversight: Monitor bookings, cancellations, and attendance
Platform Analytics: Track usage, revenue, and key metrics
Content Management: Update system messages and notifications

What this means for users: The platform is professionally managed with oversight of all operations. Administrators can quickly resolve issues, update content, and monitor platform health. Configuration changes happen instantly without requiring code deployments.

How It Works (Simplified)

Using Parlami is straightforward:

Sign Up & Assess: Create an account and complete an initial assessment questionnaire.
Purchase Credits: Buy a credit package that fits your needs (first session is free).
Find a Psychologist: Browse available psychologists or get matched based on your assessment.
Book Sessions: Select available time slots and book appointments using your credits.
Receive Reminders: Get automatic email reminders 24 hours and 1 hour before your session.
Join Video Session: Click the join button when it's time—video room is ready and waiting.
Continue Care: Book follow-up sessions, manage your family's appointments, and track your therapy journey.

The technology handles all the complexity—scheduling, payments, reminders, video setup, and notifications. You focus on your mental health; the platform handles everything else.

Use Cases

Family Therapy Management

Scenario: A parent needs therapy for themselves and two children, but managing multiple accounts and payment methods is overwhelming.

How Parlami Helps: Create one account, add children as family members, purchase credits once, and use them for any family member. Receive all notifications in one place. Manage everyone's appointments from a single dashboard. Each family member maintains their own therapeutic relationship while the parent handles logistics.

Remote Mental Health Access

Scenario: Patients in rural areas or with mobility issues struggle to access quality mental health services.

How Parlami Helps: Connect with licensed psychologists from anywhere with an internet connection. No travel required. Sessions happen in the comfort of your home. Timezone support means you can even work with psychologists in different regions.

Reducing No-Shows

Scenario: Psychologists lose revenue and patients miss important sessions due to forgotten appointments.

How Parlami Helps: Automated reminders sent to both parties at 24 hours and 1 hour before sessions. Smart routing ensures parents receive reminders for children's appointments. Reliable background job system ensures reminders are always delivered.

Trying Therapy Risk-Free

Scenario: People hesitant to try therapy due to cost or uncertainty about the process.

How Parlami Helps: First session is completely free—no credit card required upfront. Try the platform, meet a psychologist, and experience a session before committing. If it's not for you, you haven't spent anything.

International Therapy Services

Scenario: Expats or international users need therapy in their native language with proper timezone handling.

How Parlami Helps: Multi-language support with Italian primary. Timezone-aware scheduling ensures appointments display correctly regardless of location. Psychologists can serve international clients without coordination headaches.

Benefits

For Patients

Convenient Access: Receive therapy from anywhere with an internet connection
Family Management: Manage entire family's therapy from one account
Transparent Pricing: Credit-based system with clear costs and no hidden fees
Risk-Free Trial: First session free to try before committing
Never Miss Sessions: Automatic reminders with timezone-aware scheduling
Secure & Private: HIPAA-compliant video conferencing and data protection

For Psychologists

Flexible Scheduling: Set availability once, system handles bookings automatically
Reduced No-Shows: Automated reminders improve attendance rates
Professional Tools: Built-in video conferencing, patient notes, document management
Fair Compensation: Automatic payment processing, no chasing invoices
Focus on Care: Less administrative work, more time for patients
Global Reach: Serve patients anywhere with timezone support

For Administrators

Efficient Matching: Use assessment data to pair patients with suitable psychologists
Platform Oversight: Monitor appointments, manage users, configure system settings
Data Insights: Track platform usage, appointment statistics, revenue metrics
Easy Configuration: Update questionnaires, messages, and settings without code changes
Compliance Tools: Audit logging, consent tracking, data protection features

Technology Highlights

Parlami leverages modern web technologies for reliability and performance:

Vertical Slice Architecture: Each feature is self-contained with backend, API, and frontend components
Smart Credit Ledger: Complete transaction tracking with metadata for full financial transparency
Family Relationship Logic: Sophisticated database design handling complex parent-child relationships
Idempotent Payment Processing: Webhook-based Stripe integration preventing duplicate charges
Background Job System: Reliable email delivery and automated tasks using queued jobs
Role-Based Access Control: Granular permissions ensuring users only access appropriate features
Timezone Intelligence: Proper handling of appointments across different timezones
Type-Safe Frontend: TypeScript for maintainable, error-resistant code
Responsive Design: Mobile-first approach working seamlessly on all devices

Real-World Impact

The platform delivers measurable results:

User Roles: 4 distinct portals (Adult, Child, Psychologist, Admin)
Family Management: Unlimited children per parent account
Payment Integration: Full Stripe integration with webhook-based fulfillment
Video Sessions: Secure, HIPAA-compliant video conferencing
Automation: Automated reminders, refunds, and room management
Languages: Multi-language support with Italian primary
Global Support: Timezone handling for international users
Security: Role-based access control, audit logging, consent tracking

What This Demonstrates

This project showcases expertise in:

Complex System Design: Managing multiple user roles, family relationships, and payment flows
Healthcare Compliance: HIPAA compliance, legal consent, data privacy requirements
Third-Party Integration: Stripe payments, video conferencing, email services
User-Centered Design: Role-specific interfaces, intuitive workflows, accessibility
Reliability Engineering: Idempotent operations, queued jobs, comprehensive error handling
Business Logic: Conversion optimization, no-show reduction, transparent pricing
Maintainable Code: TypeScript for type safety, clear architecture, vertical slice organization
Technical Problem Solving: Timezone handling, family relationships, credit ledger system

Challenges Overcome

Global Timezone Support

Handling users across different timezones required careful coordination to ensure appointments display correctly for each user while preventing booking conflicts. Implemented timezone-aware scheduling that converts all times appropriately.

Payment Reliability

Ensuring users are never charged twice while handling various payment scenarios (successful payments, failed payments, refunds) required robust error handling and idempotent transaction management with Stripe webhooks.

Video Session Security

Ensuring only authorized participants can join therapy sessions required implementing secure access controls with time-limited permissions and role-based video room access.

Family Privacy Balance

Balancing parental oversight with child privacy required careful permission design. Parents can manage bookings and see appointment times, but therapy content remains confidential between child and psychologist.

Conclusion

Parlami represents a complete solution to making mental health services more accessible and manageable. By combining secure video conferencing, flexible payment systems, family account management, and intelligent automation, the platform serves the needs of patients, psychologists, and administrators equally well.

The system handles complex real-world requirements like timezone management, family relationships, payment processing, and legal compliance while maintaining a clean, intuitive user experience. The result is a professional-grade therapy platform that removes barriers to mental health care and makes therapy accessible to families anywhere in the world.

Every technical decision was made with consideration for security, reliability, user experience, and healthcare compliance, resulting in a production-ready platform that can scale to serve thousands of users while maintaining the highest standards of data protection and service quality.