订单软删除

app/Http/Controllers/Order/StoreOrderController.php

@@ -12,6 +12,7 @@ use App\Models\UserModel;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\DB;
+use Modules\AnnoRoute\Attribute\DeleteRoute;
 use Modules\AnnoRoute\Attribute\GetRoute;
 use Modules\AnnoRoute\Attribute\PutRoute;
 use Modules\AnnoRoute\Attribute\RequestAttribute;
@@ -400,6 +401,27 @@ class StoreOrderController extends BaseController
         return $this->success(['success' => $orders->count()]);
     }
 
+    /**
+     * 删除订单（软删除）：仅已取消订单允许删除；删除后后台列表/详情、小程序端均不可见
+     */
+    #[DeleteRoute(route: '/{id}', authorize: 'delete', where: ['id' => '[0-9]+'])]
+    public function delete(int $id): JsonResponse
+    {
+        $order = StoreOrderModel::find($id);
+        if (empty($order)) {
+            throw new RepositoryException('订单不存在');
+        }
+        if ($order->status !== StoreOrderModel::STATUS_CANCELLED) {
+            throw new RepositoryException(
+                '订单当前状态为「' . (self::STATUS_NAMES[$order->status] ?? $order->status) . '」，仅已取消订单可删除'
+            );
+        }
+
+        $order->delete();
+
+        return $this->success();
+    }
+
     /**
      * 状态流转合法路径（与迁移状态定义一致）：
      * 待接单→已接单/已取消；采购中→配送中/已完成；配送中→已完成

app/Models/StoreOrderModel.php

@@ -6,13 +6,14 @@ use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
 
 /**
- * 门店订单模型（小程序下单，快照等级价）
+ * 门店订单模型（小程序下单，快照等级价；软删除，仅已取消订单可由后台删除）
  */
 class StoreOrderModel extends Model
 {
-    use HasFactory;
+    use HasFactory, SoftDeletes;
 
     /** 状态：待接单（可被采购单生成归集、可取消） */
     public const int STATUS_PENDING = 0;

app/Services/PurchaseAllocateService.php

@@ -41,6 +41,7 @@ class PurchaseAllocateService
             $orderItems = StoreOrderItemModel::query()
                 ->join('store_order', 'store_order.id', '=', 'store_order_item.order_id')
                 ->where('store_order.purchase_id', $purchase->id)
+                ->whereNull('store_order.deleted_at')
                 ->select('store_order_item.*')
                 ->get()
                 ->groupBy('product_id');

app/Services/StatementGenerateService.php

@@ -39,6 +39,7 @@ class StatementGenerateService
                 ->whereDate('store_order.order_date', '>=', $periodStart)
                 ->whereDate('store_order.order_date', '<=', $periodEnd)
                 ->where('store_order.status', '<>', StoreOrderModel::STATUS_CANCELLED)
+                ->whereNull('store_order.deleted_at')
                 ->select('store_order_item.*')
                 ->get();