497 lines
22 KiB
Python
497 lines
22 KiB
Python
"""状态 / 分类常量(前后端共用语义)。"""
|
||
|
||
import re
|
||
|
||
# (code, 中文名, 主题色)
|
||
STATUSES = [
|
||
("not_started", "未开始", "#94a3b8"),
|
||
("in_progress", "进行中", "#2563eb"),
|
||
("done", "已完成", "#16a34a"),
|
||
("at_risk", "风险", "#d97706"),
|
||
("blocked", "阻塞", "#dc2626"),
|
||
("paused", "暂停/终止", "#6b7280"),
|
||
]
|
||
|
||
STATUS_MAP = {code: (name, color) for code, name, color in STATUSES}
|
||
STATUS_CODES = [c for c, _, _ in STATUSES]
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 权限菜单目录(前后端共用:键是权限标识,顺序即权限管理页里的展示顺序)
|
||
# rw = 可编辑(含新增/修改/删除/导出写入口)
|
||
# ro = 只读(能看列表与详情,所有写接口一律 403)
|
||
# 没有这个菜单 = 侧栏看不到、接口也进不去
|
||
# --------------------------------------------------------------------------
|
||
MENUS = [
|
||
("board", "工作看板"),
|
||
("projects", "自研产品"),
|
||
("custom", "定制项目"),
|
||
("focus", "每周工作"),
|
||
("staff", "人力资源"),
|
||
("intake", "更新录入"),
|
||
("settings", "设置"),
|
||
("rbac", "权限管理"),
|
||
]
|
||
MENU_KEYS = [k for k, _ in MENUS]
|
||
MENU_LABELS = dict(MENUS)
|
||
LEVELS = ("ro", "rw")
|
||
LEVEL_LABELS = {"rw": "可编辑", "ro": "只读", "": "无权限"}
|
||
# 多角色并集时比大小用
|
||
LEVEL_RANK = {"": 0, "ro": 1, "rw": 2}
|
||
|
||
|
||
def merge_levels(*maps: dict) -> dict:
|
||
"""把多张菜单权限表合成一张:同一菜单取更高级别。"""
|
||
out: dict[str, str] = {}
|
||
for m in maps:
|
||
for menu, level in (m or {}).items():
|
||
if menu not in MENU_LABELS:
|
||
continue
|
||
if LEVEL_RANK.get(level, 0) > LEVEL_RANK.get(out.get(menu, ""), 0):
|
||
out[menu] = level
|
||
return out
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 定制项目(交付制,与平台产品类项目分开管理)
|
||
# (code, 名称, 颜色, 收入确认基准比例)
|
||
# 开发中阶段:base + 0.4 * progress/100
|
||
# 其余阶段:直接使用 base
|
||
# 手动比例 manual_ratio 非空时优先使用
|
||
# --------------------------------------------------------------------------
|
||
CUSTOM_STAGES = [
|
||
("lead", "商机/报备", "#94a3b8", 0.00),
|
||
("signed", "已签单/下单", "#0891b2", 0.10),
|
||
("developing", "开发中", "#2563eb", 0.10),
|
||
("delivered", "交付完成", "#7c3aed", 0.70),
|
||
("accepted", "已验收", "#d97706", 0.90),
|
||
("revenue", "已计收", "#16a34a", 1.00),
|
||
("paused", "暂停/异常", "#dc2626", 0.30),
|
||
("closed", "已关闭", "#6b7280", 1.00),
|
||
]
|
||
CUSTOM_STAGE_MAP = {c: (n, col, r) for c, n, col, r in CUSTOM_STAGES}
|
||
CUSTOM_STAGE_CODES = [c for c, _, _, _ in CUSTOM_STAGES]
|
||
|
||
|
||
def custom_revenue_ratio(stage: str, progress: float | None, manual_ratio=None,
|
||
project_status: str | None = None) -> float:
|
||
"""按阶段 + 开发进度计算收入确认比例(0~1)。
|
||
|
||
手动比例 manual_ratio 优先;其次「退单」一律按 0 计(阶段虽落到 closed,
|
||
但退单没有收入,不能让已关闭项目的基准比例把金额算进来)。
|
||
"""
|
||
if manual_ratio is not None:
|
||
try:
|
||
return max(0.0, min(1.0, float(manual_ratio)))
|
||
except (TypeError, ValueError):
|
||
pass
|
||
if (project_status or "").strip() == CUSTOM_NO_REVENUE_STATUS and manual_ratio is None:
|
||
return 0.0
|
||
base = CUSTOM_STAGE_MAP.get(stage, ("", "#94a3b8", 0.0))[2]
|
||
if stage == "developing":
|
||
p = float(progress or 0)
|
||
return round(min(1.0, base + 0.4 * (p / 100.0)), 4)
|
||
return round(base, 4)
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 定制项目:文本 → 阶段 / 金额 识别
|
||
# --------------------------------------------------------------------------
|
||
CUSTOM_STAGE_RULES = [
|
||
(("暂停", "终止", "未达成一致", "搁置"), "paused"),
|
||
(("已计收", "已核销", "完成计收", "计收完成"), "revenue"),
|
||
(("验收报告", "已验收", "完成验收", "待验收"), "accepted"),
|
||
(("交付完成", "已交付", "需求交付完成"), "delivered"),
|
||
(("开发中", "开发交付中", "启动开发", "开发进行"), "developing"),
|
||
(("已下单", "已报单", "已签订", "合同签订", "合同已签"), "signed"),
|
||
(("商机", "报备", "投标"), "lead"),
|
||
]
|
||
|
||
CUSTOM_CAT_STAGE = {
|
||
"验收项目": "accepted",
|
||
"交付项目": "delivered",
|
||
"提前交付": "delivered",
|
||
"异常项目": "paused",
|
||
"新增项目": "signed",
|
||
"重点项目": "developing",
|
||
}
|
||
|
||
_CUSTOM_AMT_TAIL = re.compile(r"[((]\s*([0-9][0-9,,]*\.?[0-9]*)\s*[))]?\s*$")
|
||
_CUSTOM_WS = re.compile(r"\s+")
|
||
|
||
|
||
def normalize_custom_name(name: str) -> tuple[str, float | None]:
|
||
"""『龙江交投高速大模型分析项目(39,400.00 )』→ ('龙江交投高速大模型分析项目', 39400.0)"""
|
||
s = _CUSTOM_WS.sub(" ", (name or "").strip())
|
||
m = _CUSTOM_AMT_TAIL.search(s)
|
||
amount = None
|
||
if m:
|
||
try:
|
||
amount = float(m.group(1).replace(",", "").replace(",", ""))
|
||
except ValueError:
|
||
amount = None
|
||
s = s[: m.start()].strip().strip("(( ")
|
||
return s.strip(" 、-—"), amount
|
||
|
||
|
||
_PROGRESS_RE = re.compile(r"(\d{1,3}(?:\.\d+)?)\s*%")
|
||
|
||
|
||
def extract_percent(text: str | None) -> int | None:
|
||
"""取文本中最大的百分比数值(0-100)。"""
|
||
nums = [float(x) for x in _PROGRESS_RE.findall(text or "")]
|
||
nums = [n for n in nums if 0 <= n <= 100]
|
||
return int(round(max(nums))) if nums else None
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 周期标签解析(『9月第1周』『8月第四周』『2025/08-第1周』)
|
||
# --------------------------------------------------------------------------
|
||
_CN_NUM = {"一": 1, "二": 2, "三": 3, "四": 4, "五": 5, "六": 6, "七": 7, "八": 8, "九": 9, "十": 10}
|
||
_PERIOD_LABEL_RE = re.compile(
|
||
r"(?:(\d{4})\s*[/\-年]\s*)?(\d{1,2})\s*月?\s*[-—~~至]?\s*第?\s*([一二三四五六七八九十]{1,2}|\d{1,2})\s*周"
|
||
)
|
||
|
||
|
||
def parse_period_label(label: str, year_hint: int = 0) -> tuple[int, int, int] | None:
|
||
"""解析周期标签 → (year, month, week)。
|
||
|
||
year_hint 为 0 表示调用方希望区分『标签里到底有没有写年份』:
|
||
没写时返回的 year 就是 0,由调用方决定用什么年份。
|
||
"""
|
||
m = _PERIOD_LABEL_RE.search(str(label or ""))
|
||
if not m:
|
||
return None
|
||
year = int(m.group(1)) if m.group(1) else int(year_hint or 0)
|
||
month = int(m.group(2))
|
||
w = m.group(3)
|
||
if w.isdigit():
|
||
week = int(w)
|
||
elif w == "十":
|
||
week = 10
|
||
elif w.startswith("十"):
|
||
week = 10 + _CN_NUM.get(w[1:], 0)
|
||
elif w.endswith("十"):
|
||
week = _CN_NUM.get(w[:-1], 1) * 10
|
||
else:
|
||
week = _CN_NUM.get(w, 1)
|
||
return year, month, week
|
||
|
||
|
||
def guess_custom_stage(text: str | None, category: str | None = None) -> str:
|
||
"""按『负面 → 完成 → 在制 → 商务』的顺序判定阶段。
|
||
|
||
关键点:文本里同时出现『已计收』和『进度 60%』时,应判定为开发中,
|
||
计收金额另由 revenue_delta 字段承载。
|
||
"""
|
||
t = text or ""
|
||
if any(w in t for w in ("暂停", "终止", "未达成一致", "搁置")):
|
||
return "paused"
|
||
if any(w in t for w in ("验收报告", "已验收", "完成验收")):
|
||
return "accepted"
|
||
if any(w in t for w in ("交付完成", "已交付", "需求交付完成")):
|
||
return "delivered"
|
||
|
||
pct = extract_percent(t)
|
||
in_progress_words = ("进度", "开发", "联调", "部署", "实施", "测试中", "未完成", "待完成")
|
||
if pct is not None and pct < 100 and any(w in t for w in in_progress_words):
|
||
return "developing"
|
||
|
||
for words, code in CUSTOM_STAGE_RULES:
|
||
if any(w in t for w in words):
|
||
return code
|
||
|
||
if pct is not None and pct < 100:
|
||
return "developing"
|
||
if category and category in CUSTOM_CAT_STAGE:
|
||
return CUSTOM_CAT_STAGE[category]
|
||
return "signed"
|
||
|
||
|
||
# 省/直辖市 → 下辖市县关键词(用于从项目名反推区域)
|
||
REGION_KEYWORDS: list[tuple[str, list[str]]] = [
|
||
("重庆", ["重庆", "渝北", "渝中", "南岸", "江北", "巴南", "黔江", "青白江", "天宫殿", "两江", "大足", "綦江", "长寿", "垫江"]),
|
||
("四川", ["四川", "成都", "乐山", "德阳", "荥经", "简阳", "名山", "绵阳", "宜宾", "泸州", "广元", "眉山", "资阳", "内江", "自贡", "攀枝花", "达州", "南充", "遂宁", "广安", "雅安", "凉山", "宣汉", "沙湾"]),
|
||
("内蒙古", ["内蒙古", "内蒙", "呼和浩特", "赤峰", "包头", "鄂尔多斯", "呼伦贝尔", "兴安盟", "阿拉善", "巴彦淖尔", "通辽", "乌兰察布", "锡林郭勒", "乌海", "满洲里", "杭锦旗"]),
|
||
("江苏", ["江苏", "南京", "南通", "苏州", "无锡", "常州", "徐州", "扬州", "镇江", "盐城", "淮安", "连云港", "泰州", "宿迁", "昆山", "花桥", "江宁", "通州湾"]),
|
||
("山东", ["山东", "青岛", "济南", "烟台", "潍坊", "临沂", "淄博", "济宁", "威海", "东营", "泰安", "德州", "聊城", "菏泽", "枣庄", "日照", "滨州"]),
|
||
("黑龙江", ["黑龙江", "哈尔滨", "大庆", "齐齐哈尔", "牡丹江", "佳木斯", "绥化", "鸡西", "双鸭山", "伊春", "七台河", "鹤岗", "黑河", "抚远", "龙江"]),
|
||
("吉林", ["吉林", "长春", "四平", "辽源", "通化", "白山", "松原", "白城", "延边"]),
|
||
("辽宁", ["辽宁", "沈阳", "大连", "鞍山", "抚顺", "本溪", "丹东", "锦州", "营口", "阜新", "辽阳", "盘锦", "铁岭", "朝阳", "葫芦岛"]),
|
||
("甘肃", ["甘肃", "兰州", "金昌", "天水", "白银", "酒泉", "张掖", "武威", "定西", "平凉", "庆阳", "陇南"]),
|
||
("青海", ["青海", "西宁", "海东", "格尔木", "化隆"]),
|
||
("宁夏", ["宁夏", "银川", "石嘴山", "吴忠", "固原", "中卫"]),
|
||
("陕西", ["陕西", "西安", "咸阳", "宝鸡", "渭南", "延安", "汉中", "榆林", "安康", "商洛"]),
|
||
("广西", ["广西", "南宁", "柳州", "桂林", "梧州", "北海", "贺州", "玉林", "百色", "河池", "来宾", "崇左", "钦州", "贵港", "防城港"]),
|
||
("云南", ["云南", "昆明", "曲靖", "玉溪", "昭通", "楚雄", "红河", "文山", "普洱", "大理", "丽江", "临沧", "林草", "滇东南"]),
|
||
("江西", ["江西", "南昌", "赣州", "九江", "上饶", "宜春", "吉安", "抚州", "景德镇", "萍乡", "新余", "鹰潭", "洪都"]),
|
||
("湖南", ["湖南", "长沙", "株洲", "湘潭", "衡阳", "邵阳", "岳阳", "常德", "张家界", "益阳", "郴州", "永州", "怀化", "娄底"]),
|
||
("湖北", ["湖北", "武汉", "黄石", "襄阳", "宜昌", "荆州", "十堰", "孝感", "荆门", "鄂州", "黄冈", "咸宁", "随州"]),
|
||
("河南", ["河南", "郑州", "开封", "洛阳", "平顶山", "安阳", "鹤壁", "新乡", "焦作", "濮阳", "许昌", "漯河", "三门峡", "南阳", "商丘", "信阳", "周口", "驻马店"]),
|
||
("广东", ["广东", "广州", "深圳", "东莞", "佛山", "珠海", "中山", "惠州", "汕头", "江门", "湛江", "肇庆", "清远", "潮州", "揭阳", "韶关", "梅州", "汕尾", "河源", "阳江", "茂名"]),
|
||
("北京", ["北京"]),
|
||
("天津", ["天津", "滨海"]),
|
||
("上海", ["上海", "浦东"]),
|
||
("浙江", ["浙江", "杭州", "宁波", "温州", "嘉兴", "湖州", "绍兴", "金华", "衢州", "舟山", "台州", "丽水"]),
|
||
("福建", ["福建", "福州", "厦门", "泉州", "漳州", "莆田", "三明", "南平", "龙岩", "宁德"]),
|
||
("安徽", ["安徽", "合肥", "芜湖", "蚌埠", "淮南", "马鞍山", "安庆", "黄山", "阜阳", "宿州", "六安", "亳州", "池州", "宣城", "铜陵", "滁州"]),
|
||
("贵州", ["贵州", "贵阳", "遵义", "六盘水", "安顺", "毕节", "铜仁"]),
|
||
("山西", ["山西", "太原", "大同", "阳泉", "长治", "晋城", "朔州", "晋中", "运城", "忻州", "临汾", "吕梁"]),
|
||
("河北", ["河北", "石家庄", "唐山", "秦皇岛", "邯郸", "邢台", "保定", "张家口", "承德", "沧州", "廊坊", "衡水", "雄安"]),
|
||
("新疆", ["新疆", "乌鲁木齐", "克拉玛依", "喀什", "伊犁"]),
|
||
("西藏", ["西藏", "拉萨"]),
|
||
]
|
||
|
||
|
||
def infer_region(name: str | None) -> str | None:
|
||
"""从项目名称反推所属区域(省/直辖市)。"""
|
||
s = name or ""
|
||
for region, keys in REGION_KEYWORDS:
|
||
for k in keys:
|
||
if k in s:
|
||
return region
|
||
return None
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 规范的省级行政区列表(用于下拉选择与筛选)
|
||
# 采用与历史数据一致的简称写法,避免不必要的迁移
|
||
# --------------------------------------------------------------------------
|
||
REGION_GROUPS: list[tuple[str, list[str]]] = [
|
||
("华北", ["北京", "天津", "河北", "山西", "内蒙古"]),
|
||
("东北", ["辽宁", "吉林", "黑龙江"]),
|
||
("华东", ["上海", "江苏", "浙江", "安徽", "福建", "江西", "山东", "台湾"]),
|
||
("华中", ["河南", "湖北", "湖南"]),
|
||
("华南", ["广东", "广西", "海南", "香港", "澳门"]),
|
||
("西南", ["重庆", "四川", "贵州", "云南", "西藏"]),
|
||
("西北", ["陕西", "甘肃", "青海", "宁夏", "新疆"]),
|
||
]
|
||
|
||
ALL_REGIONS: list[str] = [r for _, lst in REGION_GROUPS for r in lst]
|
||
|
||
# 非规范写法 → 规范值
|
||
REGION_ALIAS = {
|
||
"内蒙古自治区": "内蒙古",
|
||
"广西壮族自治区": "广西",
|
||
"宁夏回族自治区": "宁夏",
|
||
"新疆维吾尔自治区": "新疆",
|
||
"西藏自治区": "西藏",
|
||
"北京市": "北京",
|
||
"天津市": "天津",
|
||
"上海市": "上海",
|
||
"重庆市": "重庆",
|
||
"深圳": "广东",
|
||
"深圳市": "广东",
|
||
"未标注": None,
|
||
"": None,
|
||
}
|
||
|
||
|
||
def normalize_region(value: str | None) -> str | None:
|
||
"""把区域值规范到标准列表。"""
|
||
if value is None:
|
||
return None
|
||
v = str(value).strip()
|
||
if not v:
|
||
return None
|
||
if v in ALL_REGIONS:
|
||
return v
|
||
if v in REGION_ALIAS:
|
||
return REGION_ALIAS[v]
|
||
return v
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 周期 → 日期(用于推算「入库时间」)
|
||
# --------------------------------------------------------------------------
|
||
def month_week1(year: int, month: int):
|
||
"""该月第 1 周的周一。
|
||
|
||
口径:周一到周日算一周,一周归属『它的周四落在哪个月』;
|
||
第一个周四落在本月的周就是该月第 1 周(等价于「这一周至少 4 天在本月」)。
|
||
"""
|
||
import datetime
|
||
|
||
first = datetime.date(int(year), int(month), 1)
|
||
first_thu = first + datetime.timedelta(days=(3 - first.weekday()) % 7)
|
||
return first_thu - datetime.timedelta(days=3)
|
||
|
||
|
||
def period_first_day(year: int, month: int, week: int | None = None) -> str:
|
||
"""取该周期第一天的日期。
|
||
|
||
规则:第 1 周 = 第一个周四落在本月的那一周(见 month_week1),
|
||
第 N 周在其基础上顺延 7×(N-1) 天。week 为空或 0 时直接取该月 1 日。
|
||
"""
|
||
import datetime
|
||
|
||
if not week:
|
||
return datetime.date(int(year), int(month), 1).isoformat()
|
||
day = month_week1(year, month) + datetime.timedelta(days=(max(int(week), 1) - 1) * 7)
|
||
return day.isoformat()
|
||
|
||
|
||
def week_of_date(value) -> tuple[int, int, int]:
|
||
"""日期 → 该日所属的 (年, 月, 第几周),与 period_first_day 互为逆运算。"""
|
||
import datetime
|
||
|
||
d = datetime.date.fromisoformat(str(value)[:10]) if isinstance(value, str) else value
|
||
monday = d - datetime.timedelta(days=d.weekday())
|
||
thursday = monday + datetime.timedelta(days=3) # 周四在哪个月,这一周就算哪个月的
|
||
year, month = thursday.year, thursday.month
|
||
return year, month, (monday - month_week1(year, month)).days // 7 + 1
|
||
|
||
|
||
def period_last_day(year: int, month: int, week: int | None = None) -> str:
|
||
"""取该周期最后一天的日期。"""
|
||
import calendar
|
||
import datetime
|
||
|
||
if not week:
|
||
last = calendar.monthrange(int(year), int(month))[1]
|
||
return datetime.date(int(year), int(month), last).isoformat()
|
||
d = datetime.date.fromisoformat(period_first_day(year, month, week))
|
||
return (d + datetime.timedelta(days=6)).isoformat()
|
||
|
||
|
||
# 默认分类配色
|
||
DEFAULT_CATEGORY_COLORS = [
|
||
"#2563eb", "#7c3aed", "#0891b2", "#16a34a",
|
||
"#d97706", "#dc2626", "#db2777", "#0d9488",
|
||
]
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 定制项目:全过程流水线(入库 → 签单 → 交付 → 验收 → 计收)
|
||
# key 环节代码(与 CUSTOM_STAGES 的阶段代码对齐,入库单独用 entry)
|
||
# name 环节名
|
||
# date_field 该环节的日期字段(CustomProject 上的属性名)
|
||
# stage 完成该环节后项目所处的阶段
|
||
# --------------------------------------------------------------------------
|
||
CUSTOM_PIPELINE = [
|
||
("entry", "入库", "entry_date", "lead", "#94a3b8"),
|
||
("signed", "签单", "sign_date", "signed", "#0891b2"),
|
||
("delivered", "交付", "deliver_date", "delivered", "#7c3aed"),
|
||
("accepted", "验收", "accept_date", "accepted", "#d97706"),
|
||
("revenue", "计收", "revenue_date", "revenue", "#16a34a"),
|
||
]
|
||
|
||
# 年度计收目标(万元)默认值,来源《年度任务.xlsx》;页面「年度任务」里可改,改后落库覆盖
|
||
CUSTOM_ANNUAL_TARGETS_DEFAULT = {1: 35.0, 2: 225.0, 3: 160.0, 4: 260.0}
|
||
|
||
# 「在途」阶段:还没走完 入库→签单→交付→验收 这条主线(已计收 / 暂停 / 已关闭不算在途)
|
||
CUSTOM_INFLIGHT_STAGES = {"lead", "signed", "developing", "delivered", "accepted"}
|
||
|
||
# 环节停滞天数超过该值视为「卡住」,需要在看板上提示
|
||
CUSTOM_STEP_AGING_DAYS = 45
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 人力资源库
|
||
# --------------------------------------------------------------------------
|
||
# 人员归属(用工主体)
|
||
STAFF_AFFILIATIONS = ["汇智", "云数", "外服"]
|
||
|
||
# 归属小组(标准口径)
|
||
STAFF_GROUPS = ["管理", "Nex产品组", "定制产品组", "AI产品组", "综合"]
|
||
|
||
# 历史数据里的小组别名 → 标准口径
|
||
STAFF_GROUP_ALIAS = {"AI项目组": "AI产品组"}
|
||
|
||
|
||
def normalize_staff_group(value: str | None) -> str | None:
|
||
v = (value or "").strip()
|
||
if not v:
|
||
return None
|
||
return STAFF_GROUP_ALIAS.get(v, v)
|
||
|
||
|
||
def normalize_staff_affiliation(value: str | None) -> str | None:
|
||
v = (value or "").strip()
|
||
if not v:
|
||
return None
|
||
for a in STAFF_AFFILIATIONS:
|
||
if a in v:
|
||
return a
|
||
return v
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 定制项目:项目状态(台账口径)→ 商务阶段(内部推导,不再单独维护)
|
||
# 界面上只有「项目状态」可编辑,商务阶段(含收入确认比例)由它推导,
|
||
# 避免出现两套状态互相打架。
|
||
# --------------------------------------------------------------------------
|
||
CUSTOM_STATUSES = ["待开发", "进行中", "交付完成", "已验收", "退单"]
|
||
CUSTOM_STATUS_STAGE = {
|
||
"待开发": "signed",
|
||
"进行中": "developing",
|
||
"交付完成": "delivered",
|
||
"已验收": "accepted",
|
||
"退单": "closed",
|
||
}
|
||
# 反向:AI 录入等只认阶段的入口,写回项目状态
|
||
CUSTOM_STAGE_STATUS = {
|
||
"signed": "待开发", "developing": "进行中", "delivered": "交付完成",
|
||
"accepted": "已验收", "revenue": "已验收", "closed": "退单",
|
||
"paused": "进行中", "lead": "待开发",
|
||
}
|
||
# 退单不确认收入(阶段落到 closed,但比例按 0 处理)
|
||
CUSTOM_NO_REVENUE_STATUS = "退单"
|
||
|
||
# 项目归属:前三项算「已下单」,提前交付是下单前状态
|
||
CUSTOM_ORIGINS = ["华智下单", "存量项目", "汇智直签", "提前交付"]
|
||
CUSTOM_PLACED_ORIGINS = ("华智下单", "存量项目", "汇智直签")
|
||
|
||
# 行业 / 风险值:台账里的下拉取值,前端一律从 /custom/meta 取,不再各写一份
|
||
CUSTOM_INDUSTRIES = ["安平", "政府", "企业", "教育", "交通", "医疗", "高速", "行业", "其他"]
|
||
CUSTOM_RISKS = ["1.高风险", "2.低风险"]
|
||
|
||
|
||
def derive_stage(project_status: str | None, fallback: str | None = None) -> str:
|
||
"""按项目状态推导商务阶段;状态没填时保留原阶段。"""
|
||
return CUSTOM_STATUS_STAGE.get((project_status or "").strip(), fallback or "signed")
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 年 / 季度:财务统计的时间归属只在这里判定一次(前端不再自己算季度)
|
||
# --------------------------------------------------------------------------
|
||
def quarter_of_month(month: int) -> int:
|
||
"""月份 1~12 → 季度 1~4。"""
|
||
return (int(month) - 1) // 3 + 1
|
||
|
||
|
||
def parse_quarter(text) -> int | None:
|
||
"""「Q3」/「q3」→ 3;其他写法一律不认(验收季度在界面上是下拉选项,脏文本不认才不会串统计)。"""
|
||
s = str(text or "").strip().upper()
|
||
if len(s) == 2 and s[0] == "Q" and s[1] in "1234":
|
||
return int(s[1])
|
||
return None
|
||
|
||
|
||
def parse_year_month(text) -> tuple[int, int] | None:
|
||
"""从「下单时间」这类可能带脏文本的字段里取 (年, 月);取不到月份时月份为 0。
|
||
|
||
认:2026-03-31 / 2026/3/31 / 2026-3 / 2026年3月 / 2026年 / 2026。
|
||
「2024年3月前」这种能识别出 2024 年 3 月(前缀匹配),只用于年份归属。
|
||
"""
|
||
import re
|
||
|
||
s = str(text or "").strip()
|
||
if not s:
|
||
return None
|
||
m = re.search(r"(20\d{2})\s*[-/年.]\s*(\d{1,2})", s)
|
||
if m:
|
||
year, month = int(m.group(1)), int(m.group(2))
|
||
return (year, month) if 1 <= month <= 12 else (year, 0)
|
||
m = re.search(r"(20\d{2})", s)
|
||
return (int(m.group(1)), 0) if m else None
|
||
|
||
|
||
def quarter_end(year: int, quarter: int) -> str:
|
||
"""季度末日期(YYYY-MM-DD),用于按季度派生验收日期。"""
|
||
import calendar
|
||
import datetime
|
||
|
||
last_month = int(quarter) * 3
|
||
day = calendar.monthrange(int(year), last_month)[1]
|
||
return datetime.date(int(year), last_month, day).isoformat()
|