980 lines
42 KiB
Python
980 lines
42 KiB
Python
import inspect
|
|
import secrets
|
|
import unittest
|
|
from datetime import datetime
|
|
from types import SimpleNamespace
|
|
from typing import Any
|
|
from unittest.mock import AsyncMock, MagicMock, patch
|
|
|
|
from fastapi import FastAPI
|
|
from fastapi.routing import APIRoute
|
|
from pydantic import ValidationError
|
|
from sqlalchemy.exc import IntegrityError
|
|
from sqlalchemy.ext.asyncio import AsyncSession
|
|
|
|
from common.aspect.interface_auth import CheckUserInterfaceAuth
|
|
from common.aspect.pre_auth import PreAuth
|
|
from common.vo import CrudResponseModel, DataResponseModel, PageModel, PageResponseModel, ResponseBaseModel
|
|
from exceptions.exception import ServiceException
|
|
from module_admin.entity.do.user_do import SysUser
|
|
from module_admin.service.login_service import LoginService
|
|
from module_business.controller import pallet_controller as pallet_controller_module
|
|
from module_business.controller import site_controller as site_controller_module
|
|
from module_business.controller import warehouse_controller as warehouse_controller_module
|
|
from module_business.dao.access_dao import AccessDao
|
|
from module_business.dao.master_dao import MasterDao
|
|
from module_business.entity.do.master_do import BizPallet
|
|
from module_business.entity.do.operation_do import BizPalletInventory
|
|
from module_business.entity.vo.master_vo import (
|
|
BusinessUserOptionModel,
|
|
DeletePalletModel,
|
|
PalletCreateModel,
|
|
PalletEditModel,
|
|
PalletModel,
|
|
PalletPageQueryModel,
|
|
UserAssignModel,
|
|
)
|
|
from module_business.service import pallet_service as pallet_service_module
|
|
from module_business.service.pallet_service import PalletService
|
|
from utils.page_util import PageUtil
|
|
|
|
|
|
def compile_sql(statement: Any) -> str:
|
|
return ' '.join(str(statement.compile(compile_kwargs={'literal_binds': True})).split())
|
|
|
|
|
|
def integrity_error() -> IntegrityError:
|
|
return IntegrityError('statement', {}, RuntimeError('constraint'))
|
|
|
|
|
|
def make_pallet_record(pallet_id: int, capacity_packages: int = 20) -> SimpleNamespace:
|
|
return SimpleNamespace(
|
|
pallet_id=pallet_id,
|
|
pallet_code=f'P-{pallet_id:03d}',
|
|
qr_token=f'fixed-token-{pallet_id}',
|
|
capacity_packages=capacity_packages,
|
|
asset_status='0',
|
|
remark=None,
|
|
)
|
|
|
|
|
|
class TestPalletServiceContract(unittest.TestCase):
|
|
def test_service_is_available(self) -> None:
|
|
self.assertIsNotNone(PalletService)
|
|
|
|
|
|
class TestPalletVoContract(unittest.TestCase):
|
|
def test_business_user_option_only_exposes_safe_fields(self) -> None:
|
|
source = SimpleNamespace(
|
|
user_id=7,
|
|
user_name='operator',
|
|
nick_name=None,
|
|
assigned=True,
|
|
password='secret',
|
|
email='operator@example.com',
|
|
phonenumber='13800000000',
|
|
token='token',
|
|
)
|
|
|
|
option = BusinessUserOptionModel.model_validate(source)
|
|
|
|
self.assertEqual(
|
|
{'userId': 7, 'userName': 'operator', 'nickName': None, 'assigned': True},
|
|
option.model_dump(by_alias=True),
|
|
)
|
|
self.assertTrue(
|
|
{'password', 'email', 'phonenumber', 'phone', 'token'}.isdisjoint(BusinessUserOptionModel.model_fields)
|
|
)
|
|
|
|
def test_business_user_option_validates_identity_fields(self) -> None:
|
|
invalid_values = (
|
|
{'userId': 0, 'userName': 'operator', 'assigned': False},
|
|
{'userId': 1, 'userName': '', 'assigned': False},
|
|
{'userId': 1, 'userName': ' ', 'assigned': False},
|
|
)
|
|
for value in invalid_values:
|
|
with self.subTest(value=value), self.assertRaises(ValidationError):
|
|
BusinessUserOptionModel.model_validate(value)
|
|
|
|
def test_pallet_edit_rejects_code_and_qr_token(self) -> None:
|
|
base = {'palletId': 1, 'capacityPackages': 20, 'assetStatus': '0'}
|
|
for identity_field in ({'palletCode': 'P-001'}, {'qrToken': 'fixed-token'}):
|
|
with self.subTest(identity_field=identity_field), self.assertRaises(ValidationError):
|
|
PalletEditModel.model_validate({**base, **identity_field})
|
|
|
|
|
|
class TestPalletMasterDao(unittest.IsolatedAsyncioTestCase):
|
|
def setUp(self) -> None:
|
|
self.db = MagicMock(spec=AsyncSession)
|
|
|
|
async def test_list_pallet_filters_and_orders_by_pallet_id(self) -> None:
|
|
query = PalletPageQueryModel(palletCode='P-00', assetStatus='0')
|
|
expected = object()
|
|
|
|
with patch.object(PageUtil, 'paginate', new=AsyncMock(return_value=expected)) as paginate:
|
|
actual = await MasterDao.list_pallet(self.db, query, is_page=True)
|
|
|
|
self.assertIs(expected, actual)
|
|
statement = paginate.await_args.args[1]
|
|
sql = compile_sql(statement)
|
|
self.assertIn('FROM biz_pallet', sql)
|
|
self.assertIn("biz_pallet.pallet_code LIKE '%P-00%'", sql)
|
|
self.assertIn("biz_pallet.asset_status = '0'", sql)
|
|
self.assertIn('ORDER BY biz_pallet.pallet_id', sql)
|
|
|
|
async def test_add_pallet_and_inventory_only_flush_current_transaction(self) -> None:
|
|
pallet = BizPallet(
|
|
pallet_code='P-001',
|
|
qr_token='fixed-token',
|
|
capacity_packages=20,
|
|
asset_status='0',
|
|
)
|
|
inventory = BizPalletInventory(
|
|
pallet_id=3,
|
|
flow_state='UNSTOCKED',
|
|
remaining_packages=0,
|
|
version=0,
|
|
)
|
|
|
|
actual = await MasterDao.add_pallet(self.db, pallet)
|
|
await MasterDao.add_pallet_inventory(self.db, inventory)
|
|
|
|
self.assertIs(pallet, actual)
|
|
self.assertEqual([pallet, inventory], [call.args[0] for call in self.db.add.call_args_list])
|
|
self.assertEqual(2, self.db.flush.await_count)
|
|
self.db.commit.assert_not_awaited()
|
|
self.db.rollback.assert_not_awaited()
|
|
|
|
async def test_update_pallet_sql_never_contains_identity_fields(self) -> None:
|
|
edit = PalletEditModel(palletId=3, capacityPackages=18, assetStatus='1', remark='停用')
|
|
updated_at = datetime(2026, 7, 26, 10, 30)
|
|
|
|
await MasterDao.update_pallet(self.db, edit, update_by='admin', update_time=updated_at)
|
|
|
|
statement = self.db.execute.await_args.args[0]
|
|
sql = compile_sql(statement)
|
|
self.assertIn('UPDATE biz_pallet', sql)
|
|
self.assertIn('capacity_packages=18', sql)
|
|
self.assertIn("asset_status='1'", sql)
|
|
self.assertIn("remark='停用'", sql)
|
|
self.assertIn("update_by='admin'", sql)
|
|
self.assertIn('WHERE biz_pallet.pallet_id = 3', sql)
|
|
self.assertNotIn('pallet_code=', sql)
|
|
self.assertNotIn('qr_token=', sql)
|
|
self.db.commit.assert_not_awaited()
|
|
self.db.rollback.assert_not_awaited()
|
|
|
|
async def test_inventory_delete_and_event_count_target_one_pallet(self) -> None:
|
|
count_result = MagicMock()
|
|
count_result.scalar.return_value = 2
|
|
self.db.execute.side_effect = [MagicMock(), count_result]
|
|
|
|
await MasterDao.delete_pallet_inventory(self.db, pallet_id=9)
|
|
count = await MasterDao.count_pallet_events(self.db, pallet_id=9)
|
|
|
|
delete_statement = self.db.execute.await_args_list[0].args[0]
|
|
self.assertTrue(delete_statement.table.compare(BizPalletInventory.__table__))
|
|
self.assertIn('biz_pallet_inventory.pallet_id = 9', compile_sql(delete_statement))
|
|
count_statement = self.db.execute.await_args_list[1].args[0]
|
|
self.assertIn('FROM biz_pallet_event', compile_sql(count_statement))
|
|
self.assertIn('biz_pallet_event.pallet_id = 9', compile_sql(count_statement))
|
|
self.assertEqual(2, count)
|
|
self.db.commit.assert_not_awaited()
|
|
self.db.rollback.assert_not_awaited()
|
|
|
|
async def test_inventory_write_read_uses_row_lock(self) -> None:
|
|
result = MagicMock()
|
|
inventory = SimpleNamespace(pallet_id=9)
|
|
result.scalar_one_or_none.return_value = inventory
|
|
self.db.execute.return_value = result
|
|
|
|
actual = await MasterDao.get_pallet_inventory(self.db, pallet_id=9, for_update=True)
|
|
|
|
self.assertIs(inventory, actual)
|
|
statement = self.db.execute.await_args.args[0]
|
|
self.assertIn('biz_pallet_inventory.pallet_id = 9', compile_sql(statement))
|
|
self.assertIn('FOR UPDATE', compile_sql(statement))
|
|
|
|
async def test_pallet_write_read_uses_row_lock(self) -> None:
|
|
result = MagicMock()
|
|
pallet = make_pallet_record(9)
|
|
result.scalar_one_or_none.return_value = pallet
|
|
self.db.execute.return_value = result
|
|
|
|
actual = await MasterDao.get_pallet(self.db, pallet_id=9, for_update=True)
|
|
|
|
self.assertIs(pallet, actual)
|
|
statement = self.db.execute.await_args.args[0]
|
|
self.assertIn('biz_pallet.pallet_id = 9', compile_sql(statement))
|
|
self.assertIn('FOR UPDATE', compile_sql(statement))
|
|
|
|
async def test_assignable_user_queries_filter_disabled_and_deleted_rows(self) -> None:
|
|
list_result = MagicMock()
|
|
list_result.all.return_value = ()
|
|
selected_result = MagicMock()
|
|
selected_result.all.return_value = ()
|
|
self.db.execute.side_effect = [list_result, selected_result]
|
|
|
|
self.assertEqual([], await MasterDao.list_assignable_users(self.db))
|
|
self.assertEqual([], await MasterDao.list_assignable_users_by_ids(self.db, [2, 5]))
|
|
|
|
for statement in (call.args[0] for call in self.db.execute.await_args_list):
|
|
sql = compile_sql(statement)
|
|
self.assertIn('FROM sys_user', sql)
|
|
self.assertIn("sys_user.status = '0'", sql)
|
|
self.assertIn("sys_user.del_flag = '0'", sql)
|
|
self.assertNotIn('password', sql)
|
|
self.assertEqual(
|
|
[SysUser.user_id, SysUser.user_name, SysUser.nick_name],
|
|
list(statement.selected_columns),
|
|
)
|
|
self.assertIn('ORDER BY sys_user.user_id', compile_sql(self.db.execute.await_args_list[0].args[0]))
|
|
selected_sql = compile_sql(self.db.execute.await_args_list[1].args[0])
|
|
self.assertIn('sys_user.user_id IN (2, 5)', selected_sql)
|
|
|
|
|
|
class TestPalletCreationService(unittest.IsolatedAsyncioTestCase):
|
|
def setUp(self) -> None:
|
|
self.db = MagicMock(spec=AsyncSession)
|
|
self.create = PalletCreateModel(palletCode='P-001', capacityPackages=20, remark='测试托盘')
|
|
self.fixed_time = datetime(2026, 7, 26, 11, 30)
|
|
|
|
async def test_add_generates_server_token_and_initial_inventory_in_one_transaction(self) -> None:
|
|
actions: list[str] = []
|
|
captured: dict[str, Any] = {}
|
|
|
|
async def add_pallet(_db: AsyncSession, pallet: BizPallet) -> BizPallet:
|
|
actions.append('pallet')
|
|
captured['pallet'] = pallet
|
|
pallet.pallet_id = 17
|
|
return pallet
|
|
|
|
async def add_inventory(_db: AsyncSession, inventory: BizPalletInventory) -> BizPalletInventory:
|
|
actions.append('inventory')
|
|
captured['inventory'] = inventory
|
|
return inventory
|
|
|
|
async def commit() -> None:
|
|
actions.append('commit')
|
|
|
|
self.db.commit.side_effect = commit
|
|
with (
|
|
patch.object(MasterDao, 'find_pallet_by_code', new=AsyncMock(return_value=None)),
|
|
patch.object(MasterDao, 'add_pallet', new=AsyncMock(side_effect=add_pallet)),
|
|
patch.object(MasterDao, 'add_pallet_inventory', new=AsyncMock(side_effect=add_inventory)),
|
|
patch.object(secrets, 'token_urlsafe', return_value='server-fixed-token') as token_urlsafe,
|
|
patch.object(pallet_service_module, 'datetime', create=True) as service_datetime,
|
|
):
|
|
service_datetime.now.return_value = self.fixed_time
|
|
result = await PalletService.add_pallet(self.db, self.create, current_user_name='admin')
|
|
|
|
token_urlsafe.assert_called_once_with(32)
|
|
pallet = captured['pallet']
|
|
self.assertEqual('P-001', pallet.pallet_code)
|
|
self.assertEqual('server-fixed-token', pallet.qr_token)
|
|
self.assertEqual(20, pallet.capacity_packages)
|
|
self.assertEqual('0', pallet.asset_status)
|
|
self.assertEqual('admin', pallet.create_by)
|
|
self.assertEqual(self.fixed_time, pallet.create_time)
|
|
self.assertEqual('admin', pallet.update_by)
|
|
self.assertEqual(self.fixed_time, pallet.update_time)
|
|
inventory = captured['inventory']
|
|
self.assertEqual(17, inventory.pallet_id)
|
|
self.assertEqual('UNSTOCKED', inventory.flow_state)
|
|
self.assertEqual(0, inventory.remaining_packages)
|
|
self.assertEqual(0, inventory.version)
|
|
self.assertEqual(['pallet', 'inventory', 'commit'], actions)
|
|
self.db.commit.assert_awaited_once()
|
|
self.db.rollback.assert_not_awaited()
|
|
self.assertIsInstance(result, CrudResponseModel)
|
|
self.assertTrue(result.is_success)
|
|
|
|
async def test_add_rolls_back_when_pallet_flush_fails(self) -> None:
|
|
failure = RuntimeError('flush failed')
|
|
add_inventory = AsyncMock()
|
|
with (
|
|
patch.object(MasterDao, 'find_pallet_by_code', new=AsyncMock(return_value=None)),
|
|
patch.object(MasterDao, 'add_pallet', new=AsyncMock(side_effect=failure)),
|
|
patch.object(MasterDao, 'add_pallet_inventory', new=add_inventory),
|
|
self.assertRaisesRegex(RuntimeError, 'flush failed'),
|
|
):
|
|
await PalletService.add_pallet(self.db, self.create, current_user_name='admin')
|
|
|
|
add_inventory.assert_not_awaited()
|
|
self.db.commit.assert_not_awaited()
|
|
self.db.rollback.assert_awaited_once()
|
|
|
|
async def test_add_rolls_back_when_commit_fails(self) -> None:
|
|
async def assign_id(_db: AsyncSession, pallet: BizPallet) -> BizPallet:
|
|
pallet.pallet_id = 17
|
|
return pallet
|
|
|
|
self.db.commit.side_effect = RuntimeError('commit failed')
|
|
with (
|
|
patch.object(MasterDao, 'find_pallet_by_code', new=AsyncMock(return_value=None)),
|
|
patch.object(MasterDao, 'add_pallet', new=AsyncMock(side_effect=assign_id)),
|
|
patch.object(MasterDao, 'add_pallet_inventory', new=AsyncMock()),
|
|
self.assertRaisesRegex(RuntimeError, 'commit failed'),
|
|
):
|
|
await PalletService.add_pallet(self.db, self.create, current_user_name='admin')
|
|
|
|
self.db.rollback.assert_awaited_once()
|
|
|
|
async def test_add_converts_integrity_error_to_stable_service_exception(self) -> None:
|
|
with (
|
|
patch.object(MasterDao, 'find_pallet_by_code', new=AsyncMock(return_value=None)),
|
|
patch.object(MasterDao, 'add_pallet', new=AsyncMock(side_effect=integrity_error())),
|
|
self.assertRaises(ServiceException) as raised,
|
|
):
|
|
await PalletService.add_pallet(self.db, self.create, current_user_name='admin')
|
|
|
|
self.assertEqual('新增托盘失败，托盘编号或二维码标识已存在', raised.exception.message)
|
|
self.db.rollback.assert_awaited_once()
|
|
self.db.commit.assert_not_awaited()
|
|
|
|
async def test_add_rejects_duplicate_code_before_writing(self) -> None:
|
|
add_pallet = AsyncMock()
|
|
with (
|
|
patch.object(MasterDao, 'find_pallet_by_code', new=AsyncMock(return_value=object())),
|
|
patch.object(MasterDao, 'add_pallet', new=add_pallet),
|
|
self.assertRaises(ServiceException) as raised,
|
|
):
|
|
await PalletService.add_pallet(self.db, self.create, current_user_name='admin')
|
|
|
|
self.assertEqual('托盘编号已存在', raised.exception.message)
|
|
add_pallet.assert_not_awaited()
|
|
self.db.rollback.assert_awaited_once()
|
|
|
|
|
|
class TestPalletQrService(unittest.IsolatedAsyncioTestCase):
|
|
def test_render_qr_png_returns_real_stable_png(self) -> None:
|
|
first = PalletService.render_qr_png('fixed-original-token')
|
|
second = PalletService.render_qr_png('fixed-original-token')
|
|
|
|
self.assertEqual(b'\x89PNG\r\n\x1a\n', first[:8])
|
|
self.assertEqual(first, second)
|
|
|
|
async def test_get_qrcode_uses_original_persisted_token(self) -> None:
|
|
db = MagicMock(spec=AsyncSession)
|
|
with (
|
|
patch.object(
|
|
MasterDao,
|
|
'get_pallet',
|
|
new=AsyncMock(return_value=SimpleNamespace(qr_token='persisted-token')),
|
|
),
|
|
patch.object(PalletService, 'render_qr_png', return_value=b'png-bytes') as render,
|
|
patch.object(secrets, 'token_urlsafe') as token_urlsafe,
|
|
):
|
|
actual = await PalletService.get_pallet_qrcode(db, pallet_id=7)
|
|
|
|
self.assertEqual(b'png-bytes', actual)
|
|
render.assert_called_once_with('persisted-token')
|
|
token_urlsafe.assert_not_called()
|
|
|
|
async def test_get_qrcode_rejects_missing_pallet(self) -> None:
|
|
db = MagicMock(spec=AsyncSession)
|
|
with (
|
|
patch.object(MasterDao, 'get_pallet', new=AsyncMock(return_value=None)),
|
|
self.assertRaises(ServiceException) as raised,
|
|
):
|
|
await PalletService.get_pallet_qrcode(db, pallet_id=404)
|
|
|
|
self.assertEqual('托盘不存在', raised.exception.message)
|
|
|
|
|
|
class TestPalletQueryAndEditService(unittest.IsolatedAsyncioTestCase):
|
|
def setUp(self) -> None:
|
|
self.db = MagicMock(spec=AsyncSession)
|
|
|
|
async def test_list_computes_can_remove_from_inventory_and_events(self) -> None:
|
|
page = PageModel[Any](
|
|
rows=[make_pallet_record(1), make_pallet_record(2)],
|
|
pageNum=1,
|
|
pageSize=10,
|
|
total=2,
|
|
hasNext=False,
|
|
)
|
|
query = PalletPageQueryModel()
|
|
with (
|
|
patch.object(MasterDao, 'list_pallet', new=AsyncMock(return_value=page)),
|
|
patch.object(
|
|
MasterDao,
|
|
'get_pallet_inventory',
|
|
new=AsyncMock(
|
|
side_effect=[
|
|
SimpleNamespace(flow_state='UNSTOCKED'),
|
|
SimpleNamespace(flow_state='UNSTOCKED'),
|
|
]
|
|
),
|
|
),
|
|
patch.object(MasterDao, 'count_pallet_events', new=AsyncMock(side_effect=[0, 1])),
|
|
):
|
|
actual = await PalletService.list_pallet(self.db, query, is_page=True)
|
|
|
|
self.assertIsInstance(actual, PageModel)
|
|
self.assertTrue(all(isinstance(row, PalletModel) for row in actual.rows))
|
|
self.assertEqual([True, False], [row.can_remove for row in actual.rows])
|
|
|
|
async def test_detail_computes_false_when_inventory_is_not_unstocked(self) -> None:
|
|
with (
|
|
patch.object(MasterDao, 'get_pallet', new=AsyncMock(return_value=make_pallet_record(3))),
|
|
patch.object(
|
|
MasterDao,
|
|
'get_pallet_inventory',
|
|
new=AsyncMock(return_value=SimpleNamespace(flow_state='EMPTY_IN_WAREHOUSE')),
|
|
),
|
|
patch.object(MasterDao, 'count_pallet_events', new=AsyncMock(return_value=0)),
|
|
):
|
|
actual = await PalletService.detail_pallet(self.db, pallet_id=3)
|
|
|
|
self.assertIsInstance(actual, PalletModel)
|
|
self.assertFalse(actual.can_remove)
|
|
|
|
async def test_detail_rejects_missing_pallet(self) -> None:
|
|
with (
|
|
patch.object(MasterDao, 'get_pallet', new=AsyncMock(return_value=None)),
|
|
self.assertRaises(ServiceException) as raised,
|
|
):
|
|
await PalletService.detail_pallet(self.db, pallet_id=404)
|
|
|
|
self.assertEqual('托盘不存在', raised.exception.message)
|
|
|
|
async def test_edit_updates_only_mutable_fields_with_server_audit(self) -> None:
|
|
edit = PalletEditModel(palletId=3, capacityPackages=12, assetStatus='1', remark='停用')
|
|
updated_at = datetime(2026, 7, 26, 12, 30)
|
|
update_pallet = AsyncMock()
|
|
lock_actions: list[str] = []
|
|
|
|
async def get_pallet(*_args: Any, **_kwargs: Any) -> SimpleNamespace:
|
|
lock_actions.append('pallet')
|
|
return make_pallet_record(3)
|
|
|
|
async def get_inventory(*_args: Any, **_kwargs: Any) -> SimpleNamespace:
|
|
lock_actions.append('inventory')
|
|
return SimpleNamespace(remaining_packages=12)
|
|
|
|
get_pallet_mock = AsyncMock(side_effect=get_pallet)
|
|
get_inventory_mock = AsyncMock(side_effect=get_inventory)
|
|
with (
|
|
patch.object(MasterDao, 'get_pallet', new=get_pallet_mock),
|
|
patch.object(MasterDao, 'get_pallet_inventory', new=get_inventory_mock),
|
|
patch.object(MasterDao, 'update_pallet', new=update_pallet),
|
|
patch.object(pallet_service_module, 'datetime') as service_datetime,
|
|
):
|
|
service_datetime.now.return_value = updated_at
|
|
result = await PalletService.edit_pallet(self.db, edit, current_user_name='admin')
|
|
|
|
update_pallet.assert_awaited_once_with(
|
|
self.db,
|
|
edit,
|
|
update_by='admin',
|
|
update_time=updated_at,
|
|
)
|
|
self.assertEqual(['inventory', 'pallet'], lock_actions)
|
|
get_pallet_mock.assert_awaited_once_with(self.db, 3, for_update=True)
|
|
get_inventory_mock.assert_awaited_once_with(self.db, 3, for_update=True)
|
|
self.db.commit.assert_awaited_once()
|
|
self.db.rollback.assert_not_awaited()
|
|
self.assertTrue(result.is_success)
|
|
|
|
async def test_edit_rejects_capacity_below_remaining_packages(self) -> None:
|
|
edit = PalletEditModel(palletId=3, capacityPackages=11, assetStatus='0')
|
|
update_pallet = AsyncMock()
|
|
with (
|
|
patch.object(MasterDao, 'get_pallet', new=AsyncMock(return_value=make_pallet_record(3))),
|
|
patch.object(
|
|
MasterDao,
|
|
'get_pallet_inventory',
|
|
new=AsyncMock(return_value=SimpleNamespace(remaining_packages=12)),
|
|
),
|
|
patch.object(MasterDao, 'update_pallet', new=update_pallet),
|
|
self.assertRaises(ServiceException) as raised,
|
|
):
|
|
await PalletService.edit_pallet(self.db, edit, current_user_name='admin')
|
|
|
|
self.assertEqual('托盘容量不能小于当前剩余包数', raised.exception.message)
|
|
update_pallet.assert_not_awaited()
|
|
self.db.commit.assert_not_awaited()
|
|
self.db.rollback.assert_awaited_once()
|
|
|
|
async def test_edit_rejects_missing_inventory(self) -> None:
|
|
edit = PalletEditModel(palletId=3, capacityPackages=20, assetStatus='0')
|
|
with (
|
|
patch.object(MasterDao, 'get_pallet', new=AsyncMock(return_value=make_pallet_record(3))),
|
|
patch.object(MasterDao, 'get_pallet_inventory', new=AsyncMock(return_value=None)),
|
|
self.assertRaises(ServiceException) as raised,
|
|
):
|
|
await PalletService.edit_pallet(self.db, edit, current_user_name='admin')
|
|
|
|
self.assertEqual('托盘库存不存在', raised.exception.message)
|
|
self.db.rollback.assert_awaited_once()
|
|
|
|
|
|
class TestPalletRemovalService(unittest.IsolatedAsyncioTestCase):
|
|
def setUp(self) -> None:
|
|
self.db = MagicMock(spec=AsyncSession)
|
|
|
|
async def test_batch_remove_preflights_all_then_deletes_inventory_before_pallet(self) -> None:
|
|
actions: list[str] = []
|
|
|
|
async def get_pallet(
|
|
_db: AsyncSession,
|
|
pallet_id: int,
|
|
*,
|
|
for_update: bool = False,
|
|
) -> SimpleNamespace:
|
|
actions.append(f'get-pallet-{pallet_id}-{for_update}')
|
|
return make_pallet_record(pallet_id)
|
|
|
|
async def get_inventory(
|
|
_db: AsyncSession,
|
|
pallet_id: int,
|
|
*,
|
|
for_update: bool = False,
|
|
) -> SimpleNamespace:
|
|
actions.append(f'get-inventory-{pallet_id}-{for_update}')
|
|
return SimpleNamespace(flow_state='UNSTOCKED')
|
|
|
|
async def count_events(_db: AsyncSession, pallet_id: int) -> int:
|
|
actions.append(f'count-events-{pallet_id}')
|
|
return 0
|
|
|
|
async def delete_inventory(_db: AsyncSession, pallet_id: int) -> None:
|
|
actions.append(f'delete-inventory-{pallet_id}')
|
|
|
|
async def delete_pallet(_db: AsyncSession, pallet_id: int) -> None:
|
|
actions.append(f'delete-pallet-{pallet_id}')
|
|
|
|
async def commit() -> None:
|
|
actions.append('commit')
|
|
|
|
self.db.commit.side_effect = commit
|
|
with (
|
|
patch.object(MasterDao, 'get_pallet', new=AsyncMock(side_effect=get_pallet)),
|
|
patch.object(MasterDao, 'get_pallet_inventory', new=AsyncMock(side_effect=get_inventory)),
|
|
patch.object(MasterDao, 'count_pallet_events', new=AsyncMock(side_effect=count_events)),
|
|
patch.object(MasterDao, 'delete_pallet_inventory', new=AsyncMock(side_effect=delete_inventory)),
|
|
patch.object(MasterDao, 'delete_pallet', new=AsyncMock(side_effect=delete_pallet)),
|
|
):
|
|
result = await PalletService.remove_pallet(self.db, DeletePalletModel(palletIds=[5, 4]))
|
|
|
|
self.assertEqual(
|
|
[
|
|
'get-inventory-4-True',
|
|
'get-pallet-4-True',
|
|
'count-events-4',
|
|
'get-inventory-5-True',
|
|
'get-pallet-5-True',
|
|
'count-events-5',
|
|
'delete-inventory-4',
|
|
'delete-pallet-4',
|
|
'delete-inventory-5',
|
|
'delete-pallet-5',
|
|
'commit',
|
|
],
|
|
actions,
|
|
)
|
|
self.db.commit.assert_awaited_once()
|
|
self.db.rollback.assert_not_awaited()
|
|
self.assertTrue(result.is_success)
|
|
|
|
async def test_remove_rejects_invalid_state_before_any_delete(self) -> None:
|
|
cases = (
|
|
('托盘不存在', None, None, 0),
|
|
('托盘库存不存在', make_pallet_record(4), None, 0),
|
|
(
|
|
'托盘未处于未入库状态，不能删除',
|
|
make_pallet_record(4),
|
|
SimpleNamespace(flow_state='EMPTY_IN_WAREHOUSE'),
|
|
0,
|
|
),
|
|
(
|
|
'托盘已有流转事件，不能删除',
|
|
make_pallet_record(4),
|
|
SimpleNamespace(flow_state='UNSTOCKED'),
|
|
1,
|
|
),
|
|
)
|
|
for message, pallet, inventory, event_count in cases:
|
|
with self.subTest(message=message):
|
|
self.db.reset_mock()
|
|
delete_inventory = AsyncMock()
|
|
delete_pallet = AsyncMock()
|
|
with (
|
|
patch.object(MasterDao, 'get_pallet', new=AsyncMock(return_value=pallet)),
|
|
patch.object(MasterDao, 'get_pallet_inventory', new=AsyncMock(return_value=inventory)),
|
|
patch.object(MasterDao, 'count_pallet_events', new=AsyncMock(return_value=event_count)),
|
|
patch.object(MasterDao, 'delete_pallet_inventory', new=delete_inventory),
|
|
patch.object(MasterDao, 'delete_pallet', new=delete_pallet),
|
|
self.assertRaises(ServiceException) as raised,
|
|
):
|
|
await PalletService.remove_pallet(self.db, 4)
|
|
|
|
self.assertEqual(message, raised.exception.message)
|
|
delete_inventory.assert_not_awaited()
|
|
delete_pallet.assert_not_awaited()
|
|
self.db.commit.assert_not_awaited()
|
|
self.db.rollback.assert_awaited_once()
|
|
|
|
async def test_remove_integrity_error_rolls_back_with_stable_failure(self) -> None:
|
|
with (
|
|
patch.object(MasterDao, 'get_pallet', new=AsyncMock(return_value=make_pallet_record(4))),
|
|
patch.object(
|
|
MasterDao,
|
|
'get_pallet_inventory',
|
|
new=AsyncMock(return_value=SimpleNamespace(flow_state='UNSTOCKED')),
|
|
),
|
|
patch.object(MasterDao, 'count_pallet_events', new=AsyncMock(return_value=0)),
|
|
patch.object(MasterDao, 'delete_pallet_inventory', new=AsyncMock()),
|
|
patch.object(MasterDao, 'delete_pallet', new=AsyncMock(side_effect=integrity_error())),
|
|
self.assertRaises(ServiceException) as raised,
|
|
):
|
|
await PalletService.remove_pallet(self.db, 4)
|
|
|
|
self.assertEqual('删除托盘失败，托盘状态或关联数据已变化', raised.exception.message)
|
|
self.db.rollback.assert_awaited_once()
|
|
self.db.commit.assert_not_awaited()
|
|
|
|
|
|
class TestBusinessUserAssignmentService(unittest.IsolatedAsyncioTestCase):
|
|
def setUp(self) -> None:
|
|
self.db = MagicMock(spec=AsyncSession)
|
|
self.users = [
|
|
SimpleNamespace(
|
|
user_id=2,
|
|
user_name='alice',
|
|
nick_name='艾丽丝',
|
|
password='secret-a',
|
|
email='alice@example.com',
|
|
phonenumber='13800000000',
|
|
),
|
|
SimpleNamespace(
|
|
user_id=5,
|
|
user_name='bob',
|
|
nick_name=None,
|
|
password='secret-b',
|
|
email='bob@example.com',
|
|
phonenumber='13900000000',
|
|
),
|
|
]
|
|
|
|
async def test_assignment_get_returns_only_safe_fields_with_assigned_marker(self) -> None:
|
|
cases = (
|
|
('warehouse', 7, [7], []),
|
|
('site', 9, [9], []),
|
|
)
|
|
for resource, resource_id, first_ids, second_ids in cases:
|
|
with self.subTest(resource=resource):
|
|
association_method = f'list_user_{resource}_ids'
|
|
with (
|
|
patch.object(
|
|
MasterDao,
|
|
f'get_{resource}',
|
|
new=AsyncMock(return_value=SimpleNamespace()),
|
|
),
|
|
patch.object(MasterDao, 'list_assignable_users', new=AsyncMock(return_value=self.users)),
|
|
patch.object(
|
|
AccessDao,
|
|
association_method,
|
|
new=AsyncMock(side_effect=[first_ids, second_ids]),
|
|
) as list_ids,
|
|
):
|
|
actual = await getattr(PalletService, f'list_{resource}_users')(self.db, resource_id)
|
|
|
|
self.assertEqual(
|
|
[
|
|
{'userId': 2, 'userName': 'alice', 'nickName': '艾丽丝', 'assigned': True},
|
|
{'userId': 5, 'userName': 'bob', 'nickName': None, 'assigned': False},
|
|
],
|
|
[option.model_dump(by_alias=True) for option in actual],
|
|
)
|
|
self.assertTrue(all(isinstance(option, BusinessUserOptionModel) for option in actual))
|
|
self.assertEqual(
|
|
[(self.db, 2), (self.db, 5)],
|
|
[call.args for call in list_ids.await_args_list],
|
|
)
|
|
|
|
async def test_assignment_get_rejects_missing_resource_before_user_query(self) -> None:
|
|
cases = (('warehouse', 7, '仓库不存在'), ('site', 9, '客户现场不存在'))
|
|
for resource, resource_id, message in cases:
|
|
with self.subTest(resource=resource):
|
|
list_users = AsyncMock()
|
|
with (
|
|
patch.object(MasterDao, f'get_{resource}', new=AsyncMock(return_value=None)),
|
|
patch.object(MasterDao, 'list_assignable_users', new=list_users),
|
|
self.assertRaises(ServiceException) as raised,
|
|
):
|
|
await getattr(PalletService, f'list_{resource}_users')(self.db, resource_id)
|
|
|
|
self.assertEqual(message, raised.exception.message)
|
|
list_users.assert_not_awaited()
|
|
|
|
async def test_assignment_put_validates_users_replaces_and_commits(self) -> None:
|
|
assignment = UserAssignModel(userIds=[2, 5])
|
|
for resource, resource_id in (('warehouse', 7), ('site', 9)):
|
|
with self.subTest(resource=resource):
|
|
self.db.reset_mock()
|
|
replace = AsyncMock()
|
|
with (
|
|
patch.object(
|
|
MasterDao,
|
|
f'get_{resource}',
|
|
new=AsyncMock(return_value=SimpleNamespace()),
|
|
),
|
|
patch.object(
|
|
MasterDao,
|
|
'list_assignable_users_by_ids',
|
|
new=AsyncMock(return_value=self.users),
|
|
) as list_users,
|
|
patch.object(AccessDao, f'replace_{resource}_users', new=replace),
|
|
):
|
|
result = await getattr(PalletService, f'assign_{resource}_users')(
|
|
self.db,
|
|
resource_id,
|
|
assignment,
|
|
)
|
|
|
|
list_users.assert_awaited_once_with(self.db, [2, 5])
|
|
replace.assert_awaited_once_with(self.db, resource_id, [2, 5])
|
|
self.db.commit.assert_awaited_once()
|
|
self.db.rollback.assert_not_awaited()
|
|
self.assertTrue(result.is_success)
|
|
|
|
async def test_assignment_put_rejects_missing_disabled_or_deleted_user(self) -> None:
|
|
replace = AsyncMock()
|
|
assignment = UserAssignModel(userIds=[2, 5])
|
|
with (
|
|
patch.object(MasterDao, 'get_warehouse', new=AsyncMock(return_value=SimpleNamespace())),
|
|
patch.object(
|
|
MasterDao,
|
|
'list_assignable_users_by_ids',
|
|
new=AsyncMock(return_value=[self.users[0]]),
|
|
),
|
|
patch.object(AccessDao, 'replace_warehouse_users', new=replace),
|
|
self.assertRaises(ServiceException) as raised,
|
|
):
|
|
await PalletService.assign_warehouse_users(self.db, 7, assignment)
|
|
|
|
self.assertEqual('存在不存在、停用或已删除的用户', raised.exception.message)
|
|
replace.assert_not_awaited()
|
|
self.db.commit.assert_not_awaited()
|
|
self.db.rollback.assert_awaited_once()
|
|
|
|
async def test_replace_failure_rolls_back_and_preserves_original_exception(self) -> None:
|
|
assignment = UserAssignModel(userIds=[2, 5])
|
|
with (
|
|
patch.object(MasterDao, 'get_site', new=AsyncMock(return_value=SimpleNamespace())),
|
|
patch.object(
|
|
MasterDao,
|
|
'list_assignable_users_by_ids',
|
|
new=AsyncMock(return_value=self.users),
|
|
),
|
|
patch.object(
|
|
AccessDao,
|
|
'replace_site_users',
|
|
new=AsyncMock(side_effect=RuntimeError('replace failed')),
|
|
),
|
|
self.assertRaisesRegex(RuntimeError, 'replace failed'),
|
|
):
|
|
await PalletService.assign_site_users(self.db, 9, assignment)
|
|
|
|
self.db.commit.assert_not_awaited()
|
|
self.db.rollback.assert_awaited_once()
|
|
|
|
async def test_assignment_commit_failure_rolls_back(self) -> None:
|
|
assignment = UserAssignModel(userIds=[2, 5])
|
|
self.db.commit.side_effect = RuntimeError('commit failed')
|
|
with (
|
|
patch.object(MasterDao, 'get_warehouse', new=AsyncMock(return_value=SimpleNamespace())),
|
|
patch.object(
|
|
MasterDao,
|
|
'list_assignable_users_by_ids',
|
|
new=AsyncMock(return_value=self.users),
|
|
),
|
|
patch.object(AccessDao, 'replace_warehouse_users', new=AsyncMock()),
|
|
self.assertRaisesRegex(RuntimeError, 'commit failed'),
|
|
):
|
|
await PalletService.assign_warehouse_users(self.db, 7, assignment)
|
|
|
|
self.db.rollback.assert_awaited_once()
|
|
|
|
async def test_assignment_integrity_error_has_stable_message_and_rolls_back(self) -> None:
|
|
assignment = UserAssignModel(userIds=[2, 5])
|
|
with (
|
|
patch.object(MasterDao, 'get_warehouse', new=AsyncMock(return_value=SimpleNamespace())),
|
|
patch.object(
|
|
MasterDao,
|
|
'list_assignable_users_by_ids',
|
|
new=AsyncMock(return_value=self.users),
|
|
),
|
|
patch.object(
|
|
AccessDao,
|
|
'replace_warehouse_users',
|
|
new=AsyncMock(side_effect=integrity_error()),
|
|
),
|
|
self.assertRaises(ServiceException) as raised,
|
|
):
|
|
await PalletService.assign_warehouse_users(self.db, 7, assignment)
|
|
|
|
self.assertEqual('分配仓库用户失败，关联数据无效', raised.exception.message)
|
|
self.db.rollback.assert_awaited_once()
|
|
|
|
|
|
class TestPalletAndAssignmentControllers(unittest.IsolatedAsyncioTestCase):
|
|
@staticmethod
|
|
def _routers() -> tuple[Any, ...]:
|
|
return (
|
|
pallet_controller_module.pallet_controller,
|
|
warehouse_controller_module.warehouse_user_controller,
|
|
site_controller_module.site_user_controller,
|
|
)
|
|
|
|
@classmethod
|
|
def _routes(cls) -> dict[tuple[str, str], APIRoute]:
|
|
routes = {}
|
|
for router in cls._routers():
|
|
for route in router.routes:
|
|
if isinstance(route, APIRoute):
|
|
routes[(route.path, next(iter(route.methods)))] = route
|
|
return routes
|
|
|
|
def test_openapi_has_all_pallet_and_assignment_operations(self) -> None:
|
|
app = FastAPI()
|
|
for router in self._routers():
|
|
app.include_router(router)
|
|
schema = app.openapi()
|
|
|
|
expected_operations = {
|
|
('/master/pallet/list', 'get'),
|
|
('/master/pallet/{pallet_id}', 'get'),
|
|
('/master/pallet', 'post'),
|
|
('/master/pallet', 'put'),
|
|
('/master/pallet/{pallet_ids}', 'delete'),
|
|
('/master/pallet/{pallet_id}/qrcode', 'get'),
|
|
('/master/warehouse/{warehouse_id}/users', 'get'),
|
|
('/master/warehouse/{warehouse_id}/users', 'put'),
|
|
('/master/site/{site_id}/users', 'get'),
|
|
('/master/site/{site_id}/users', 'put'),
|
|
}
|
|
for path, method in expected_operations:
|
|
with self.subTest(path=path, method=method):
|
|
self.assertIn(path, schema['paths'])
|
|
self.assertIn(method, schema['paths'][path])
|
|
self.assertIn(
|
|
'image/png',
|
|
schema['paths']['/master/pallet/{pallet_id}/qrcode']['get']['responses']['200']['content'],
|
|
)
|
|
|
|
def test_route_response_models_are_exact(self) -> None:
|
|
routes = self._routes()
|
|
self.assertEqual(
|
|
PageResponseModel[PalletModel],
|
|
routes[('/master/pallet/list', 'GET')].response_model,
|
|
)
|
|
self.assertEqual(
|
|
DataResponseModel[PalletModel],
|
|
routes[('/master/pallet/{pallet_id}', 'GET')].response_model,
|
|
)
|
|
for path, method in (
|
|
('/master/pallet', 'POST'),
|
|
('/master/pallet', 'PUT'),
|
|
('/master/pallet/{pallet_ids}', 'DELETE'),
|
|
('/master/warehouse/{warehouse_id}/users', 'PUT'),
|
|
('/master/site/{site_id}/users', 'PUT'),
|
|
):
|
|
self.assertEqual(ResponseBaseModel, routes[(path, method)].response_model)
|
|
user_response = DataResponseModel[list[BusinessUserOptionModel]]
|
|
self.assertEqual(
|
|
user_response,
|
|
routes[('/master/warehouse/{warehouse_id}/users', 'GET')].response_model,
|
|
)
|
|
self.assertEqual(
|
|
user_response,
|
|
routes[('/master/site/{site_id}/users', 'GET')].response_model,
|
|
)
|
|
self.assertIsNone(routes[('/master/pallet/{pallet_id}/qrcode', 'GET')].response_model)
|
|
|
|
def test_permissions_are_exact_and_all_routes_require_pre_auth(self) -> None:
|
|
expected_permissions = {
|
|
('/master/pallet/list', 'GET'): 'master:pallet:list',
|
|
('/master/pallet/{pallet_id}', 'GET'): 'master:pallet:query',
|
|
('/master/pallet', 'POST'): 'master:pallet:add',
|
|
('/master/pallet', 'PUT'): 'master:pallet:edit',
|
|
('/master/pallet/{pallet_ids}', 'DELETE'): 'master:pallet:remove',
|
|
('/master/pallet/{pallet_id}/qrcode', 'GET'): 'master:pallet:print',
|
|
('/master/warehouse/{warehouse_id}/users', 'GET'): 'master:warehouse:assign',
|
|
('/master/warehouse/{warehouse_id}/users', 'PUT'): 'master:warehouse:assign',
|
|
('/master/site/{site_id}/users', 'GET'): 'master:site:assign',
|
|
('/master/site/{site_id}/users', 'PUT'): 'master:site:assign',
|
|
}
|
|
|
|
actual_permissions = {}
|
|
for key, route in self._routes().items():
|
|
dependencies = [
|
|
dependency.dependency
|
|
for dependency in route.dependencies
|
|
if isinstance(dependency.dependency, CheckUserInterfaceAuth)
|
|
]
|
|
self.assertEqual(1, len(dependencies))
|
|
self.assertTrue(any(isinstance(dependency.dependency, PreAuth) for dependency in route.dependencies))
|
|
actual_permissions[key] = dependencies[0].perm
|
|
|
|
self.assertEqual(expected_permissions, actual_permissions)
|
|
self.assertEqual(8, len(set(actual_permissions.values())))
|
|
|
|
def test_write_routes_have_log_and_current_user(self) -> None:
|
|
write_routes = (
|
|
('/master/pallet', 'POST'),
|
|
('/master/pallet', 'PUT'),
|
|
('/master/pallet/{pallet_ids}', 'DELETE'),
|
|
('/master/warehouse/{warehouse_id}/users', 'PUT'),
|
|
('/master/site/{site_id}/users', 'PUT'),
|
|
)
|
|
routes = self._routes()
|
|
for key in write_routes:
|
|
route = routes[key]
|
|
self.assertTrue(hasattr(route.endpoint, '__wrapped__'))
|
|
self.assertTrue(
|
|
any(
|
|
dependency.name == 'current_user' and dependency.call == LoginService.get_current_user
|
|
for dependency in route.dependant.dependencies
|
|
)
|
|
)
|
|
|
|
def test_qrcode_route_is_declared_before_dynamic_detail(self) -> None:
|
|
route_paths = [route.path for route in pallet_controller_module.pallet_controller.routes]
|
|
self.assertLess(
|
|
route_paths.index('/master/pallet/{pallet_id}/qrcode'),
|
|
route_paths.index('/master/pallet/{pallet_id}'),
|
|
)
|
|
|
|
async def test_qrcode_endpoint_returns_real_image_png_body(self) -> None:
|
|
png = PalletService.render_qr_png('persisted-token')
|
|
db = MagicMock(spec=AsyncSession)
|
|
with patch.object(PalletService, 'get_pallet_qrcode', new=AsyncMock(return_value=png)) as get_qrcode:
|
|
response = await pallet_controller_module.query_master_pallet_qrcode(
|
|
request=MagicMock(),
|
|
pallet_id=7,
|
|
query_db=db,
|
|
)
|
|
|
|
get_qrcode.assert_awaited_once_with(db, 7)
|
|
self.assertEqual('image/png', response.media_type)
|
|
self.assertEqual(b'\x89PNG\r\n\x1a\n', response.body[:8])
|
|
|
|
def test_controller_sources_do_not_require_system_user_list_or_cache(self) -> None:
|
|
sources = '\n'.join(
|
|
inspect.getsource(module)
|
|
for module in (
|
|
pallet_controller_module,
|
|
warehouse_controller_module,
|
|
site_controller_module,
|
|
)
|
|
)
|
|
self.assertNotIn('system:user:list', sources)
|
|
self.assertNotIn('ApiCache', sources)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
unittest.main()
|