hankin
815cbf9d8c
- 更新 .gitignore：全面覆盖环境变量、数据库、日志、缓存、上传文件 - 移除误跟踪的 server/venv/、crm_data.db、.env 文件 - 新增 server/.env.example 模板 - 新增合同管理、利润核算、AI教练等功能模块 - 新增 Playwright e2e 测试套件 - 前后端多项功能升级和 bug 修复
93 lines
3.6 KiB
Python
93 lines
3.6 KiB
Python
"""
|
|
销项发票路由 —— /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, get_current_company_id
|
|
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),
|
|
company_id: uuid.UUID = Depends(get_current_company_id),
|
|
) -> dict:
|
|
result = await svc.create_invoice(db, current_user, body, company_id)
|
|
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),
|
|
company_id: uuid.UUID = Depends(get_current_company_id),
|
|
) -> dict:
|
|
result = await svc.list_invoices(
|
|
db, page, size, customer_name, invoice_number,
|
|
payment_status, start_date, end_date, company_id,
|
|
)
|
|
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="回款状态更新成功")
|