Files
shanxia2.0/backend/app/models/crm_models.py
T
2026-10-02 09:28:00 +08:00

1083 lines
71 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""CRM 模块数据模型(产品分类、产品主表、统一附件表、客户管理、公海池、线索管理)"""
from datetime import datetime
from decimal import Decimal
from sqlalchemy import (
BigInteger,
Column,
DECIMAL,
Date,
DateTime,
Integer,
SmallInteger,
String,
Text,
CHAR,
)
from app.core.database import Base
class CrmProductCategory(Base):
"""CRM 产品分类表(树形结构)"""
__tablename__ = "crm_product_category"
id = Column(String(64), primary_key=True, comment="主键ID")
parent_id = Column(String(64), nullable=False, default="0", comment="父级分类ID(0为顶级)")
category_name = Column(String(128), nullable=False, comment="分类名称")
category_code = Column(String(64), nullable=True, comment="分类编码")
level = Column(SmallInteger, nullable=False, default=1, comment="层级")
status = Column(CHAR(1), nullable=False, default="1", comment="状态 1启用 0停用")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人id")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人id")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmProduct(Base):
"""CRM 产品主表"""
__tablename__ = "crm_product"
id = Column(String(64), primary_key=True, comment="主键ID")
product_no = Column(String(50), nullable=False, comment="产品编号")
product_name = Column(String(200), nullable=False, comment="产品名称")
name_pinyin_abbr = Column(String(100), nullable=True, comment="产品名称拼音首字母(小写)")
category_id = Column(String(64), nullable=True, comment="分类ID")
category_name = Column(String(100), nullable=True, comment="分类名称(冗余)")
model = Column(String(100), nullable=True, comment="规格型号")
unit = Column(String(20), nullable=True, default=None, comment="单位")
barcode = Column(String(100), nullable=True, comment="条码")
price = Column(DECIMAL(15, 2), nullable=True, default=None, comment="标准单价")
cost_price = Column(DECIMAL(15, 2), nullable=True, default=None, comment="成本价")
stock = Column(Integer, nullable=False, default=0, comment="库存数量")
low_stock = Column(Integer, nullable=False, default=10, comment="库存预警值")
tax_rate = Column(DECIMAL(5, 2), nullable=False, default=13.00, comment="税率(百分比)")
is_toxic = Column(SmallInteger, nullable=False, default=0, comment="是否易制毒 0-否 1-是")
is_explosive = Column(SmallInteger, nullable=False, default=0, comment="是否易制爆 0-否 1-是")
status = Column(String(3), nullable=False, default="on", comment="状态 on 上架 off 下架")
description = Column(Text, nullable=True, comment="产品描述")
images = Column(String(1000), nullable=True, comment="产品图片(多个用逗号分隔)")
sale_count = Column(Integer, nullable=False, default=0, comment="销售次数")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人id")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人id")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmProductBrand(Base):
"""CRM-产品品牌(按产品独立维护)"""
__tablename__ = "crm_product_brand"
id = Column(String(64), primary_key=True, comment="主键ID")
product_id = Column(String(64), nullable=False, comment="产品ID")
brand_name = Column(String(100), nullable=False, comment="品牌名称")
status = Column(String(3), nullable=False, default="on", comment="状态 on/off")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人id")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人id")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmProductAlias(Base):
"""CRM-产品别名"""
__tablename__ = "crm_product_alias"
id = Column(String(64), primary_key=True, comment="主键ID")
product_id = Column(String(64), nullable=False, comment="产品ID")
alias_name = Column(String(200), nullable=False, comment="别名")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人id")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人id")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class SysOss(Base):
"""统一附件表(全系统共用 sys_oss)"""
__tablename__ = "sys_oss"
id = Column(String(64), primary_key=True, comment="主键ID")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
biz_type = Column(String(50), nullable=True, comment="业务类型")
biz_id = Column(String(64), nullable=True, comment="业务主键ID")
file_name = Column(String(255), nullable=False, default="", comment="文件名")
original_name = Column(String(255), nullable=False, default="", comment="原始文件名")
file_suffix = Column(String(10), nullable=False, default="", comment="文件后缀名")
url = Column(String(500), nullable=False, comment="文件URL地址")
file_size = Column(BigInteger, nullable=True, comment="文件大小(字节)")
file_type = Column(String(200), nullable=True, comment="MIME类型")
attach_type = Column(String(32), nullable=True, default="attachment", comment="附件类型")
sort_order = Column(Integer, nullable=False, default=0, comment="排序号")
service = Column(String(20), nullable=False, default="minio", comment="存储服务商")
ext1 = Column(Text, nullable=True, comment="扩展字段")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人id")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人id")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
# ── 客户管理模块 ──────────────────────────────────────────────
class CrmCustomer(Base):
"""CRM-客户主表"""
__tablename__ = "crm_customer"
# 主键
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
# 业务字段
customer_no = Column(String(50), nullable=False, comment="客户编号(唯一)")
customer_name = Column(String(200), nullable=False, comment="客户名称")
name_pinyin_abbr = Column(String(100), nullable=True, comment="客户名称拼音首字母(小写)")
short_name = Column(String(100), nullable=True, comment="客户简称")
customer_type = Column(String(20), nullable=True, default="company", comment="客户类型(字典 crm_customer_type)")
mobile = Column(String(20), nullable=True, comment="手机号")
telephone = Column(String(30), nullable=True, comment="固定电话")
email = Column(String(100), nullable=True, comment="邮箱")
website = Column(String(500), nullable=True, comment="客户网站")
level = Column(
String(20), nullable=True, default="normal", comment="客户级别(字典 crm_customer_level: key/normal/potential)"
)
source = Column(String(20), nullable=True, comment="客户来源(字典 crm_clue_source)")
industry = Column(String(50), nullable=True, comment="所属行业(字典 crm_customer_industry)")
park_area = Column(String(100), nullable=True, comment="所在园区(字典 crm_customer_park)")
payment_terms = Column(String(500), nullable=True, comment="收付款条件")
scale = Column(String(20), nullable=True, comment="企业规模")
province = Column(String(50), nullable=True, comment="省")
city = Column(String(50), nullable=True, comment="市")
district = Column(String(50), nullable=True, comment="区")
address = Column(String(255), nullable=True, comment="详细地址")
# 状态与归属
status = Column(
String(20), nullable=True, default="normal", comment="客户状态(字典 crm_customer_status: normal/pool/invalid)"
)
deal_status = Column(
String(20), nullable=True, default="not_deal", comment="成交状态(字典 crm_deal_status: not_deal/dealed/lost)"
)
owner_user_id = Column(String(64), nullable=True, comment="负责人ID")
owner_user_name = Column(String(50), nullable=True, comment="负责人姓名(冗余)")
# 跟进统计
last_time = Column(DateTime, nullable=True, comment="最后跟进时间")
next_time = Column(DateTime, nullable=True, comment="下次联系时间")
follow_count = Column(Integer, nullable=True, default=0, comment="跟进次数")
# 成交统计
deal_time = Column(DateTime, nullable=True, comment="成交时间")
deal_amount = Column(DECIMAL(15, 2), nullable=True, default=Decimal("0.00"), comment="累计成交金额")
# 关联统计
contact_count = Column(Integer, nullable=True, default=0, comment="联系人数量")
opportunity_count = Column(Integer, nullable=True, default=0, comment="商机数量")
contract_count = Column(Integer, nullable=True, default=0, comment="合同数量")
# 公海池相关
into_pool_time = Column(DateTime, nullable=True, comment="进入公海时间")
into_pool_by = Column(String(64), nullable=True, comment="进入公海操作人ID")
into_pool_reason = Column(String(500), nullable=True, comment="进入公海原因")
claim_time = Column(DateTime, nullable=True, comment="领取时间")
assign_time = Column(DateTime, nullable=True, comment="分配时间")
assign_by = Column(String(64), nullable=True, comment="分配人ID")
protect_time = Column(DateTime, nullable=True, comment="保护到期时间")
# 证照附件
business_license_img = Column(String(1000), nullable=True, comment="营业执照图片(附件URL,逗号分隔)")
business_permit_images = Column(String(1000), nullable=True, comment="经营许可证图片(附件URL,逗号分隔)")
other_cert_images = Column(String(1000), nullable=True, comment="其他证件图片(附件URL,逗号分隔)")
# 线索关联
clue_id = Column(String(64), nullable=True, comment="关联线索ID(从线索转化)")
# 公共字段
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmContact(Base):
"""CRM-联系人表"""
__tablename__ = "crm_contact"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
customer_id = Column(String(64), nullable=False, comment="客户ID")
customer_name = Column(String(200), nullable=True, comment="客户名称(冗余)")
contact_name = Column(String(100), nullable=False, comment="联系人姓名")
gender = Column(String(10), nullable=True, comment="性别(male/female/unknown)")
mobile = Column(String(20), nullable=True, comment="手机号")
telephone = Column(String(30), nullable=True, comment="固定电话")
email = Column(String(100), nullable=True, comment="邮箱")
wechat = Column(String(100), nullable=True, comment="微信号")
qq = Column(String(20), nullable=True, comment="QQ号")
department = Column(String(100), nullable=True, comment="部门")
position = Column(String(50), nullable=True, comment="职位")
role = Column(String(20), nullable=True, comment="角色(decision/manager/user/other)")
birthday = Column(Date, nullable=True, comment="生日")
address = Column(String(255), nullable=True, comment="住址")
is_key = Column(SmallInteger, nullable=True, default=0, comment="是否关键决策人(0-否 1-是)")
is_primary = Column(SmallInteger, nullable=True, default=0, comment="是否主要联系人(0-否 1-是)")
status = Column(String(20), nullable=True, default="active", comment="状态(active-在职/leave-离职)")
# 公共字段
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmInvoiceInfo(Base):
"""CRM-客户开票信息表"""
__tablename__ = "crm_invoice_info"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
customer_id = Column(String(64), nullable=False, comment="客户ID")
company_name = Column(String(200), nullable=False, comment="单位名称")
tax_no = Column(String(50), nullable=True, comment="税号")
company_address = Column(String(500), nullable=True, comment="单位地址")
legal_representative = Column(String(100), nullable=True, comment="法定代表人")
agent = Column(String(100), nullable=True, comment="代理人")
phone_fax = Column(String(100), nullable=True, comment="电话/传真")
bank_name = Column(String(200), nullable=True, comment="开户银行")
bank_account = Column(String(100), nullable=True, comment="银行账号")
is_default = Column(String(1), nullable=False, default="0", comment="是否默认(0否 1是)")
# 公共字段
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmCustomerFollow(Base):
"""CRM-客户跟进记录表"""
__tablename__ = "crm_customer_follow"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
customer_id = Column(String(64), nullable=False, comment="客户ID")
customer_name = Column(String(200), nullable=True, comment="客户名称(冗余)")
contact_id = Column(String(64), nullable=True, comment="联系人ID")
contact_name = Column(String(100), nullable=True, comment="联系人姓名(冗余)")
follow_type = Column(
String(20), nullable=False, comment="跟进方式(字典 crm_follow_type: phone/wechat/visit/email/other)"
)
follow_content = Column(Text, nullable=False, comment="跟进内容")
follow_time = Column(DateTime, nullable=True, comment="跟进时间")
next_time = Column(DateTime, nullable=True, comment="下次联系时间")
attachment = Column(String(1000), nullable=True, comment="附件URL(多个用逗号分隔)")
owner_user_id = Column(String(64), nullable=True, comment="跟进人ID")
owner_user_name = Column(String(50), nullable=True, comment="跟进人姓名(冗余)")
# 公共字段
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmCustomerPool(Base):
"""CRM-客户公海池记录表"""
__tablename__ = "crm_customer_pool"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
customer_id = Column(String(64), nullable=False, comment="客户ID")
customer_name = Column(String(200), nullable=True, comment="客户名称(冗余)")
operation_type = Column(String(20), nullable=False, comment="操作类型(into-进入公海/claim-领取/assign-分配/recycle-回收)")
from_user_id = Column(String(64), nullable=True, comment="原负责人ID")
from_user_name = Column(String(50), nullable=True, comment="原负责人姓名(冗余)")
to_user_id = Column(String(64), nullable=True, comment="新负责人ID")
to_user_name = Column(String(50), nullable=True, comment="新负责人姓名(冗余)")
reason = Column(String(500), nullable=True, comment="操作原因")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者(操作人)")
create_by_name = Column(String(50), nullable=True, comment="操作人姓名(冗余)")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间(操作时间)")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmCustomerPoolRule(Base):
"""CRM-客户公海池规则表"""
__tablename__ = "crm_customer_pool_rule"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
pool_name = Column(String(100), nullable=False, comment="规则名称")
rule_type = Column(String(20), nullable=False, comment="规则类型(no_follow-未跟进/no_deal-未成交)")
timeout_days = Column(Integer, nullable=False, comment="超时天数(多少天未跟进/未成交)")
protect_days = Column(Integer, nullable=False, default=0, comment="保护期天数(领取后保护多少天)")
status = Column(String(20), nullable=True, default="enable", comment="状态(enable-启用/disable-禁用)")
sort = Column(Integer, nullable=True, default=0, comment="排序号")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmOpportunity(Base):
"""CRM-商机主表"""
__tablename__ = "crm_opportunity"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
opportunity_no = Column(String(50), nullable=False, comment="商机编号")
opportunity_name = Column(String(200), nullable=False, comment="商机名称")
customer_id = Column(String(64), nullable=False, comment="客户ID")
customer_name = Column(String(200), nullable=True, comment="客户名称(冗余)")
contact_id = Column(String(64), nullable=True, comment="联系人ID")
contact_name = Column(String(50), nullable=True, comment="联系人姓名(冗余)")
stage = Column(String(20), nullable=False, default="initial", comment="商机阶段")
stage_percent = Column(Integer, nullable=True, default=10, comment="阶段进度百分比")
status = Column(String(20), nullable=False, default="following", comment="商机状态")
win_rate = Column(DECIMAL(5, 2), nullable=True, default=Decimal("50.00"), comment="赢单率(百分比)")
amount = Column(DECIMAL(15, 2), nullable=False, default=0, comment="商机金额")
expect_deal_date = Column(Date, nullable=True, comment="预计成交日期")
actual_deal_date = Column(Date, nullable=True, comment="实际成交日期")
lost_reason = Column(String(500), nullable=True, comment="输单原因")
owner_user_id = Column(String(64), nullable=True, comment="负责人ID")
owner_user_name = Column(String(50), nullable=True, comment="负责人姓名(冗余)")
product_count = Column(Integer, nullable=True, default=0, comment="产品数量(冗余)")
last_time = Column(DateTime, nullable=True, comment="最后跟进时间")
next_time = Column(DateTime, nullable=True, comment="下次联系时间")
follow_count = Column(Integer, nullable=True, default=0, comment="跟进次数(冗余)")
contract_id = Column(String(64), nullable=True, comment="关联合同ID")
source = Column(String(20), nullable=True, comment="商机来源")
type = Column(String(20), nullable=True, comment="商机类型")
description = Column(Text, nullable=True, comment="商机描述")
competitors = Column(String(500), nullable=True, comment="竞争对手")
key_factors = Column(String(500), nullable=True, comment="关键决策因素")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmOpportunityFollow(Base):
"""CRM-商机跟进记录表"""
__tablename__ = "crm_opportunity_follow"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
opportunity_id = Column(String(64), nullable=False, comment="商机ID")
follow_type = Column(String(20), nullable=False, comment="跟进方式")
follow_content = Column(Text, nullable=False, comment="跟进内容")
follow_time = Column(DateTime, nullable=True, comment="跟进时间")
stage = Column(String(20), nullable=True, comment="当前商机阶段")
stage_percent = Column(Integer, nullable=True, comment="阶段进度百分比")
next_time = Column(DateTime, nullable=True, comment="下次联系时间")
next_content = Column(String(500), nullable=True, comment="下次联系计划")
attachments = Column(String(1000), nullable=True, comment="附件(逗号分隔)")
contact_id = Column(String(64), nullable=True, comment="联系人ID")
contact_name = Column(String(50), nullable=True, comment="联系人姓名")
location = Column(String(200), nullable=True, comment="跟进地点")
duration = Column(Integer, nullable=True, comment="跟进时长(分钟)")
follow_by = Column(String(64), nullable=True, comment="跟进人ID")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmOpportunityProduct(Base):
"""CRM-商机产品关联表"""
__tablename__ = "crm_opportunity_product"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
opportunity_id = Column(String(64), nullable=False, comment="商机ID")
product_id = Column(String(64), nullable=False, comment="产品ID")
product_name = Column(String(200), nullable=True, comment="产品名称(冗余)")
product_no = Column(String(50), nullable=True, comment="产品编号(冗余)")
category_id = Column(String(64), nullable=True, comment="产品分类ID")
category_name = Column(String(100), nullable=True, comment="产品分类名称(冗余)")
model = Column(String(100), nullable=True, comment="规格型号")
unit = Column(String(20), nullable=True, default="件", comment="单位")
quantity = Column(DECIMAL(20, 4), nullable=False, comment="数量")
price = Column(DECIMAL(15, 2), nullable=False, default=0, comment="单价")
discount = Column(DECIMAL(5, 2), nullable=True, default=0, comment="折扣(百分比)")
subtotal = Column(DECIMAL(15, 2), nullable=False, default=0, comment="小计金额")
sort = Column(Integer, nullable=True, default=0, comment="排序号")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmOpportunityStageLog(Base):
"""CRM-商机阶段变更日志表"""
__tablename__ = "crm_opportunity_stage_log"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
opportunity_id = Column(String(64), nullable=False, comment="商机ID")
from_stage = Column(String(20), nullable=True, comment="原阶段")
from_stage_name = Column(String(50), nullable=True, comment="原阶段名称")
from_percent = Column(Integer, nullable=True, comment="原进度百分比")
to_stage = Column(String(20), nullable=False, comment="新阶段")
to_stage_name = Column(String(50), nullable=True, comment="新阶段名称")
to_percent = Column(Integer, nullable=True, comment="新进度百分比")
change_type = Column(String(20), nullable=True, default="forward", comment="变更类型")
change_reason = Column(String(500), nullable=True, comment="变更原因")
change_amount = Column(DECIMAL(15, 2), nullable=True, comment="变更时商机金额")
lost_detail = Column(String(2000), nullable=True, comment="输单详细说明")
competitor_info = Column(String(1000), nullable=True, comment="竞争对手信息")
improvement = Column(String(1000), nullable=True, comment="改进建议")
won_remark = Column(String(2000), nullable=True, comment="赢单说明")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmContract(Base):
"""CRM-合同主表"""
__tablename__ = "crm_contract"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
contract_no = Column(String(50), nullable=False, comment="合同编号")
contract_name = Column(String(200), nullable=False, comment="合同名称")
customer_id = Column(String(64), nullable=False, comment="客户ID")
customer_name = Column(String(200), nullable=True, comment="客户名称(冗余)")
opportunity_id = Column(String(64), nullable=True, comment="商机ID")
quote_id = Column(String(64), nullable=True, comment="报价单ID")
parent_contract_id = Column(String(64), nullable=True, comment="原合同ID(续签)")
renewal_count = Column(Integer, nullable=True, default=0, comment="续签次数")
template_id = Column(String(64), nullable=True, comment="合同模板ID")
contract_template = Column(String(50), nullable=True, default="shanxia", comment="合同模版")
contact_id = Column(String(64), nullable=True, comment="联系人ID")
contact_name = Column(String(50), nullable=True, comment="联系人姓名(冗余)")
contact_mobile = Column(String(20), nullable=True, comment="联系人手机(冗余)")
contract_type = Column(String(20), nullable=False, default="sale", comment="合同类型")
contract_nature = Column(String(20), nullable=True, default="new", comment="合同性质")
amount = Column(DECIMAL(15, 2), nullable=False, default=0, comment="合同金额")
currency = Column(String(10), nullable=True, default="CNY", comment="币种")
tax_rate = Column(DECIMAL(5, 2), nullable=True, default=Decimal("6.00"), comment="税率(%)")
amount_with_tax = Column(DECIMAL(15, 2), nullable=True, default=Decimal("0.00"), comment="含税金额")
freight = Column(DECIMAL(18, 2), nullable=False, default=Decimal("0.00"), comment="运费")
barrel_deposit = Column(DECIMAL(18, 2), nullable=False, default=Decimal("0.00"), comment="桶押金")
status = Column(String(20), nullable=False, default="draft", comment="合同状态")
approval_status = Column(String(20), nullable=True, comment="审批状态")
sign_date = Column(Date, nullable=True, comment="签订日期")
actual_sign_date = Column(Date, nullable=True, comment="实际签订日期")
start_date = Column(Date, nullable=True, comment="开始日期")
end_date = Column(Date, nullable=True, comment="结束日期")
contract_period = Column(Integer, nullable=True, comment="合同期限(月)")
performance_status = Column(String(20), nullable=True, default="normal", comment="履约状态")
performance_rate = Column(DECIMAL(5, 2), nullable=True, default=Decimal("0.00"), comment="履约完成度(%)")
customer_satisfaction = Column(Integer, nullable=True, comment="客户满意度")
approval_flow_id = Column(String(64), nullable=True, comment="审批流程ID")
contract_file = Column(String(500), nullable=True, comment="合同文件路径")
attachment_files = Column(String(2000), nullable=True, comment="附件文件")
owner_user_id = Column(String(64), nullable=True, comment="负责人ID")
owner_user_name = Column(String(50), nullable=True, comment="负责人姓名(冗余)")
received_amount = Column(DECIMAL(15, 2), nullable=True, default=Decimal("0.00"), comment="已回款金额")
unreceived_amount = Column(DECIMAL(15, 2), nullable=True, default=Decimal("0.00"), comment="未回款金额")
invoice_amount = Column(DECIMAL(15, 2), nullable=True, default=Decimal("0.00"), comment="已开票金额")
uninvoice_amount = Column(DECIMAL(15, 2), nullable=True, default=Decimal("0.00"), comment="未开票金额")
payment_terms = Column(Text, nullable=True, comment="付款条款")
delivery_terms = Column(Text, nullable=True, comment="交付条款")
contract_terms = Column(Text, nullable=True, comment="合同条款")
settlement_method = Column(String(50), nullable=True, comment="结算方式")
template_content = Column(Text, nullable=True, comment="合同模板内容")
settlement_clause_drafts = Column(Text, nullable=True, comment="结算方式草稿JSON")
invalid_reason = Column(String(500), nullable=True, comment="作废原因")
invalid_time = Column(DateTime, nullable=True, comment="作废时间")
version_no = Column(Integer, nullable=True, default=0, comment="乐观锁版本号")
party_a = Column(String(200), nullable=True, comment="甲方")
party_a_address = Column(String(255), nullable=True, comment="甲方地址")
party_a_contact = Column(String(50), nullable=True, comment="甲方联系人")
party_a_mobile = Column(String(20), nullable=True, comment="甲方联系电话")
party_a_legal_person = Column(String(50), nullable=True, comment="甲方法定代表人")
party_a_agent = Column(String(50), nullable=True, comment="甲方代理人")
party_a_phone_fax = Column(String(50), nullable=True, comment="甲方电话/传真")
party_a_bank = Column(String(100), nullable=True, comment="甲方开户银行")
party_a_account = Column(String(50), nullable=True, comment="甲方银行账号")
party_b = Column(String(200), nullable=True, comment="乙方")
party_b_address = Column(String(255), nullable=True, comment="乙方地址")
party_b_contact = Column(String(50), nullable=True, comment="乙方联系人")
party_b_mobile = Column(String(20), nullable=True, comment="乙方联系电话")
party_b_legal_person = Column(String(100), nullable=True, comment="乙方法定代表人")
party_b_agent = Column(String(100), nullable=True, comment="乙方代理人")
party_b_phone_fax = Column(String(100), nullable=True, comment="乙方电话/传真")
party_b_bank = Column(String(200), nullable=True, comment="乙方开户银行")
party_b_account = Column(String(100), nullable=True, comment="乙方银行账号")
supplier_id = Column(String(64), nullable=True, comment="供方主体ID")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmContractApproverSetting(Base):
"""CRM-合同审批人设置(租户级)"""
__tablename__ = "crm_contract_approver_setting"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
approver_ids = Column(String(1000), nullable=False, default="", comment="有序审批人用户ID,逗号分隔")
status = Column(String(1), nullable=False, default="0", comment="0启用 1停用")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmContractApproval(Base):
"""CRM-合同审批记录表"""
__tablename__ = "crm_contract_approval"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
contract_id = Column(String(64), nullable=False, comment="合同ID")
flow_id = Column(String(64), nullable=True, comment="审批流程ID")
step = Column(Integer, nullable=False, default=1, comment="审批步骤")
step_name = Column(String(100), nullable=True, comment="步骤名称")
approver_id = Column(String(64), nullable=False, comment="审批人ID")
approver_name = Column(String(50), nullable=True, comment="审批人姓名(冗余)")
approver_dept = Column(String(100), nullable=True, comment="审批人部门")
approval_result = Column(String(20), nullable=True, default="pending", comment="审批结果")
approval_opinion = Column(Text, nullable=True, comment="审批意见")
approval_time = Column(DateTime, nullable=True, comment="审批时间")
approval_duration = Column(Integer, nullable=True, comment="审批耗时(小时)")
attachments = Column(String(1000), nullable=True, comment="附件")
is_current = Column(SmallInteger, nullable=True, default=1, comment="是否当前步骤")
sort = Column(Integer, nullable=True, default=0, comment="排序号")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmContractChange(Base):
"""CRM-合同变更记录表"""
__tablename__ = "crm_contract_change"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
contract_id = Column(String(64), nullable=False, comment="合同ID")
contract_no = Column(String(50), nullable=True, comment="合同编号(冗余)")
change_type = Column(String(50), nullable=False, comment="变更类型")
change_reason = Column(String(500), nullable=False, comment="变更原因")
change_content = Column(Text, nullable=True, comment="变更内容描述")
old_value = Column(Text, nullable=True, comment="变更前值(JSON)")
new_value = Column(Text, nullable=True, comment="变更后值(JSON)")
change_amount = Column(DECIMAL(15, 2), nullable=True, comment="变更金额")
approval_status = Column(String(20), nullable=True, default="pending", comment="审批状态")
approver_id = Column(String(64), nullable=True, comment="审批人ID")
approver_name = Column(String(50), nullable=True, comment="审批人姓名")
approval_time = Column(DateTime, nullable=True, comment="审批时间")
approval_opinion = Column(String(500), nullable=True, comment="审批意见")
attachment_files = Column(String(1000), nullable=True, comment="附件文件")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmContractTemplate(Base):
"""CRM-合同模板表"""
__tablename__ = "crm_contract_template"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
template_no = Column(String(50), nullable=False, comment="模板编号")
template_name = Column(String(200), nullable=False, comment="模板名称")
contract_type = Column(String(20), nullable=True, comment="适用合同类型")
template_content = Column(Text, nullable=True, comment="模板内容")
payment_terms = Column(Text, nullable=True, comment="付款条款模板")
delivery_terms = Column(Text, nullable=True, comment="交付条款模板")
contract_terms = Column(Text, nullable=True, comment="合同条款模板")
party_b = Column(String(200), nullable=True, comment="乙方名称")
party_b_address = Column(String(255), nullable=True, comment="乙方地址")
party_b_contact = Column(String(50), nullable=True, comment="乙方联系人")
party_b_mobile = Column(String(20), nullable=True, comment="乙方联系电话")
default_currency = Column(String(10), nullable=True, default="CNY", comment="默认币种")
default_tax_rate = Column(DECIMAL(5, 2), nullable=True, default=Decimal("6.00"), comment="默认税率(%)")
default_period = Column(Integer, nullable=True, default=12, comment="默认合同期限(月)")
is_active = Column(SmallInteger, nullable=True, default=1, comment="是否启用")
usage_count = Column(Integer, nullable=True, default=0, comment="使用次数")
sort = Column(Integer, nullable=True, default=0, comment="排序号")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmContractProduct(Base):
"""CRM-合同产品明细表"""
__tablename__ = "crm_contract_product"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
contract_id = Column(String(64), nullable=False, comment="合同ID")
product_id = Column(String(64), nullable=False, comment="产品ID")
product_name = Column(String(200), nullable=False, comment="产品名称")
brand_mode = Column(String(20), nullable=True, comment="required/any")
brand_id = Column(String(64), nullable=True, comment="指定品牌ID")
brand_name = Column(String(100), nullable=True, comment="品牌名快照")
product_no = Column(String(50), nullable=True, comment="产品编号")
category_id = Column(String(64), nullable=True, comment="产品分类ID")
category_name = Column(String(100), nullable=True, comment="产品分类名称")
model = Column(String(100), nullable=True, comment="规格型号")
unit = Column(String(20), nullable=True, default="件", comment="单位")
quantity = Column(DECIMAL(20, 4), nullable=False, comment="数量")
quantity_mode = Column(String(20), nullable=True, default="fixed", comment="数量模式: customer_demand/fixed")
price = Column(DECIMAL(15, 2), nullable=False, default=Decimal("0.00"), comment="单价")
discount = Column(DECIMAL(5, 2), nullable=True, default=Decimal("0.00"), comment="折扣(%)")
tax_rate = Column(DECIMAL(5, 2), nullable=True, default=Decimal("6.00"), comment="税率(%)")
tax_amount = Column(DECIMAL(15, 2), nullable=True, default=Decimal("0.00"), comment="税费金额")
subtotal = Column(DECIMAL(15, 2), nullable=False, default=Decimal("0.00"), comment="小计金额")
price_mode = Column(String(20), nullable=True, default="fixed", comment="价格模式: market/fixed")
delivery_date = Column(Date, nullable=True, comment="交付日期")
delivery_status = Column(String(20), nullable=True, default="pending", comment="交付状态")
delivered_quantity = Column(DECIMAL(20, 4), nullable=True, default=Decimal("0.0000"), comment="已交付数量")
description = Column(String(1000), nullable=True, comment="产品描述")
package_spec = Column(String(1000), nullable=True, comment="包装规格(单个原文或 JSON 字符串数组)")
delivery_method = Column(String(100), nullable=True, comment="送货方式")
sort = Column(Integer, nullable=True, default=0, comment="排序号")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号(公共)")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmContractProductPriceTier(Base):
"""CRM-框架合同产品调价区间"""
__tablename__ = "crm_contract_product_price_tier"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
contract_id = Column(String(64), nullable=False, comment="合同ID")
contract_product_id = Column(String(64), nullable=False, comment="合同产品明细ID")
start_date = Column(Date, nullable=False, comment="区间开始日期")
end_date = Column(Date, nullable=False, comment="区间结束日期")
price = Column(DECIMAL(15, 2), nullable=False, comment="含税单价")
letter_oss_ids = Column(String(4000), nullable=True, comment="调价函OSS ID列表(JSON数组)")
letter_oss_id = Column(String(64), nullable=True, comment="调价函单附件(废弃)")
sort = Column(Integer, nullable=True, default=0, comment="排序号")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号(公共)")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmQuote(Base):
"""CRM-报价单主表"""
__tablename__ = "crm_quote"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
quote_no = Column(String(50), nullable=False, comment="报价单编号")
quote_title = Column(String(200), nullable=False, comment="报价单标题")
quote_type = Column(String(20), nullable=False, default="sales", comment="报价单类型")
customer_id = Column(String(64), nullable=False, comment="客户ID")
customer_name = Column(String(200), nullable=True, comment="客户名称(冗余)")
opportunity_id = Column(String(64), nullable=True, comment="商机ID")
contact_id = Column(String(64), nullable=True, comment="联系人ID")
contact_name = Column(String(50), nullable=True, comment="联系人姓名(冗余)")
contact_mobile = Column(String(20), nullable=True, comment="联系人手机(冗余)")
contact_email = Column(String(100), nullable=True, comment="联系人邮箱(冗余)")
version = Column(String(20), nullable=True, default="V1.0", comment="版本号")
parent_id = Column(String(64), nullable=True, default="0", comment="父版本ID")
is_latest = Column(SmallInteger, nullable=True, default=1, comment="是否最新版本")
total_amount = Column(DECIMAL(15, 2), nullable=False, default=Decimal("0.00"), comment="总金额")
discount_rate = Column(DECIMAL(5, 2), nullable=True, default=Decimal("0.00"), comment="整单折扣率")
discount_amount = Column(DECIMAL(15, 2), nullable=True, default=Decimal("0.00"), comment="折扣金额")
final_amount = Column(DECIMAL(15, 2), nullable=False, default=Decimal("0.00"), comment="最终金额")
validity_days = Column(Integer, nullable=True, default=30, comment="有效期(天数)")
quote_date = Column(Date, nullable=True, comment="报价日期")
expire_date = Column(Date, nullable=True, comment="到期日期")
status = Column(String(20), nullable=False, default="draft", comment="状态")
reject_reason = Column(String(500), nullable=True, comment="拒绝原因")
pdf_url = Column(String(500), nullable=True, comment="PDF文件路径")
pdf_generated = Column(SmallInteger, nullable=True, default=0, comment="PDF是否已生成")
share_link = Column(String(500), nullable=True, comment="分享链接")
share_code = Column(String(50), nullable=True, comment="分享码")
share_password = Column(String(100), nullable=True, comment="分享密码")
share_expire_time = Column(DateTime, nullable=True, comment="分享链接过期时间")
view_count = Column(Integer, nullable=True, default=0, comment="查看次数")
last_view_time = Column(DateTime, nullable=True, comment="最后查看时间")
owner_user_id = Column(String(64), nullable=False, comment="负责人ID")
owner_user_name = Column(String(50), nullable=True, comment="负责人姓名(冗余)")
supplier_id = Column(String(64), nullable=True, comment="报价主体ID")
supplier_name = Column(String(200), nullable=True, comment="报价主体名称(冗余)")
contract_id = Column(String(64), nullable=True, comment="关联合同ID")
payment_terms = Column(String(500), nullable=True, comment="付款条款")
delivery_terms = Column(String(500), nullable=True, comment="交付条款")
freight = Column(DECIMAL(18, 2), nullable=False, default=Decimal("0.00"), comment="运费")
barrel_deposit = Column(DECIMAL(18, 2), nullable=False, default=Decimal("0.00"), comment="桶押金")
attachments = Column(String(1000), nullable=True, comment="附件")
template_content = Column(Text, nullable=True, comment="报价单模板内容")
version_no = Column(Integer, nullable=True, default=0, comment="乐观锁版本号")
invalid_reason = Column(String(500), nullable=True, comment="作废原因")
invalid_time = Column(DateTime, nullable=True, comment="作废时间")
invalid_by = Column(String(64), nullable=True, comment="作废人ID")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmQuoteProduct(Base):
"""CRM-报价单产品明细表"""
__tablename__ = "crm_quote_product"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
quote_id = Column(String(64), nullable=False, comment="报价单ID")
product_id = Column(String(64), nullable=False, comment="产品ID")
product_name = Column(String(200), nullable=False, comment="产品名称")
brand_mode = Column(String(20), nullable=True, comment="required/any")
brand_id = Column(String(64), nullable=True, comment="指定品牌ID")
brand_name = Column(String(100), nullable=True, comment="品牌名快照")
product_no = Column(String(50), nullable=True, comment="产品编号")
category_id = Column(String(64), nullable=True, comment="产品分类ID")
category_name = Column(String(100), nullable=True, comment="产品分类名称")
model = Column(String(100), nullable=True, comment="规格型号")
unit = Column(String(20), nullable=True, default="件", comment="单位")
quantity = Column(DECIMAL(20, 4), nullable=False, comment="数量")
price = Column(DECIMAL(15, 2), nullable=False, default=Decimal("0.00"), comment="含税单价")
discount = Column(DECIMAL(5, 2), nullable=True, default=Decimal("0.00"), comment="折扣(%)")
subtotal = Column(DECIMAL(15, 2), nullable=False, default=Decimal("0.00"), comment="含税总价")
tax_amount = Column(DECIMAL(15, 2), nullable=True, default=Decimal("0.00"), comment="税费")
tax_rate = Column(DECIMAL(5, 2), nullable=True, default=Decimal("13.00"), comment="税率(%)")
package_spec = Column(String(1000), nullable=True, comment="包装规格(单个原文或 JSON 字符串数组)")
delivery_method = Column(String(200), nullable=True, comment="送货方式")
description = Column(String(1000), nullable=True, comment="产品描述")
sort = Column(Integer, nullable=True, default=0, comment="排序号")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmQuoteApproverSetting(Base):
"""CRM-报价单审批人设置(租户级)"""
__tablename__ = "crm_quote_approver_setting"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
approver_ids = Column(String(1000), nullable=False, default="", comment="有序审批人用户ID,逗号分隔")
status = Column(String(1), nullable=False, default="0", comment="0启用 1停用")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmQuoteApproval(Base):
"""CRM-报价单审批记录表"""
__tablename__ = "crm_quote_approval"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
quote_id = Column(String(64), nullable=False, comment="报价单ID")
quote_no = Column(String(50), nullable=True, comment="报价单编号(冗余)")
step = Column(Integer, nullable=False, comment="审批步骤")
approver_id = Column(String(64), nullable=False, comment="审批人ID")
approver_name = Column(String(50), nullable=True, comment="审批人姓名(冗余)")
approval_result = Column(String(20), nullable=True, default="pending", comment="审批结果")
approval_opinion = Column(Text, nullable=True, comment="审批意见")
approval_time = Column(DateTime, nullable=True, comment="审批时间")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmQuoteShareLog(Base):
"""CRM-报价单分享访问日志表"""
__tablename__ = "crm_quote_share_log"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
quote_id = Column(String(64), nullable=False, comment="报价单ID")
share_code = Column(String(50), nullable=False, comment="分享码")
visit_time = Column(DateTime, nullable=False, default=datetime.now, comment="访问时间")
ip_address = Column(String(50), nullable=True, comment="IP地址")
location = Column(String(200), nullable=True, comment="地理位置")
device_type = Column(String(50), nullable=True, comment="设备类型")
browser = Column(String(100), nullable=True, comment="浏览器信息")
stay_duration = Column(Integer, nullable=True, default=0, comment="停留时长(秒)")
page_views = Column(Integer, nullable=True, default=1, comment="浏览页数")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建者")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新者")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmClue(Base):
"""CRM-线索主表"""
__tablename__ = "crm_clue"
id = Column(String(64), primary_key=True, comment="主键ID")
clue_name = Column(String(100), nullable=False, comment="线索姓名")
mobile = Column(String(20), nullable=False, comment="手机号")
company = Column(String(200), nullable=True, comment="公司名称")
customer_type = Column(String(20), nullable=True, comment="客户类型(company-企业/person-个人)")
telephone = Column(String(30), nullable=True, comment="固定电话")
email = Column(String(100), nullable=True, comment="邮箱")
title = Column(String(10), nullable=True, comment="称呼(先生/女士/其他)")
position = Column(String(50), nullable=True, comment="职位")
source = Column(String(20), nullable=False, comment="线索来源")
level = Column(String(10), nullable=True, default="unrated", comment="线索等级(A/B/C/unrated)")
industry = Column(String(50), nullable=True, comment="所属行业(字典 crm_customer_industry)")
park_area = Column(String(100), nullable=True, comment="所在园区")
province = Column(String(50), nullable=True, comment="省")
city = Column(String(50), nullable=True, comment="市")
district = Column(String(50), nullable=True, comment="区")
address = Column(String(255), nullable=True, comment="详细地址")
website = Column(String(500), nullable=True, comment="客户网站")
intent_products = Column(String(500), nullable=True, comment="意向产品(多个用逗号分隔)")
expect_time = Column(Date, nullable=True, comment="预计购买时间")
budget = Column(String(20), nullable=True, comment="预算范围")
requirement = Column(Text, nullable=True, comment="需求描述")
status = Column(String(20), nullable=True, default="new", comment="线索状态(new/follow/invalid/converted)")
owner_user_id = Column(String(64), nullable=True, comment="负责人ID")
owner_user_name = Column(String(50), nullable=True, comment="负责人姓名(冗余)")
last_time = Column(DateTime, nullable=True, comment="最后跟进时间")
next_time = Column(DateTime, nullable=True, comment="下次联系时间")
follow_count = Column(Integer, nullable=True, default=0, comment="跟进次数")
is_converted = Column(SmallInteger, nullable=True, default=0, comment="是否已转化(0-否 1-是)")
converted_time = Column(DateTime, nullable=True, comment="转化时间")
customer_id = Column(String(64), nullable=True, comment="转化的客户ID")
converted_by = Column(String(64), nullable=True, comment="转化操作人")
assign_time = Column(DateTime, nullable=True, comment="分配时间")
assign_by = Column(String(64), nullable=True, comment="分配人")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmClueFollow(Base):
"""CRM-线索跟进记录表"""
__tablename__ = "crm_clue_follow"
id = Column(String(64), primary_key=True, comment="主键ID")
clue_id = Column(String(64), nullable=False, comment="线索ID")
clue_name = Column(String(100), nullable=True, comment="线索姓名(冗余)")
follow_type = Column(String(20), nullable=False, comment="跟进方式(电话/微信/邮件/拜访/其他)")
follow_content = Column(Text, nullable=False, comment="跟进内容")
next_time = Column(DateTime, nullable=True, comment="下次联系时间")
attachments = Column(String(1000), nullable=True, comment="附件(多个用逗号分隔)")
create_by_name = Column(String(50), nullable=True, comment="跟进人姓名(冗余)")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmPriceLetter(Base):
"""CRM-调价函档案(独立,不关联合同/报价单)"""
__tablename__ = "crm_price_letter"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
letter_type = Column(String(20), nullable=False, comment="类型 receive接受/send发出")
adjust_date = Column(Date, nullable=False, comment="调价日期")
customer_id = Column(String(64), nullable=False, comment="客户ID")
customer_name = Column(String(200), nullable=True, comment="客户名称(冗余)")
product_id = Column(String(64), nullable=False, comment="产品ID")
product_name = Column(String(200), nullable=True, comment="产品名称(冗余)")
price = Column(DECIMAL(15, 2), nullable=False, comment="调整后现金价格(元)")
bill_price = Column(DECIMAL(15, 2), nullable=False, default=Decimal("0.00"), comment="调整后汇票价格(元)")
content = Column(Text, nullable=True, comment="发出类富文本HTML")
attachment_urls = Column(String(4000), nullable=True, comment="附件URL(逗号分隔)")
status = Column(String(20), nullable=False, default="normal", comment="状态 normal/invalid")
invalid_reason = Column(String(200), nullable=True, comment="作废原因")
invalid_time = Column(DateTime, nullable=True, comment="作废时间")
invalid_by = Column(String(64), nullable=True, comment="作废人ID")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(512), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
class CrmSupplierInfo(Base):
"""CRM-供方信息表"""
__tablename__ = "crm_supplier_info"
id = Column(String(64), primary_key=True, comment="主键ID(UUID)")
supplier_name = Column(String(200), nullable=False, comment="供方名称(章)")
short_name = Column(String(100), nullable=True, comment="简称")
supplier_code = Column(String(50), nullable=True, comment="编码")
supplier_address = Column(String(500), nullable=True, comment="单位地址")
legal_person = Column(String(100), nullable=True, comment="法定代表人")
agent = Column(String(100), nullable=True, comment="代理人")
phone_fax = Column(String(100), nullable=True, comment="电话/传真")
bank_name = Column(String(200), nullable=True, comment="开户银行")
bank_account = Column(String(100), nullable=True, comment="账号")
allow_toxic = Column(SmallInteger, nullable=False, default=0, comment="是否允许易制毒产品(0否1是)")
allow_explosive = Column(SmallInteger, nullable=False, default=0, comment="是否允许易制爆产品(0否1是)")
status = Column(String(1), nullable=True, default="0", comment="状态(0正常 1停用)")
tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
order_num = Column(Integer, nullable=True, comment="排序号")
remark = Column(String(500), nullable=True, comment="备注")
create_by = Column(String(64), nullable=True, comment="创建人ID")
create_dept_id = Column(String(64), nullable=False, default="", comment="创建人部门ID")
create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
update_by = Column(String(64), nullable=True, comment="更新人ID")
update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")