How 4anghyeon/magic-pos works
Main System Components
a) Frontend Layer:
• Next.js Application (Client-side)
• Admin Portal (/admin routes)
• Mobile Kiosk (/kiosk routes)
• Authentication System (/auth routes)
• PWA Support (manifest.json, service workers)
b) Backend Layer:
• Supabase (BaaS)
• Authentication
• Database
• Real-time subscriptions
• Storage
c) External Services:
• Toss Payments Integration
• Firebase Cloud Messaging (FCM)
• Business Registration API
• Translation Service
Key Architectural Patterns to Highlight
a) State Management:
• Zustand stores (/shared/store)
• React Query for server state
• Custom hooks for business logic
b) Feature Modules:
• Menu Management
• Order Processing
• Sales Analytics
• Platform Management
• Store Configuration
• QR Code Generation
Client Layer
• PWA Container
• Mobile Kiosk
• Push Notifications
• Web Application
• Admin Portal
• Store Management
• Analytics Dashboard
Service Layer
• Authentication
• State Management
• Zustand
• React Query
• Business Logic
• Order Processing
• Menu Management
• Sales Analytics
External Services Layer
• Toss Payments
• Firebase Cloud Messaging
• Business Registration API
• Translation Service
Data Layer
• Supabase
• Authentication
• Database
• Real-time
• Storage
Important Relationships to Highlight
• Real-time order notifications flow
• Payment processing sequence
• Authentication flow
• Data synchronization between admin and kiosk
• Push notification system
Implementation Details
• Maintain consistent symbol usage
• Version information
• Brief descriptions for complex flows