# order_feature.spec

spec_id: ORDER-001
name: 用户下单功能
description: 移动端一键下单，提升转化率

business_goals:
  - metric: conversion_rate
    current: 15%
    target: 25%
    timeline: Q2-2025

user_stories:
  - id: US-001
    role: 注册用户
    action: 一键下单
    benefit: 快速完成购买
    acceptance_criteria:
      - steps_count: 3
      - max_time: 60s
      - success_rate: >99%

entities:
  Order:
    fields:
      - name: id
        type: uuid
        required: true
      - name: user_id
        type: reference
        ref: User
        required: true
      - name: items
        type: array
        item_type: OrderItem
        required: true
      - name: total_amount
        type: decimal
        precision: 10
        scale: 2
        required: true
      - name: status
        type: enum
        values: [pending, paid, shipped, delivered, cancelled]
        default: pending
      - name: created_at
        type: timestamp
        auto: true
    
    business_rules:
      - rule_id: BR-001
        name: 库存检查
        condition: order.status == 'pending'
        action: check_inventory
        error_message: "商品库存不足"
      
      - rule_id: BR-002
        name: 价格计算
        condition: order.items.changed
        action: recalculate_total
      
      - rule_id: BR-003
        name: VIP折扣
        condition: user.tier == 'VIP' AND order.total >= 1000
        action: apply_discount(0.2)
        max_discount: 500

workflows:
  - id: WF-001
    name: 标准下单流程
    steps:
      - step: 1
        name: 选择商品
        ui: ProductSelectionScreen
        validations:
          - inventory > 0
          - price > 0
      
      - step: 2
        name: 确认地址
        ui: AddressConfirmationScreen
        data: user.default_address
        fallback: AddressInputScreen
      
      - step: 3
        name: 选择支付
        ui: PaymentMethodScreen
        options: [wechat, alipay, credit_card]
      
      - step: 4
        name: 订单确认
        ui: OrderSummaryScreen
        actions:
          - confirm: submit_order
          - cancel: abort
    
    post_actions:
      - action: send_confirmation_email
        async: true
        template: order_confirmation
        delay: 0
      
      - action: notify_inventory_system
        async: true
        event: order.created

apis:
  - path: /api/v1/orders
    method: POST
    description: 创建订单
    request:
      body: OrderCreateRequest
    response:
      success: Order
      error: OrderError
    rate_limit: 100/minute

ui:
  screens:
    - id: ProductSelectionScreen
      components:
        - type: ProductList
          data: cart.items
          actions:
            - select: add_to_order
        - type: Button
          text: "下一步"
          action: next_step
    
    - id: OrderSummaryScreen
      components:
        - type: OrderDetail
          data: order
        - type: PriceBreakdown
          items:
            - subtotal
            - discount
            - shipping
            - total
        - type: ButtonGroup
          buttons:
            - text: "确认下单"
              type: primary
              action: submit_order
            - text: "取消"
              type: secondary
              action: cancel

tests:
  - id: TEST-001
    name: 正常下单流程
    steps:
      - action: select_product
        params: { product_id: "P001", quantity: 2 }
      - action: confirm_address
      - action: select_payment
        params: { method: "wechat" }
      - action: submit_order
    expected:
      - order.status == 'pending'
      - email.sent == true
      - inventory.updated == true
  
  - id: TEST-002
    name: 库存不足场景
    steps:
      - action: select_product
        params: { product_id: "P002", quantity: 100 }
    expected:
      - error.code == 'INSUFFICIENT_INVENTORY'
      - error.message == '商品库存不足'

constraints:
  performance:
    - metric: page_load_time
      threshold: 2s
      priority: high
    - metric: api_response_time
      threshold: 500ms
      percentile: 95
  
  security:
    - requirement: input_validation
      scope: all_user_inputs
    - requirement: rate_limiting
      scope: order_creation

# 输入：Entity定义
entities:
  Order:
    fields:
      - name: id
        type: uuid
      - name: total_amount
        type: decimal
        precision: 10
        scale: 2

tests:
  - id: TEST-001
    name: 正常下单流程
    steps:
      - action: select_product
        params: { product_id: "P001", quantity: 2 }
      - action: confirm_address
      - action: select_payment
        params: { method: "wechat" }
      - action: submit_order
    expected:
      - order.status == 'pending'
      - email.sent == true

spec_id: COUPON-001
name: 优惠券系统

entities:
  Coupon:
    fields:
      - name: code
        type: string
        unique: true
      - name: type
        type: enum
        values: [percentage, fixed_amount]
      - name: value
        type: decimal
        validation: "> 0"
      - name: conditions
        type: json
        schema:
          min_order_amount: decimal?
          applicable_categories: array?
          applicable_products: array?
          user_tiers: array?
      - name: valid_from
        type: timestamp
      - name: valid_until
        type: timestamp
      - name: usage_limit
        type: integer
        default: 1
    
    business_rules:
      - rule_id: COUPON-R001
        name: 有效期检查
        condition: now() < coupon.valid_until
        error_message: "优惠券已过期"
      
      - rule_id: COUPON-R002
        name: 使用次数检查
        condition: coupon.usage_count < coupon.usage_limit
        error_message: "优惠券使用次数已达上限"
      
      - rule_id: COUPON-R003
        name: 订单金额门槛
        condition: |
          coupon.conditions.min_order_amount IS NULL 
          OR order.total >= coupon.conditions.min_order_amount
        error_message: "订单金额未达到优惠券使用门槛"
      
      - rule_id: COUPON-R004
        name: 品类限制
        condition: |
          coupon.conditions.applicable_categories IS NULL 
          OR order.items.all(item.category IN coupon.conditions.applicable_categories)
        error_message: "订单商品不符合优惠券适用范围"
      
      - rule_id: COUPON-R005
        name: 折扣计算
        action: |
          if coupon.type == 'percentage':
            discount = order.total * coupon.value
          else:
            discount = coupon.value
          return min(discount, order.total)  # 折扣不超过订单金额
      
      - rule_id: COUPON-R006
        name: 单订单限制
        condition: order.coupons.count == 0
        error_message: "一个订单只能使用一张优惠券"

workflows:
  - id: CLAIM-COUPON
    name: 领取优惠券
    steps:
      - validate_user_eligibility
      - check_coupon_availability
      - create_user_coupon_record
    
  - id: APPLY-COUPON
    name: 使用优惠券
    steps:
      - validate_coupon_validity
      - check_all_conditions
      - calculate_discount
      - apply_to_order
      - increment_usage_count

tests:
  - name: 满减优惠券正常使用
    given:
      coupon: { type: fixed_amount, value: 50, conditions: { min_order_amount: 200 } }
      order: { total: 250 }
    when: apply_coupon
    then:
      discount: 50
      final_amount: 200
  
  - name: 过期优惠券使用失败
    given:
      coupon: { valid_until: "2025-01-01" }
      current_date: "2025-02-01"
    when: apply_coupon
    then:
      error: "优惠券已过期"
  
  - name: 品类限制检查
    given:
      coupon: { conditions: { applicable_categories: ["electronics"] } }
      order: { items: [{ category: "clothing" }] }
    when: apply_coupon
    then:
      error: "订单商品不符合优惠券适用范围"