feat: upload api

stateflow/tests/test_business_object_api.py

@@ -471,6 +471,132 @@ class BusinessObjectAPITestCase(TestCase):
             self.assertIsNotNone(item['completed_by'])
             self.assertFalse(item['is_cancelled'])
     
+    def test_get_state_logs_api_with_parameters(self):
+        """测试获取状态流转记录列表（包含参数）"""
+        # 未开始时应返回空列表
+        response = self.client.get(f'/api/v1/stateflow/business-objects/{self.business_object.id}/state-logs/')
+        
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        self.assertEqual(response.data['count'], 0)
+        self.assertEqual(len(response.data['state_logs']), 0)
+        
+        # 推进两次
+        self.client.post(
+            f'/api/v1/stateflow/business-objects/{self.business_object.id}/advance/',
+            {'parameters': {'temperature': '25.5', 'humidity': '60%'}},
+            format='json'
+        )
+        self.client.post(f'/api/v1/stateflow/business-objects/{self.business_object.id}/advance/')
+        
+        # 获取记录列表（默认包含参数）
+        response = self.client.get(f'/api/v1/stateflow/business-objects/{self.business_object.id}/state-logs/')
+        
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        self.assertEqual(response.data['count'], 2)
+        self.assertEqual(len(response.data['state_logs']), 2)
+        
+        # 验证第一条记录包含参数摘要
+        log1 = response.data['state_logs'][0]
+        self.assertIn('parameters_summary', log1)
+        self.assertEqual(log1['parameters_summary']['temperature'], '25.5')
+        self.assertEqual(log1['parameters_summary']['humidity'], '60%')
+        self.assertEqual(log1['state_name'], '状态1')
+        
+        # 验证第二条记录（无参数）
+        log2 = response.data['state_logs'][1]
+        self.assertIn('parameters_summary', log2)
+        self.assertEqual(len(log2['parameters_summary']), 0)
+        self.assertEqual(log2['state_name'], '状态2')
+    
+    def test_get_state_logs_api_without_parameters(self):
+        """测试获取状态流转记录列表（不包含参数）"""
+        # 推进两次
+        self.client.post(
+            f'/api/v1/stateflow/business-objects/{self.business_object.id}/advance/',
+            {'parameters': {'temperature': '25.5'}},
+            format='json'
+        )
+        self.client.post(f'/api/v1/stateflow/business-objects/{self.business_object.id}/advance/')
+        
+        # 获取记录列表（不包含参数）
+        response = self.client.get(
+            f'/api/v1/stateflow/business-objects/{self.business_object.id}/state-logs/?include_parameters=false'
+        )
+        
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        self.assertEqual(response.data['count'], 2)
+        
+        # 验证不包含 parameters_summary 字段
+        log1 = response.data['state_logs'][0]
+        self.assertNotIn('parameters_summary', log1)
+        self.assertIn('state_name', log1)
+        self.assertIn('completed_at', log1)
+        self.assertIn('completed_by_username', log1)
+    
+    def test_get_state_logs_api_exclude_cancelled(self):
+        """测试获取状态流转记录列表（排除已撤销记录）"""
+        # 推进两次
+        self.client.post(
+            f'/api/v1/stateflow/business-objects/{self.business_object.id}/advance/',
+            {'parameters': {'temperature': '25.5'}},
+            format='json'
+        )
+        self.client.post(f'/api/v1/stateflow/business-objects/{self.business_object.id}/advance/')
+        
+        # 回退一次（撤销第二条记录）
+        self.client.post(f'/api/v1/stateflow/business-objects/{self.business_object.id}/step_back/')
+        
+        # 默认包含已撤销记录
+        response = self.client.get(f'/api/v1/stateflow/business-objects/{self.business_object.id}/state-logs/')
+        self.assertEqual(response.data['count'], 2)
+        
+        # 验证第二条是已撤销的
+        self.assertTrue(response.data['state_logs'][1]['is_cancelled'])
+        
+        # 排除已撤销记录
+        response = self.client.get(
+            f'/api/v1/stateflow/business-objects/{self.business_object.id}/state-logs/?include_cancelled=false'
+        )
+        
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        self.assertEqual(response.data['count'], 1)
+        self.assertEqual(len(response.data['state_logs']), 1)
+        
+        # 验证只有第一条记录（未撤销）
+        self.assertFalse(response.data['state_logs'][0]['is_cancelled'])
+        self.assertEqual(response.data['state_logs'][0]['state_name'], '状态1')
+    
+    def test_get_state_logs_api_order(self):
+        """测试状态流转记录按时间排序"""
+        # 推进三次
+        self.client.post(
+            f'/api/v1/stateflow/business-objects/{self.business_object.id}/advance/',
+            {'parameters': {'temperature': '25.5'}},
+            format='json'
+        )
+        self.client.post(f'/api/v1/stateflow/business-objects/{self.business_object.id}/advance/')
+        self.client.post(f'/api/v1/stateflow/business-objects/{self.business_object.id}/advance/')
+        
+        # 获取记录列表
+        response = self.client.get(f'/api/v1/stateflow/business-objects/{self.business_object.id}/state-logs/')
+        
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        self.assertEqual(response.data['count'], 3)
+        
+        # 验证按时间顺序排列
+        logs = response.data['state_logs']
+        self.assertEqual(logs[0]['state_name'], '状态1')
+        self.assertEqual(logs[1]['state_name'], '状态2')
+        self.assertEqual(logs[2]['state_name'], '状态3')
+        
+        # 验证时间递增
+        from datetime import datetime
+        time1 = datetime.fromisoformat(logs[0]['completed_at'])
+        time2 = datetime.fromisoformat(logs[1]['completed_at'])
+        time3 = datetime.fromisoformat(logs[2]['completed_at'])
+        self.assertLessEqual(time1, time2)
+        self.assertLessEqual(time2, time3)
+    
     def test_advance_when_already_completed(self):
         """测试流程已完成时尝试推进（预期错误）"""
         # 完成所有状态