How hf-cygg/y-link works
Y-Link is an inventory and O2O reservation system for cultural-product stores and events. Its main user workflow spans catalog discovery, reservation/order placement, offline verification, inbound and outbound stock operations, inventory tracking, and customer feedback; administrators and operators also manage products, users, settings, and audit records. The Vue client and admin front ends use an Express/TypeORM backend with SQLite by default and optional MySQL migration. Mobile is an Expo foundation, not a live client: the README says real API, session, cart, order, inventory, returns, and device integrations are not yet connected. Links are limited to README statements and shown source-index references.
Main entry points: http.ts HTTP request layer · client Client web · App.vue Admin web · app.ts Express API
Components 24
Web experiences
- Client web
src/views/client - Client authentication
src/views/client/ClientAuthView.vue - Product mall
src/api/modules/o2o.ts - Cart and checkout
src/store/modules/client-cart.ts - Orders and returns
src/store/modules/client-order.ts - Customer feedback
src/api/modules/customer-service-feedback.ts - Admin web
src/App.vue - Product management
src/views/base-data/components/ProductManager.vue - Stock operations
src/api/modules/inventory.ts - Order operations
src/api/modules/order.ts - Users, settings, audit
src/api/modules/system-config.ts - HTTP request layer
src/api/http.ts
Backend services
- Express API
backend/src/app.ts - Client auth service
backend/src/services/client-auth.service.ts - O2O reservation service
backend/src/services/o2o-preorder.service.ts - Inventory queries
backend/src/services/inventory-query.service.ts
Persistence and contracts
- Business database
backend/src/entities - Shared API client
packages/api-client/src/modules/client-auth.ts - Shared contracts
packages/shared-types/src
Mobile foundation
- Expo mobile app
apps/mobile/app - Mobile providers
apps/mobile/src/app/providers/AppProviders.tsx - Mobile shared contracts
apps/mobile/src/contracts/shared-packages.ts
Other components
- Customers
- Admin and operators
Connections 28
- Customers → Client web: use
README.md - Admin and operators → Admin web: manage through
README.md - Client web → Client authentication: register and sign in
README.md - Client authentication → HTTP request layer: requests
src/views/client/ClientAuthView.vue - HTTP request layer → Express API: sends API requests
README.md - Express API → Client auth service: handles client auth
- Client web → Product mall: browse catalog
README.md - Product mall → HTTP request layer: uses
src/api/modules/o2o.ts - Client web → Cart and checkout: build cart
README.md - Client web → Orders and returns: place and track orders
README.md - Client web → Customer feedback: send feedback
README.md - Admin web → Product management: maintain products
README.md - Admin web → Stock operations: manage stock
README.md - Admin web → Order operations: manage orders
README.md - Admin web → Users, settings, audit: manage users and audit
README.md - Product management → HTTP request layer: uses
src/views/base-data/components/ProductManager.vue - Stock operations → HTTP request layer: uses
README.md - Order operations → HTTP request layer: uses
README.md - Users, settings, audit → HTTP request layer: uses
README.md - Express API → O2O reservation service: routes O2O requests
- Express API → Inventory queries: serves inventory queries
- O2O reservation service → Business database: persists reservations
- Inventory queries → Business database: reads stock records
backend/src/services/inventory-query.service.ts - Express API → Business database: stores business data
README.md - Shared API client → Shared contracts: uses contracts
packages/api-client/src/modules/client-auth.ts - Expo mobile app → Mobile providers: initializes providers
- Expo mobile app → Mobile shared contracts: declares package boundary
README.md - Expo mobile app → Shared API client: not yet integrated
README.md