""" 销项发票路由 —— /api/finance/sales-invoices """ from __future__ import annotations import uuid from datetime import date, datetime from fastapi import APIRouter, Depends, Query from fastapi.responses import StreamingResponse from sqlalchemy.ext.asyncio import AsyncSession from app.api.deps import get_current_user from app.db.database import get_db from app.schemas.auth import CurrentUserPayload from app.schemas.sales_invoice import SalesInvoiceCreate, SalesInvoiceUpdate from app.schemas.response import ok from app.services import sales_invoice_service as svc from app.core.exceptions import ForbiddenException router = APIRouter(prefix="/finance/sales-invoices", tags=["销项发票(AR)"]) @router.post("", summary="创建销项发票") async def create_invoice( body: SalesInvoiceCreate, db: AsyncSession = Depends(get_db), current_user: CurrentUserPayload = Depends(get_current_user), ) -> dict: result = await svc.create_invoice(db, current_user, body) return ok(data=result.model_dump(mode="json"), message="销项发票创建成功") @router.get("", summary="多条件查询销项发票列表") async def list_invoices( page: int = Query(1, ge=1), size: int = Query(20, ge=1, le=100), customer_name: str | None = Query(None, description="客户名称模糊搜索"), invoice_number: str | None = Query(None, description="发票号搜索"), payment_status: str | None = Query(None, description="回款状态"), start_date: date | None = Query(None, description="开票开始日期"), end_date: date | None = Query(None, description="开票结束日期"), db: AsyncSession = Depends(get_db), current_user: CurrentUserPayload = Depends(get_current_user), ) -> dict: result = await svc.list_invoices( db, page, size, customer_name, invoice_number, payment_status, start_date, end_date, ) return ok(data=result.model_dump(mode="json")) @router.get("/export", summary="导出发票汇总及回款追踪表 (仅管理员)") async def export_invoices( start_date: date | None = Query(None), end_date: date | None = Query(None), db: AsyncSession = Depends(get_db), current_user: CurrentUserPayload = Depends(get_current_user), ): if current_user.data_scope != "all" and (current_user.role_name or "").lower() != "admin": raise ForbiddenException("仅管理员可导出发票数据") buffer = await svc.export_invoices(db, start_date, end_date) filename = f"sales_invoices_export_{datetime.now().strftime('%Y%m%d_%H%M%S')}.xlsx" return StreamingResponse( buffer, media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", headers={"Content-Disposition": f"attachment; filename={filename}"}, ) @router.get("/{invoice_id}", summary="获取销项发票详情") async def get_invoice( invoice_id: uuid.UUID, db: AsyncSession = Depends(get_db), current_user: CurrentUserPayload = Depends(get_current_user), ) -> dict: result = await svc.get_invoice(db, invoice_id) return ok(data=result.model_dump(mode="json")) @router.put("/{invoice_id}", summary="更新回款状态") async def update_invoice( invoice_id: uuid.UUID, body: SalesInvoiceUpdate, db: AsyncSession = Depends(get_db), current_user: CurrentUserPayload = Depends(get_current_user), ) -> dict: result = await svc.update_invoice(db, invoice_id, body) return ok(data=result.model_dump(mode="json"), message="回款状态更新成功")