How donfreddy/payskool works
PAYSKOOL is a school-fee management and collection platform with a parent-facing payment experience, school administration tools, a marketing site, and a global platform-admin interface. The visible parent workflow is selecting a child, reviewing balances and installments, then opening a payment flow or viewing receipts. School workflows cover student and fee administration, cash collection, payments, receipts, reporting, notifications, and settings. The school app’s listed data adapters are mocks, and the sampled API exposes only a hello endpoint; the intended production backend and persistence flows are therefore not established by the inspected source.
Main entry points: App.tsx Parent app · app.controller.ts REST / GraphQL API · InstallmentsTimeline.tsx Installments · client.ts Typed API client
Components 27
Parent experience
- Parent app
apps/parent/src/App.tsx - Active student
apps/parent/src/contexts/ActiveStudentContext.tsx - Payment flow
apps/parent/src/components/PaymentFlowModal.tsx - Installments
apps/parent/src/components/InstallmentsTimeline.tsx - Receipts view
apps/parent/src/views/ReceiptsView.tsx - Children view
apps/parent/src/views/StudentsView.tsx - Support view
apps/parent/src/views/SupportView.tsx
School operations
- School dashboard
apps/school/src/app/(dashboard)/[schoolId]/dashboard/page.tsx - Student admin
apps/school/src/features/students - Student import
apps/school/src/features/students/import - Fee schedules
apps/school/src/features/fees - Cashier
apps/school/src/features/cashier - Online payments
apps/school/src/features/payments - School receipts
apps/school/src/features/receipts - Transaction ledger
apps/school/src/features/transactions - Collection reports
apps/school/src/features/reports - Notifications
apps/school/src/features/notifications - School settings
apps/school/src/features/settings - School members
apps/school/src/features/members
Platform services
- Platform admin
apps/platform/src/app/page.tsx - REST / GraphQL API
apps/api/src/app.controller.ts - Prisma database package
packages/db/src/client.ts - Typed API client
packages/api-client/src/client.ts - Shared types and validators
packages/shared/src/validators/auth.ts
Public presence
- Marketing website
apps/marketing/src/app/[locale]/page.tsx
Other components
- Parent
- School staff
Connections 27
- Parent → Parent app: uses
README.md - Parent app → Active student: reads student
apps/parent/src/App.tsx - Parent app → Installments: renders
apps/parent/src/App.tsx - Installments → Parent app: requests payment
apps/parent/src/components/InstallmentsTimeline.tsx - Parent app → Payment flow: opens
apps/parent/src/App.tsx - Parent app → Receipts view: renders
apps/parent/src/App.tsx - Parent app → Children view: renders
apps/parent/src/App.tsx - Parent app → Support view: renders
apps/parent/src/App.tsx - School staff → School dashboard: uses
README.md - School staff → Student admin: manages students
README.md - School staff → Student import: imports students
README.md - School staff → Fee schedules: manages fees
README.md - School staff → Cashier: records cash
README.md - School staff → Online payments: manages payments
README.md - School staff → School receipts: manages receipts
README.md - School staff → Transaction ledger: reviews transactions
README.md - School staff → Collection reports: reviews collections
README.md - School staff → Notifications: configures alerts
README.md - School staff → School settings: configures school
README.md - School staff → School members: manages members
README.md - Platform admin → School staff: administers platform
README.md - Parent → Marketing website: visits
- School staff → REST / GraphQL API: uses services
- REST / GraphQL API → Prisma database package: persists data
- Parent app → Typed API client: calls backend
- Typed API client → REST / GraphQL API: sends requests
- REST / GraphQL API → Shared types and validators: uses schemas