v0.2.0: CRM/ERP 系统升级 - 清理 .gitignore 并移除误提交的 venv/env/db 文件

- 更新 .gitignore：全面覆盖环境变量、数据库、日志、缓存、上传文件 - 移除误跟踪的 server/venv/、crm_data.db、.env 文件 - 新增 server/.env.example 模板 - 新增合同管理、利润核算、AI教练等功能模块 - 新增 Playwright e2e 测试套件 - 前后端多项功能升级和 bug 修复
2026-05-11 07:24:19 +00:00
parent 0f4c6b7924
commit 815cbf9d8c
2526 changed files with 11875 additions and 804148 deletions
@@ -0,0 +1,106 @@
+"""
+合同域 Pydantic V2 Schemas
+"""
+
+from __future__ import annotations
+
+import uuid
+from datetime import date, datetime
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+
+# ── 合同明细行 ────────────────────────────────────────────
+class ContractItemCreate(BaseModel):
+    sku_id: uuid.UUID
+    qty: float = Field(gt=0)
+    unit_price: float = Field(ge=0)
+    sub_total: float = Field(ge=0)
+
+
+class ContractItemResponse(BaseModel):
+    id: uuid.UUID
+    sku_id: uuid.UUID
+    sku_code: str | None = None
+    sku_name: str | None = None
+    spec: str | None = None
+    unit: str | None = None
+    qty: float
+    unit_price: float
+    sub_total: float
+
+    model_config = {"from_attributes": True}
+
+
+# ── 合同创建 ──────────────────────────────────────────────
+class ContractCreate(BaseModel):
+    buyer_customer_id: uuid.UUID
+    items: list[ContractItemCreate] = Field(min_length=1)
+    payment_terms: str = "货到付全款"
+    shipping_terms: str = "买方自提"
+    remark: str | None = None
+    delivery_terms: str | None = None
+    sign_date: date | None = None
+
+
+# ── 合同更新 ──────────────────────────────────────────────
+class ContractUpdate(BaseModel):
+    buyer_customer_id: uuid.UUID | None = None
+    items: list[ContractItemCreate] | None = None
+    payment_terms: str | None = None
+    shipping_terms: str | None = None
+    status: str | None = None
+    is_signed: bool | None = None
+    remark: str | None = None
+    delivery_terms: str | None = None
+    sign_date: date | None = None
+
+
+# ── 执行进度 ──────────────────────────────────────────────
+class ContractProgressResponse(BaseModel):
+    is_signed: bool = False
+    has_order: bool = False
+    order_id: uuid.UUID | None = None
+    has_shipped: bool = False
+    has_invoice: bool = False
+    is_paid: bool = False
+
+
+# ── 合同响应 ──────────────────────────────────────────────
+class ContractResponse(BaseModel):
+    id: uuid.UUID
+    contract_no: str
+    buyer_customer_id: uuid.UUID
+    buyer_customer_name: str | None = None
+    seller_company_id: uuid.UUID
+    seller_company_name: str | None = None
+    company_id: uuid.UUID
+    total_amount_excl_tax: float = 0
+    total_amount_incl_tax: float = 0
+    total_amount_cn: str | None = None
+    payment_terms: str
+    shipping_terms: str
+    status: str
+    is_signed: bool = False
+    signed_file_url: str | None = None
+    linked_order_id: uuid.UUID | None = None
+    salesperson_id: uuid.UUID | None = None
+    salesperson_name: str | None = None
+    sign_date: date | None = None
+    remark: str | None = None
+    delivery_terms: str | None = None
+    items: list[ContractItemResponse] = []
+    progress: ContractProgressResponse | None = None
+    created_at: datetime
+    updated_at: datetime
+
+    model_config = {"from_attributes": True}
+
+
+# ── 分页列表 ──────────────────────────────────────────────
+class ContractListResponse(BaseModel):
+    total: int
+    items: list[ContractResponse]
+    page: int
+    size: int