How ahtisham-1/fee-ease-react works
FeeEase manages school fee collection for administrators and parents. The principal workflow loads school records into the React portal, where administrators enroll students, assign class fees, and promote students; parents review obligations, pay fees, and inspect payment history. The frontend calls FastAPI through shared HTTP services, while route handlers use SQLModel sessions and domain models for persistence; the UI also computes financial summaries and FIFO fee allocation. The README documents dynamic transport pricing and role-based views. Routes and several UI details were not excerpted, so some subsystem links are documented or dashed rather than inferred from imports.
Main entry points: App.tsx Admin Portal · main.py FastAPI Application · database.py Database Session · apiClient.ts HTTP Client
Components 31
Role Portals
- Admin Portal
frontend/src/App.tsx - Parent Portal
frontend/src/App.tsx - Student Enrollment
frontend/src/components/admin/AdminAddStudentForm.tsx - Class Roster
frontend/src/components/admin/AdminClassRoster.tsx - Fee Assignment
frontend/src/components/admin/AdminAssignFeesForm.tsx - Class Promotion
frontend/src/components/admin/AdminPromoteClass.tsx - Collections Summary
frontend/src/components/admin/AdminCollectionsSummary.tsx - Admin Payment History
frontend/src/components/admin/AdminPaymentHistory.tsx - Fee Review
frontend/src/components/parent/FeeDetail.tsx - Fee Payment
frontend/src/components/parent/PayFeesForm.tsx - Payment History
frontend/src/components/parent/PaymentHistory.tsx - Student Selector
frontend/src/components/parent/ParentStudentSelector.tsx
UI Services
- Fee Calculations
frontend/src/utils/feeCalculator.ts - HTTP Client
frontend/src/services/apiClient.ts - Student Service
frontend/src/services/studentApi.ts - Parent Service
frontend/src/services/parentApi.ts - Fee Service
frontend/src/services/feeApi.ts - Payment Service
frontend/src/services/paymentApi.ts
Backend API
- FastAPI Application
backend/app/main.py - Authentication
backend/app/routes/auth.py - Student Routes
backend/app/routes/students.py - Parent Routes
backend/app/routes/parents.py - Fee Routes
backend/app/routes/fees.py - Payment Routes
backend/app/routes/payments.py - Token Security
backend/app/security.py
Domain and Storage
- Database Session
backend/app/database.py - Student Records
backend/app/models/student.py - Parent Records
backend/app/models/parent.py - Fee Obligations
backend/app/models/fee.py - Payment Records
backend/app/models/payment.py - User Records
backend/app/models/user.py
Connections 46
- Admin Portal → Student Service: loads and updates
frontend/src/App.tsx - Admin Portal → Parent Service: loads and updates
frontend/src/App.tsx - Admin Portal → Fee Service: loads and assigns
frontend/src/App.tsx - Admin Portal → Payment Service: loads payments
frontend/src/App.tsx - Admin Portal → Fee Calculations: summarizes balances
frontend/src/App.tsx - Admin Portal → Student Enrollment: renders
frontend/src/App.tsx - Admin Portal → Class Roster: renders
frontend/src/App.tsx - Admin Portal → Fee Assignment: renders
frontend/src/App.tsx - Admin Portal → Class Promotion: renders
frontend/src/App.tsx - Admin Portal → Collections Summary: renders
frontend/src/App.tsx - Admin Portal → Admin Payment History: renders
frontend/src/App.tsx - Parent Portal → Fee Review: renders
frontend/src/App.tsx - Parent Portal → Student Selector: renders
frontend/src/App.tsx - Parent Portal → Fee Payment: renders
frontend/src/App.tsx - Parent Portal → Payment History: renders
frontend/src/App.tsx - Fee Payment → Payment Service: submits payment
- Student Service → HTTP Client: requests through
frontend/src/services/studentApi.ts - Parent Service → HTTP Client: requests through
frontend/src/services/parentApi.ts - Fee Service → HTTP Client: requests through
frontend/src/services/feeApi.ts - Payment Service → HTTP Client: requests through
frontend/src/services/paymentApi.ts - HTTP Client → FastAPI Application: HTTP requests
- FastAPI Application → Database Session: creates tables
backend/app/main.py - FastAPI Application → Student Routes: registers routes
backend/app/main.py - FastAPI Application → Parent Routes: registers routes
backend/app/main.py - FastAPI Application → Fee Routes: registers routes
backend/app/main.py - FastAPI Application → Payment Routes: registers routes
backend/app/main.py - FastAPI Application → Authentication: registers routes
backend/app/main.py - Student Routes → Database Session: uses sessions
backend/app/routes/students.py - Parent Routes → Database Session: uses sessions
backend/app/routes/parents.py - Fee Routes → Database Session: uses sessions
backend/app/routes/fees.py - Payment Routes → Database Session: uses sessions
backend/app/routes/payments.py - Authentication → Database Session: uses sessions
backend/app/routes/auth.py - Student Routes → Student Records: reads and writes
backend/app/routes/students.py - Parent Routes → Parent Records: reads and writes
backend/app/routes/parents.py - Fee Routes → Fee Obligations: reads and writes
backend/app/routes/fees.py - Payment Routes → Payment Records: reads and writes
backend/app/routes/payments.py - Authentication → User Records: authenticates users
backend/app/routes/auth.py - Student Routes → Token Security: checks access
backend/app/routes/students.py - Parent Routes → Token Security: checks access
backend/app/routes/parents.py - Fee Routes → Token Security: checks access
backend/app/routes/fees.py - Payment Routes → Token Security: checks access
backend/app/routes/payments.py - Authentication → Token Security: uses token tools
backend/app/routes/auth.py - Student Records → Fee Obligations: relates obligations
backend/app/models/student.py - Student Records → Parent Records: relates guardian
backend/app/models/student.py - Parent Records → Student Records: relates children
backend/app/models/parent.py - Fee Calculations → Fee Obligations: allocates FIFO