feat: add boxing module API — GET /box/info and POST /box

- Add box schemas (BoxInfoResponse, BoxSaveRequest, BoxSaveResponse)
- Add box service with ERP view query and save logic (supports many2one append)
- Add box router with GET /box/info and POST /box endpoints
- Register exception handlers for InvalidZongpaiError, ZongpaiNotFoundError, DuplicateBoxItemError
- Update RequestValidationError handler to cover INVALID_BOX_NO and INVALID_QUANTITY
- Add 7 integration tests for box API

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

app/main.py

@@ -3,11 +3,14 @@ from fastapi.exceptions import RequestValidationError
 from fastapi.responses import JSONResponse
 
 from app.api.v1.location import router as location_router
+from app.api.v1.box import router as box_router
 from app.services.location_service import DuplicateLocationError
+from app.services.box_service import ZongpaiNotFoundError, DuplicateBoxItemError, InvalidZongpaiError
 
 app = FastAPI(title="CargoTrace API", version="0.1.0")
 
 app.include_router(location_router, prefix="/CargoTrace")
+app.include_router(box_router, prefix="/CargoTrace")
 
 
 @app.exception_handler(DuplicateLocationError)
@@ -27,7 +30,7 @@ async def duplicate_location_handler(request: Request, exc: DuplicateLocationErr
 async def validation_error_handler(request: Request, exc: RequestValidationError):
     for err in exc.errors():
         msg = err.get("msg", "")
-        if "INVALID_ZONGPAI" in msg or "INVALID_LOCATION" in msg:
+        if "INVALID_ZONGPAI" in msg or "INVALID_LOCATION" in msg or "INVALID_BOX_NO" in msg or "INVALID_QUANTITY" in msg:
             error_code = msg.replace("Value error, ", "")
             return JSONResponse(
                 status_code=400,
@@ -54,6 +57,41 @@ async def value_error_handler(request: Request, exc: ValueError):
     )
 
 
+@app.exception_handler(InvalidZongpaiError)
+async def invalid_zongpai_handler(request: Request, exc: InvalidZongpaiError):
+    return JSONResponse(
+        status_code=400,
+        content={
+            "error_code": "INVALID_ZONGPAI",
+            "message": "总排号格式不合法",
+        },
+    )
+
+
+@app.exception_handler(ZongpaiNotFoundError)
+async def zongpai_not_found_handler(request: Request, exc: ZongpaiNotFoundError):
+    return JSONResponse(
+        status_code=404,
+        content={
+            "error_code": "ZONGPAI_NOT_FOUND",
+            "message": "未找到该总排号对应的排产号信息",
+        },
+    )
+
+
+@app.exception_handler(DuplicateBoxItemError)
+async def duplicate_box_handler(request: Request, exc: DuplicateBoxItemError):
+    return JSONResponse(
+        status_code=409,
+        content={
+            "error_code": "DUPLICATE_BOX_NO",
+            "message": f"排产号 {exc.paichan_no} 下箱号 {exc.box_no} 已存在",
+            "paichan_no": exc.paichan_no,
+            "box_no": exc.box_no,
+        },
+    )
+
+
 @app.get("/")
 async def root():
     return {"message": "Welcome to CargoTrace API"}