How vishwa073/timelymeet works
TimelyMeet lets mentors configure availability and event types, then share public booking links; bookers select a slot and complete a free or paid appointment. The graph separates setup, public discovery/booking, meeting operations, and payment/payout handling, with Prisma as the shared persistence layer. README capabilities include calendar sync, payment status controls, and issue reporting. Some implementation details are unsampled, so only documented links are shown for those; sampled source confirms the checkout/webhook and availability paths.
Main entry points: prisma.js Application Database · events.js Event Services · page.jsx Public Event Page · route.js Checkout Session
Components 23
Mentor Setup
- Account Dashboard
app/(main)/dashboard/page.jsx - Availability Setup
app/(main)/availability/_components/availability-form.jsx - Availability Services
actions/availability.js - Event Management
components/event-form.jsx - Event Services
actions/events.js
Public Scheduling
- Public Profile
app/[username]/page.jsx - Public Event Page
app/[username]/[eventId]/page.jsx - Booking Form
app/[username]/[eventId]/_components/booking-form.jsx - Booking Services
actions/bookings.js
Meeting Operations
- Meeting Controls
app/(main)/meetings/_components/meeting-actions.jsx - Meeting Services
actions/meetings.js - Issue Reporting
app/booking/success/_components/report-booking-issue.jsx
Payments & Payouts
- Checkout Session
app/api/stripe/create-checkout-session/route.js - Payment Webhook
app/api/stripe/webhook/route.js - Stripe Connect
lib/stripe-connect.js
Shared Services
- Calendar Events
lib/calendar.js - Input Validation
app/lib/validators.js - Application Database
lib/prisma.js
Other components
- Mentor
- Booker
- Stripe API
- Google Calendar
- Clerk Authentication
Connections 33
- Mentor → Account Dashboard: manages account
- Mentor → Availability Setup: sets availability
- Availability Setup → Availability Services: loads and saves
app/(main)/availability/_components/availability-form.jsx - Availability Services → Application Database: reads and writes
actions/availability.js - Mentor → Event Management: creates events
- Event Management → Event Services: submits events
components/event-form.jsx - Event Services → Input Validation: validates input
actions/events.js - Event Services → Application Database: reads and writes
actions/events.js - Booker → Public Profile: browses events
- Public Profile → Event Services: loads public events
app/[username]/page.jsx - Booker → Public Event Page: selects event
- Public Event Page → Event Services: loads details
app/[username]/[eventId]/page.jsx - Public Event Page → Availability Services: loads open slots
app/[username]/[eventId]/page.jsx - Public Event Page → Booking Form: renders
app/[username]/[eventId]/page.jsx - Booking Form → Booking Services: submits booking
app/[username]/[eventId]/_components/booking-form.jsx - Booking Form → Checkout Session: starts paid checkout
- Booking Services → Application Database: stores booking
- Checkout Session → Input Validation: validates booking
app/api/stripe/create-checkout-session/route.js - Checkout Session → Application Database: loads event
app/api/stripe/create-checkout-session/route.js - Checkout Session → Stripe API: creates session
app/api/stripe/create-checkout-session/route.js - Stripe API → Payment Webhook: sends payment event
- Payment Webhook → Application Database: confirms booking
app/api/stripe/webhook/route.js - Payment Webhook → Calendar Events: creates meeting event
app/api/stripe/webhook/route.js - Calendar Events → Google Calendar: creates calendar event
- Payment Webhook → Stripe Connect: calculates payout
app/api/stripe/webhook/route.js - Mentor → Meeting Controls: manages meetings
- Meeting Controls → Meeting Services: updates status
- Meeting Services → Application Database: updates meeting
actions/meetings.js - Meeting Services → Stripe Connect: initiates payout
actions/meetings.js - Stripe Connect → Stripe API: transfers funds
lib/stripe-connect.js - Booker → Issue Reporting: reports issue
- Issue Reporting → Booking Services: submits report
app/booking/success/_components/report-booking-issue.jsx - Account Dashboard → Clerk Authentication: reads signed-in user