How muoegu/language-school-operations works
This is a language-school operations web app for representatives, staff, and teachers. Users sign in, then manage students and teachers, schedule and record lessons, maintain textbooks and lesson types, and track payments, reports, alerts, and notifications. The Vue client routes users to role-aware screens; its API calls reach Hono route handlers, which enforce permissions and delegate domain operations to services backed by PostgreSQL. README describes major capabilities beyond the sampled calls; those branches are included, but their internal call links are omitted where source evidence was unavailable.
Main entry points: app.ts Hono app · main.ts Vue application · client.ts Database client · service.ts Lesson scheduling
Components 22
Web application
- Vue application
web/src/main.ts - Role-aware session
web/src/composables/useAuth.ts - Student records
web/src/pages/StudentDetailPage.vue - Lesson calendar
web/src/pages/LessonsPage.vue - Dashboard alerts
web/src/pages/DashboardPage.vue - Billing screens
web/src/pages/PaymentReportsPage.vue - Catalog screens
web/src/pages/TextbooksPage.vue
API and domain services
- Hono app
api/src/app.ts - Session and roles
api/src/features/auth/session.ts - Student management
api/src/features/students/service.ts - Teacher management
api/src/features/teachers - Lesson scheduling
api/src/features/lessons/service.ts - Lesson records
api/src/features/lesson-records/service.ts - Attendance
api/src/features/attendance - Dashboard alerts
api/src/features/dashboard-alerts - Lesson types and books
api/src/features/lesson-types - Payment records
api/src/features/payment-records/service.ts - Payment reports
api/src/features/payment-reports
Persistence
- Database client
api/src/db/client.ts - School data schema
api/src/db/schema.ts - PostgreSQL
Other components
- School users
Connections 30
- School users → Vue application: uses
- Vue application → Role-aware session: checks session
web/src/main.ts - Role-aware session → Hono app: requests session
- Vue application → Student records: routes to
web/src/main.ts - Vue application → Lesson calendar: routes to
web/src/main.ts - Vue application → Dashboard alerts: routes to
web/src/main.ts - Vue application → Billing screens: routes to
web/src/main.ts - Vue application → Catalog screens: routes to
web/src/main.ts - Student records → Student management: requests data
- Lesson calendar → Lesson scheduling: requests data
- Dashboard alerts → Dashboard alerts: requests alerts
- Billing screens → Payment reports: requests reports
- Hono app → Session and roles: registers routes
api/src/app.ts - Hono app → Student management: registers routes
api/src/app.ts - Hono app → Teacher management: registers routes
api/src/app.ts - Hono app → Lesson scheduling: registers routes
api/src/app.ts - Hono app → Lesson records: registers routes
api/src/app.ts - Hono app → Attendance: registers routes
api/src/app.ts - Hono app → Dashboard alerts: registers routes
api/src/app.ts - Hono app → Lesson types and books: registers routes
api/src/app.ts - Hono app → Payment records: registers routes
api/src/app.ts - Hono app → Payment reports: registers routes
api/src/app.ts - Student management → Database client: queries
api/src/features/students/service.ts - Lesson scheduling → Database client: queries
api/src/features/lessons/service.ts - Lesson records → Database client: queries
api/src/features/lesson-records/service.ts - Payment records → Database client: queries
api/src/features/payment-records/service.ts - Session and roles → Database client: loads user
api/src/features/auth/session.ts - Database client → School data schema: uses schema
- Database client → PostgreSQL: connects
api/src/db/client.ts - Lesson records → Lesson scheduling: uses lesson service
api/src/features/lesson-records/service.ts