one-pipe-system/openspec/changes/add-order-management/proposal.md

Change: Add Order Management System

Why

The IoT management platform currently lacks order management capabilities. Users need to:

• View and query orders created by customers (personal and agent)
• Track order payment status and details
• Create orders for single card or device purchases
• Cancel pending orders
• View order history with filtering and search

This capability is essential for financial tracking, commission calculation, and overall business operations transparency.

What Changes

• NEW: Order list page with search, filtering, and pagination
• NEW: Order API service with full CRUD operations
• NEW: TypeScript types for order entities and API contracts
• NEW: i18n keys for order management UI
• NEW: Router configuration for order management module

The order management module will support:

• Listing orders with filters (payment status, order type, date range, order number)
• Viewing order details including buyer information, order items (packages), and payment details
• Creating orders for single card or device purchases with package selection
• Canceling orders that are in pending payment status
• Displaying payment method, commission status, and order totals

Impact

• Affected specs: order-management (new capability)
• Affected code:
  • src/types/api/order.ts (new file - TypeScript types)
  • src/api/modules/order.ts (new file - API service)
  • src/views/order-management/order-list/index.vue (new file - order list page)
  • src/router/routes/asyncRoutes.ts (route configuration)
  • src/router/routesAlias.ts (route alias)
  • src/locales/langs/zh.json (Chinese i18n)
  • src/locales/langs/en.json (English i18n)
  • src/types/api/index.ts (exports)
  • src/api/modules/index.ts (exports)
• Dependencies: Requires backend APIs at /api/admin/orders endpoints
• Breaking changes: None (this is a new feature)