v0.1.0: CRM/ERP 系统内测版本 - 安全加固完成
- Docker bridge 网络隔离（8000 端口封死） - Gunicorn 4 Worker 多进程 - Alembic 数据库迁移基线 - 日志轮转 20m×3 - JWT 密钥 + DB 密码 + CORS 收紧 - 3-2-1 备份链路（NAS + R740-B 冷备） - 连接池 pool_pre_ping + pool_recycle=3600
This commit is contained in:
hankin
@@ -0,0 +1,35 @@
|
||||
"""
|
||||
Action Card 协议 v1 Schema & 回调处理
|
||||
"""
|
||||
from __future__ import annotations
|
||||
from pydantic import BaseModel
|
||||
|
||||
|
||||
class ActionCardField(BaseModel):
|
||||
label: str
|
||||
value: str
|
||||
editable: bool = False
|
||||
|
||||
|
||||
class ActionButton(BaseModel):
|
||||
key: str # "confirm" | "cancel" | "edit"
|
||||
label: str # "确认建单" | "取消"
|
||||
style: str = "primary" # "primary" | "danger" | "default"
|
||||
|
||||
|
||||
class ActionCardPayload(BaseModel):
|
||||
card_id: str # 前端生成的唯一 ID
|
||||
card_type: str # "create_order" | "create_customer" | "create_shipping" ...
|
||||
title: str
|
||||
summary: str
|
||||
fields: list[ActionCardField] = []
|
||||
actions: list[ActionButton] = []
|
||||
params: dict = {} # 原始工具参数，回调时传回
|
||||
|
||||
|
||||
class ActionCardCallback(BaseModel):
|
||||
"""前端点击确认/取消后的回调请求"""
|
||||
card_id: str | None = None
|
||||
card_type: str
|
||||
action_key: str # "confirm" | "cancel"
|
||||
params: dict = {} # 可能被用户在卡片上修改过的参数
|
||||
@@ -0,0 +1,41 @@
|
||||
"""
|
||||
Auth 相关 Pydantic V2 Schema
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
# ── 登录请求 ──────────────────────────────────────────────
|
||||
class LoginRequest(BaseModel):
|
||||
username: str = Field(..., min_length=1, max_length=50, examples=["admin"])
|
||||
password: str = Field(..., min_length=1, max_length=128, examples=["123456"])
|
||||
|
||||
|
||||
# ── Token 响应 ────────────────────────────────────────────
|
||||
class TokenResponse(BaseModel):
|
||||
access_token: str
|
||||
token_type: str = "bearer"
|
||||
|
||||
|
||||
# ── 当前用户信息（从 JWT 解析 + DB 查表组合而来）──────────
|
||||
class CurrentUserPayload(BaseModel):
|
||||
"""注入到 Dependency 中的用户权限上下文"""
|
||||
user_id: uuid.UUID
|
||||
username: str
|
||||
real_name: str | None = None
|
||||
dept_id: uuid.UUID | None = None
|
||||
dept_name: str | None = None
|
||||
role_id: uuid.UUID | None = None
|
||||
role_name: str | None = None
|
||||
data_scope: str = "self" # all / dept_and_sub / self
|
||||
menu_keys: list[str] = Field(default_factory=list)
|
||||
|
||||
|
||||
# ── 修改密码请求 ────────────────────────────────────
|
||||
class UpdatePasswordRequest(BaseModel):
|
||||
old_password: str = Field(..., min_length=1, max_length=128)
|
||||
new_password: str = Field(..., min_length=6, max_length=128, description="新密码至少6位")
|
||||
@@ -0,0 +1,66 @@
|
||||
"""
|
||||
CRM 客户域 Pydantic V2 Schemas
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from datetime import datetime
|
||||
|
||||
from typing import Any
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
# ── 创建 ──────────────────────────────────────────────────
|
||||
class CustomerCreate(BaseModel):
|
||||
name: str = Field(..., min_length=1, max_length=200, examples=["中石化润滑油公司"])
|
||||
level: str = Field(default="C", pattern=r"^[ABC]$")
|
||||
industry: str | None = Field(default=None, max_length=100)
|
||||
contact: str | None = Field(default=None, max_length=50)
|
||||
phone: str | None = Field(default=None, max_length=30)
|
||||
email: str | None = Field(default=None, max_length=100)
|
||||
address: str | None = None
|
||||
status: int = Field(default=1, ge=0, le=1)
|
||||
|
||||
|
||||
# ── 更新 ──────────────────────────────────────────────────
|
||||
class CustomerUpdate(BaseModel):
|
||||
name: str | None = Field(default=None, min_length=1, max_length=200)
|
||||
level: str | None = Field(default=None, pattern=r"^[ABC]$")
|
||||
industry: str | None = Field(default=None, max_length=100)
|
||||
contact: str | None = Field(default=None, max_length=50)
|
||||
phone: str | None = Field(default=None, max_length=30)
|
||||
email: str | None = Field(default=None, max_length=100)
|
||||
address: str | None = None
|
||||
status: int | None = Field(default=None, ge=0, le=1)
|
||||
|
||||
|
||||
# ── 响应 ──────────────────────────────────────────────────
|
||||
class CustomerResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
name: str
|
||||
level: str
|
||||
industry: str | None = None
|
||||
contact: str | None = None
|
||||
phone: str | None = None
|
||||
email: str | None = None
|
||||
address: str | None = None
|
||||
ai_score: float = 0
|
||||
ai_persona: dict[str, Any] | None = None
|
||||
owner_id: uuid.UUID | None = None
|
||||
owner_name: str | None = None
|
||||
status: int = 1
|
||||
is_deleted: bool = False
|
||||
created_at: datetime
|
||||
updated_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
# ── 分页列表 ─────────────────────────────────────────────
|
||||
class CustomerListResponse(BaseModel):
|
||||
total: int
|
||||
items: list[CustomerResponse]
|
||||
page: int
|
||||
size: int
|
||||
@@ -0,0 +1,121 @@
|
||||
"""
|
||||
ERP 供应链域 Pydantic V2 Schemas
|
||||
分类树 / 产品 SKU / 库存流水
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from datetime import datetime
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 分类树
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class CategoryNode(BaseModel):
|
||||
"""递归树节点，适配前端 el-tree"""
|
||||
id: uuid.UUID
|
||||
parent_id: uuid.UUID | None = None
|
||||
name: str
|
||||
sort_order: int = 0
|
||||
children: list[CategoryNode] = Field(default_factory=list)
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
class CategoryCreate(BaseModel):
|
||||
name: str = Field(..., min_length=1, max_length=100)
|
||||
parent_id: uuid.UUID | None = None
|
||||
sort_order: int = Field(default=0)
|
||||
|
||||
|
||||
class CategoryUpdate(BaseModel):
|
||||
name: str | None = Field(default=None, min_length=1, max_length=100)
|
||||
parent_id: uuid.UUID | None = None
|
||||
sort_order: int | None = None
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 产品 SKU
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class SkuCreate(BaseModel):
|
||||
sku_code: str = Field(..., min_length=1, max_length=50, examples=["SKU-LUB-001"])
|
||||
name: str = Field(..., min_length=1, max_length=200, examples=["昆仑天润 KR9"])
|
||||
category_id: uuid.UUID | None = None
|
||||
spec: str | None = Field(default=None, max_length=100, examples=["200L/桶"])
|
||||
standard_price: float = Field(default=0, ge=0)
|
||||
stock_qty: float = Field(default=0, ge=0, description="初始库存（仅创建时可设，后续只能通过流水变更）")
|
||||
warning_threshold: float = Field(default=0, ge=0)
|
||||
unit: str = Field(default="桶", max_length=20)
|
||||
status: int = Field(default=1, ge=0, le=1)
|
||||
|
||||
|
||||
class SkuUpdate(BaseModel):
|
||||
"""
|
||||
⚠️ 架构师红线：不包含 stock_qty 字段！
|
||||
库存只能通过 InventoryFlow 事务接口变更。
|
||||
"""
|
||||
name: str | None = Field(default=None, min_length=1, max_length=200)
|
||||
category_id: uuid.UUID | None = None
|
||||
spec: str | None = Field(default=None, max_length=100)
|
||||
standard_price: float | None = Field(default=None, ge=0)
|
||||
warning_threshold: float | None = Field(default=None, ge=0)
|
||||
unit: str | None = Field(default=None, max_length=20)
|
||||
status: int | None = Field(default=None, ge=0, le=1)
|
||||
|
||||
|
||||
class SkuResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
sku_code: str
|
||||
name: str
|
||||
category_id: uuid.UUID | None = None
|
||||
category_name: str | None = None
|
||||
spec: str | None = None
|
||||
standard_price: float = 0
|
||||
stock_qty: float = 0
|
||||
warning_threshold: float = 0
|
||||
unit: str = "桶"
|
||||
status: int = 1
|
||||
created_at: datetime
|
||||
updated_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
class SkuListResponse(BaseModel):
|
||||
total: int
|
||||
items: list[SkuResponse]
|
||||
page: int
|
||||
size: int
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 库存流水
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class InventoryFlowCreate(BaseModel):
|
||||
"""库存变更请求"""
|
||||
sku_id: uuid.UUID = Field(..., description="产品 SKU ID")
|
||||
change_qty: float = Field(..., description="变更数量，正=入库 负=出库")
|
||||
reason: str = Field(
|
||||
..., max_length=50,
|
||||
description="变动原因: purchase/shipment/loss/adjust",
|
||||
examples=["purchase"],
|
||||
)
|
||||
remark: str | None = Field(default=None, description="备注")
|
||||
|
||||
|
||||
class InventoryFlowResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
sku_id: uuid.UUID
|
||||
sku_code: str | None = None
|
||||
sku_name: str | None = None
|
||||
change_qty: float
|
||||
reason: str
|
||||
remark: str | None = None
|
||||
operator_id: uuid.UUID | None = None
|
||||
operator_name: str | None = None
|
||||
created_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
@@ -0,0 +1,139 @@
|
||||
"""
|
||||
财务票据域 Pydantic V2 Schemas
|
||||
票据池 / 报销单（嵌套明细）/ 审批状态变更
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from datetime import date, datetime
|
||||
from typing import Any
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 票据池
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class InvoiceCreate(BaseModel):
|
||||
file_url: str | None = Field(default=None, max_length=500)
|
||||
merchant_name: str | None = Field(default=None, max_length=200)
|
||||
amount: float = Field(default=0, ge=0)
|
||||
invoice_date: date | None = None
|
||||
type: str = Field(default="expense", pattern=r"^(expense|customer)$")
|
||||
ai_extracted_data: dict[str, Any] = Field(
|
||||
default_factory=dict,
|
||||
description="OCR/AI 解析的结构化数据 (JSONB)",
|
||||
examples=[{"merchant": "中国石化", "amount": 580.00, "date": "2026-02-20"}],
|
||||
)
|
||||
|
||||
|
||||
class InvoiceResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
uploader_id: uuid.UUID | None = None
|
||||
uploader_name: str | None = None
|
||||
file_url: str | None = None
|
||||
merchant_name: str | None = None
|
||||
amount: float = 0
|
||||
invoice_date: date | None = None
|
||||
type: str
|
||||
ai_extracted_data: dict[str, Any] = Field(default_factory=dict)
|
||||
is_used: bool = False
|
||||
created_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
class InvoiceListResponse(BaseModel):
|
||||
total: int
|
||||
items: list[InvoiceResponse]
|
||||
page: int
|
||||
size: int
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 报销单创建（嵌套明细）
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class ExpenseDetailCreate(BaseModel):
|
||||
invoice_id: uuid.UUID = Field(..., description="关联发票 ID")
|
||||
expense_desc: str | None = Field(default=None, max_length=500)
|
||||
expense_date: date | None = Field(default=None, description="费用发生日期")
|
||||
original_type: str | None = Field(
|
||||
default=None, max_length=50, examples=["fuel", "entertainment", "travel", "office"]
|
||||
)
|
||||
offset_type: str | None = Field(default=None, max_length=50)
|
||||
amount: float = Field(..., gt=0, description="本行报销金额")
|
||||
|
||||
|
||||
class ExpenseCreate(BaseModel):
|
||||
total_amount: float = Field(..., gt=0)
|
||||
remark: str | None = None
|
||||
items: list[ExpenseDetailCreate] = Field(..., min_length=1)
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 报销明细响应
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class ExpenseDetailResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
invoice_id: uuid.UUID | None = None
|
||||
invoice_merchant: str | None = None
|
||||
invoice_amount: float | None = None
|
||||
expense_desc: str | None = None
|
||||
expense_date: date | None = None
|
||||
original_type: str | None = None
|
||||
offset_type: str | None = None
|
||||
amount: float = 0
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 报销单响应
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class ExpenseResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
system_no: str
|
||||
applicant_id: uuid.UUID
|
||||
applicant_name: str | None = None
|
||||
total_amount: float
|
||||
status: str
|
||||
remark: str | None = None
|
||||
approved_by: uuid.UUID | None = None
|
||||
approver_name: str | None = None
|
||||
approved_at: datetime | None = None
|
||||
details: list[ExpenseDetailResponse] = Field(default_factory=list)
|
||||
created_at: datetime
|
||||
updated_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
class ExpenseBriefResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
system_no: str
|
||||
applicant_id: uuid.UUID
|
||||
applicant_name: str | None = None
|
||||
total_amount: float
|
||||
status: str
|
||||
created_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
class ExpenseListResponse(BaseModel):
|
||||
total: int
|
||||
items: list[ExpenseBriefResponse]
|
||||
page: int
|
||||
size: int
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 审批状态变更
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class ExpenseStatusUpdate(BaseModel):
|
||||
action: str = Field(
|
||||
..., pattern=r"^(withdraw|approve|reject)$",
|
||||
description="状态变更动作: withdraw/approve/reject",
|
||||
)
|
||||
reason: str | None = Field(default=None, description="审批意见或驳回原因")
|
||||
@@ -0,0 +1,111 @@
|
||||
"""
|
||||
ERP 交易域 Pydantic V2 Schemas
|
||||
订单创建（嵌套明细）/ 详情响应 / 动态定价
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from datetime import date, datetime
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# B2B 动态定价
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class PriceCalculateRequest(BaseModel):
|
||||
customer_id: uuid.UUID
|
||||
sku_id: uuid.UUID
|
||||
|
||||
|
||||
class PriceCalculateResponse(BaseModel):
|
||||
sku_id: uuid.UUID
|
||||
sku_code: str
|
||||
sku_name: str
|
||||
unit_price: float
|
||||
price_source: str # "history" | "standard"
|
||||
last_order_no: str | None = None
|
||||
last_order_date: date | None = None
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 订单创建（嵌套明细）
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class OrderItemCreate(BaseModel):
|
||||
sku_id: uuid.UUID
|
||||
qty: float = Field(..., gt=0, description="订购数量")
|
||||
unit_price: float = Field(..., ge=0, description="成交单价")
|
||||
|
||||
|
||||
class OrderCreate(BaseModel):
|
||||
customer_id: uuid.UUID
|
||||
remark: str | None = None
|
||||
order_date: date | None = None
|
||||
items: list[OrderItemCreate] = Field(..., min_length=1, description="至少一个明细行")
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 订单明细响应
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class OrderItemResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
sku_id: uuid.UUID
|
||||
sku_code: str | None = None
|
||||
sku_name: str | None = None
|
||||
spec: str | None = None
|
||||
qty: float
|
||||
unit_price: float
|
||||
sub_total: float
|
||||
shipped_qty: float = 0
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 订单主表响应
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class OrderResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
order_no: str
|
||||
customer_id: uuid.UUID
|
||||
customer_name: str | None = None
|
||||
salesperson_id: uuid.UUID | None = None
|
||||
salesperson_name: str | None = None
|
||||
total_amount: float
|
||||
shipping_state: str
|
||||
payment_state: str
|
||||
paid_amount: float = 0
|
||||
remark: str | None = None
|
||||
order_date: date
|
||||
items: list[OrderItemResponse] = Field(default_factory=list)
|
||||
created_at: datetime
|
||||
updated_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 订单列表（不含 items 明细，减少传输体积）
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class OrderBriefResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
order_no: str
|
||||
customer_id: uuid.UUID
|
||||
customer_name: str | None = None
|
||||
salesperson_name: str | None = None
|
||||
total_amount: float
|
||||
shipping_state: str
|
||||
payment_state: str
|
||||
paid_amount: float = 0
|
||||
order_date: date
|
||||
created_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
class OrderListResponse(BaseModel):
|
||||
total: int
|
||||
items: list[OrderBriefResponse]
|
||||
page: int
|
||||
size: int
|
||||
@@ -0,0 +1,81 @@
|
||||
"""
|
||||
V5.0 AI 画像强约束 Pydantic Schema
|
||||
- CompanyPersona: 企业级画像 (crm_customers.ai_persona)
|
||||
- BuyerPersona: 联系人级画像 (crm_contacts.ai_buyer_persona)
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
# ═══════════════════════════════════════════════════════
|
||||
# 企业画像 (crm_customers.ai_persona)
|
||||
# ═══════════════════════════════════════════════════════
|
||||
|
||||
class Firmographics(BaseModel):
|
||||
"""企业属性"""
|
||||
industry: str | None = None
|
||||
scale: str | None = None
|
||||
business_model: str | None = None
|
||||
|
||||
|
||||
class DynamicStatus(BaseModel):
|
||||
"""时序动态"""
|
||||
pain_points: list[str] = Field(default_factory=list)
|
||||
purchase_intent: str | None = None
|
||||
recent_events: list[str] = Field(default_factory=list)
|
||||
|
||||
|
||||
class CompanyPersona(BaseModel):
|
||||
"""企业级 AI 画像 Schema"""
|
||||
firmographics: Firmographics = Field(default_factory=Firmographics)
|
||||
dynamic_status: DynamicStatus = Field(default_factory=DynamicStatus)
|
||||
summary: str | None = None
|
||||
|
||||
|
||||
# ═══════════════════════════════════════════════════════
|
||||
# 联系人画像 (crm_contacts.ai_buyer_persona)
|
||||
# ═══════════════════════════════════════════════════════
|
||||
|
||||
class BuyerRole(BaseModel):
|
||||
"""决策角色"""
|
||||
decision_role: str | None = None # 决策者 / 影响者 / 执行者
|
||||
authority_level: str | None = None # 高 / 中 / 低
|
||||
|
||||
|
||||
class BuyerKPI(BaseModel):
|
||||
"""核心痛点与目标"""
|
||||
core_goals: list[str] = Field(default_factory=list)
|
||||
pain_points: list[str] = Field(default_factory=list)
|
||||
|
||||
|
||||
class BuyerPreference(BaseModel):
|
||||
"""交互偏好"""
|
||||
comm_style: str | None = None
|
||||
meeting_preference: str | None = None
|
||||
topics_of_interest: list[str] = Field(default_factory=list)
|
||||
|
||||
|
||||
class BuyerPersona(BaseModel):
|
||||
"""联系人级 AI 画像 Schema"""
|
||||
role: BuyerRole = Field(default_factory=BuyerRole)
|
||||
kpi: BuyerKPI = Field(default_factory=BuyerKPI)
|
||||
preference: BuyerPreference = Field(default_factory=BuyerPreference)
|
||||
|
||||
|
||||
# ═══════════════════════════════════════════════════════
|
||||
# 双轨画像回写 Payload（Dify Workflow 回调用）
|
||||
# ═══════════════════════════════════════════════════════
|
||||
|
||||
class ContactPersonaUpdate(BaseModel):
|
||||
"""单个联系人画像增量"""
|
||||
contact_id: str
|
||||
role: dict | None = None
|
||||
kpi: dict | None = None
|
||||
preference: dict | None = None
|
||||
|
||||
|
||||
class PersonaUpdatePayload(BaseModel):
|
||||
"""双轨画像回写请求体"""
|
||||
company_updates: dict | None = None
|
||||
contact_updates: list[ContactPersonaUpdate] | None = None
|
||||
@@ -0,0 +1,22 @@
|
||||
"""
|
||||
统一响应 Schema
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Any, Generic, TypeVar
|
||||
|
||||
from pydantic import BaseModel
|
||||
|
||||
T = TypeVar("T")
|
||||
|
||||
|
||||
class ApiResponse(BaseModel, Generic[T]):
|
||||
code: int = 200
|
||||
data: T | None = None
|
||||
message: str = "ok"
|
||||
|
||||
|
||||
def ok(data: Any = None, message: str = "ok") -> dict:
|
||||
"""快捷返回成功响应"""
|
||||
return {"code": 200, "data": data, "message": message}
|
||||
@@ -0,0 +1,55 @@
|
||||
"""
|
||||
销项发票 Pydantic V2 Schemas
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from datetime import date, datetime
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
class SalesInvoiceCreate(BaseModel):
|
||||
issuer: str = Field(..., min_length=1, max_length=200, examples=["XX润滑油有限公司"])
|
||||
receiver_customer_id: uuid.UUID = Field(..., description="受票方客户 ID")
|
||||
invoice_number: str = Field(..., min_length=1, max_length=100, examples=["INV-20260312-001"])
|
||||
amount: float = Field(..., gt=0, description="票面金额")
|
||||
billing_date: date = Field(..., description="开票日期")
|
||||
remark: str | None = None
|
||||
|
||||
|
||||
class SalesInvoiceUpdate(BaseModel):
|
||||
payment_status: str | None = Field(
|
||||
default=None, pattern=r"^(未回款|部分回款|已结清)$",
|
||||
description="回款状态",
|
||||
)
|
||||
payment_date: date | None = None
|
||||
payment_amount: float | None = Field(default=None, ge=0, description="已回款金额")
|
||||
remark: str | None = None
|
||||
|
||||
|
||||
class SalesInvoiceResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
issuer: str
|
||||
receiver_customer_id: uuid.UUID
|
||||
customer_name: str | None = None
|
||||
invoice_number: str
|
||||
amount: float
|
||||
billing_date: date
|
||||
payment_status: str = "未回款"
|
||||
payment_date: date | None = None
|
||||
payment_amount: float = 0
|
||||
remark: str | None = None
|
||||
created_by: uuid.UUID | None = None
|
||||
creator_name: str | None = None
|
||||
created_at: datetime
|
||||
updated_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
class SalesInvoiceListResponse(BaseModel):
|
||||
total: int
|
||||
items: list[SalesInvoiceResponse]
|
||||
page: int
|
||||
size: int
|
||||
@@ -0,0 +1,95 @@
|
||||
"""
|
||||
ERP 物流域 Pydantic V2 Schemas
|
||||
发货单创建（嵌套明细）/ 列表 / 详情
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from datetime import date, datetime
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 发货明细创建
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class ShippingItemCreate(BaseModel):
|
||||
order_item_id: uuid.UUID = Field(..., description="关联的订单明细行 ID")
|
||||
sku_id: uuid.UUID = Field(..., description="产品 SKU ID")
|
||||
shipped_qty: float = Field(..., gt=0, description="本次发货数量，必须 > 0")
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 发货单创建
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class ShippingCreate(BaseModel):
|
||||
order_id: uuid.UUID = Field(..., description="关联订单 ID")
|
||||
carrier: str | None = Field(default=None, max_length=100, examples=["德邦物流"])
|
||||
tracking_no: str | None = Field(default=None, max_length=100, examples=["DB202602270001"])
|
||||
ship_date: date | None = None
|
||||
remark: str | None = None
|
||||
items: list[ShippingItemCreate] = Field(..., min_length=1, description="至少一个发货明细行")
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 发货明细响应
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class ShippingItemResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
order_item_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
|
||||
shipped_qty: float
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 发货单响应
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class ShippingResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
shipping_no: str
|
||||
order_id: uuid.UUID
|
||||
order_no: str | None = None
|
||||
customer_name: str | None = None
|
||||
carrier: str | None = None
|
||||
tracking_no: str | None = None
|
||||
status: str
|
||||
ship_date: date
|
||||
remark: str | None = None
|
||||
operator_name: str | None = None
|
||||
items: list[ShippingItemResponse] = Field(default_factory=list)
|
||||
created_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 发货列表（Brief，不带明细减少体积）
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class ShippingBriefResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
shipping_no: str
|
||||
order_id: uuid.UUID
|
||||
order_no: str | None = None
|
||||
customer_name: str | None = None
|
||||
carrier: str | None = None
|
||||
tracking_no: str | None = None
|
||||
status: str
|
||||
ship_date: date
|
||||
operator_name: str | None = None
|
||||
created_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
class ShippingListResponse(BaseModel):
|
||||
total: int
|
||||
items: list[ShippingBriefResponse]
|
||||
page: int
|
||||
size: int
|
||||
@@ -0,0 +1,114 @@
|
||||
"""
|
||||
系统设置域 Pydantic V2 Schemas
|
||||
部门树 / 角色（含 JSONB menu_keys）/ 用户管理
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from datetime import datetime
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 部门树
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class DeptNode(BaseModel):
|
||||
id: uuid.UUID
|
||||
parent_id: uuid.UUID | None = None
|
||||
name: str
|
||||
sort_order: int = 0
|
||||
status: int = 1
|
||||
children: list[DeptNode] = Field(default_factory=list)
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 角色
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class RoleCreate(BaseModel):
|
||||
role_name: str = Field(..., min_length=1, max_length=50)
|
||||
data_scope: str = Field(
|
||||
default="self", pattern=r"^(all|dept_and_sub|self)$"
|
||||
)
|
||||
menu_keys: list[str] = Field(
|
||||
default_factory=list,
|
||||
description="前端路由 name 数组，JSONB 存储",
|
||||
examples=[["CustomerList", "OrderList", "ProductList"]],
|
||||
)
|
||||
description: str | None = Field(default=None, max_length=255)
|
||||
status: int = Field(default=1, ge=0, le=1)
|
||||
|
||||
|
||||
class RoleUpdate(BaseModel):
|
||||
role_name: str | None = Field(default=None, min_length=1, max_length=50)
|
||||
data_scope: str | None = Field(default=None, pattern=r"^(all|dept_and_sub|self)$")
|
||||
menu_keys: list[str] | None = None
|
||||
description: str | None = Field(default=None, max_length=255)
|
||||
status: int | None = Field(default=None, ge=0, le=1)
|
||||
|
||||
|
||||
class RoleResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
role_name: str
|
||||
data_scope: str
|
||||
menu_keys: list[str] = Field(default_factory=list)
|
||||
description: str | None = None
|
||||
status: int = 1
|
||||
created_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
# 用户/员工
|
||||
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||||
class UserCreate(BaseModel):
|
||||
username: str = Field(..., min_length=2, max_length=50)
|
||||
password: str = Field(..., min_length=6, max_length=128, description="明文密码，后端 bcrypt 哈希后存储")
|
||||
real_name: str | None = Field(default=None, max_length=50)
|
||||
phone: str | None = Field(default=None, max_length=20)
|
||||
email: str | None = Field(default=None, max_length=100)
|
||||
dept_id: uuid.UUID | None = None
|
||||
role_id: uuid.UUID | None = None
|
||||
status: int = Field(default=1, ge=0, le=1)
|
||||
|
||||
|
||||
class UserUpdate(BaseModel):
|
||||
real_name: str | None = Field(default=None, max_length=50)
|
||||
phone: str | None = Field(default=None, max_length=20)
|
||||
email: str | None = Field(default=None, max_length=100)
|
||||
dept_id: uuid.UUID | None = None
|
||||
role_id: uuid.UUID | None = None
|
||||
status: int | None = Field(default=None, ge=0, le=1)
|
||||
|
||||
|
||||
class UserResetPassword(BaseModel):
|
||||
new_password: str = Field(..., min_length=6, max_length=128)
|
||||
|
||||
|
||||
class UserResponse(BaseModel):
|
||||
id: uuid.UUID
|
||||
username: str
|
||||
real_name: str | None = None
|
||||
phone: str | None = None
|
||||
email: str | None = None
|
||||
dept_id: uuid.UUID | None = None
|
||||
dept_name: str | None = None
|
||||
role_id: uuid.UUID | None = None
|
||||
role_name: str | None = None
|
||||
data_scope: str | None = None
|
||||
status: int = 1
|
||||
last_login_at: datetime | None = None
|
||||
created_at: datetime
|
||||
|
||||
model_config = {"from_attributes": True}
|
||||
|
||||
|
||||
class UserListResponse(BaseModel):
|
||||
total: int
|
||||
items: list[UserResponse]
|
||||
page: int
|
||||
size: int
|
||||
Reference in New Issue
Block a user