Lantern
Master

Astro 5 SSR + Vue 3 Frontend Architecture

The frontend is built with Astro 5 in Server-Side Rendering mode, combined with Vue 3 for interactive components. Routing uses Astro's file-based routing system, with a mix of static and dynamic page rendering. State management uses Nanostores, sharing global state such as shopping cart and dialogs across components.

The UI is rapidly developed with TailwindCSS 4 and the Flowbite component library, along with Unplugin Icons for tree-shaking icon loading. The rich text editor uses Tiptap, and drag-and-drop functionality is implemented with vuedraggable.

Laravel 11 Backend API

The backend is built with Laravel 11 as a RESTful API, covering user authentication, product management, order processing, chart computation, and points system modules. Authentication uses JWT (tymon/jwt-auth), combined with Laravel Socialite for Google, Line, and Facebook OAuth login.

Data access control is implemented with Spatie Permission for role-based access management, along with Policy for fine-grained authorization. The system includes 54+ Eloquent Models, business logic managed by State Machine for order state transitions, and Activity Log to record all change operations.

Zi Wei Dou Shu Chart Engine

The chart engine integrates lunar calendar conversion (overtrue/chinese-calendar), supporting both solar and lunar birth data input, automatically calculating heavenly stems, earthly branches, twelve palaces, and primary/secondary star arrangements. Each user can create multiple charts and organize them into groups, with chart data stored in UserChart / UserChartGroup models.

Chart feature settings are controlled by ChartFeatureSetting, where different plan tiers correspond to different feature unlock scopes, combined with points consumption or subscription payments to unlock advanced interpretation content.

E-Commerce & Payment Integration

The shop system supports product categories, attribute specifications, image management, and inventory tracking. The shopping cart is persisted on the frontend with Nanostores, and the checkout flow integrates Newebpay, supporting credit card, ATM transfer and other payment methods.

Payment callbacks use a Callback + Notify dual-channel approach to ensure correct payment result recording. The order system distinguishes between product orders, service orders, chart orders, and points orders — four types, each with its own state machine and processing flow.

Filament 3 Admin Panel

The admin panel is built with Filament 3, providing 40+ Resources for CRUD operations across all business modules. It integrates Filament Shield for permission management, Filament Turnstile for login form protection, and custom components such as QR code generator and tree selector.

Points & Service Booking

The points system uses PointChangeRecord to track all point transactions (purchase, consumption, refund, gifting). Users can use points to purchase chart readings or book offline consultation services. The service booking system supports service categories, time slot management, and order tracking.