#!/usr/bin/env python3 """备货日历的市场语境、经营分析与跨国节日聚合。""" from __future__ import annotations import hashlib import re from collections import Counter from datetime import date, timedelta from typing import Any, Callable from urllib.parse import quote COUNTRY_DETAILS = { "CN": ("中国", "东亚", "china", ["简体中文"], ["天猫", "京东", "抖音电商"]), "US": ("美国", "北美", "north-america", ["英语", "西班牙语"], ["Amazon US", "Walmart", "eBay", "Etsy", "TikTok Shop", "Temu"]), "GB": ("英国", "英国及爱尔兰", "british-isles", ["英语"], ["Amazon UK", "eBay UK", "Etsy"]), "DE": ("德国", "中西欧", "central-europe", ["德语"], ["Amazon DE", "OTTO", "eBay DE", "Temu"]), "FR": ("法国", "中西欧", "central-europe", ["法语"], ["Amazon FR", "Cdiscount", "Etsy", "Temu"]), "IT": ("意大利", "南欧", "southern-europe", ["意大利语"], ["Amazon IT", "eBay IT", "Etsy"]), "ES": ("西班牙", "南欧", "southern-europe", ["西班牙语"], ["Amazon ES", "eBay ES", "Etsy"]), "NL": ("荷兰", "中西欧", "central-europe", ["荷兰语"], ["bol.com", "Amazon NL"]), "CA": ("加拿大", "北美", "north-america", ["英语", "法语"], ["Amazon CA", "Walmart Canada", "eBay"]), "AU": ("澳大利亚", "大洋洲", "oceania", ["英语"], ["Amazon AU", "eBay AU"]), "JP": ("日本", "东亚", "japan", ["日语"], ["Amazon Japan", "乐天市场", "Yahoo!购物", "Temu"]), "KR": ("韩国", "东亚", "korea", ["韩语"], ["Coupang", "Naver Shopping", "Gmarket", "Temu"]), "BR": ("巴西", "拉丁美洲", "latin-america", ["葡萄牙语"], ["Mercado Libre", "Amazon Brazil", "Shopee"]), "MX": ("墨西哥", "拉丁美洲", "latin-america", ["西班牙语"], ["Mercado Libre", "Amazon Mexico", "Walmart Mexico"]), "NZ": ("新西兰", "大洋洲", "oceania", ["英语", "毛利语"], ["Trade Me", "Amazon AU"]), "SG": ("新加坡", "东南亚", "southeast-asia", ["英语", "简体中文", "马来语", "泰米尔语"], ["Shopee", "Lazada", "Amazon SG", "TikTok Shop"]), "ID": ("印度尼西亚", "东南亚", "southeast-asia", ["印度尼西亚语"], ["Shopee", "Tokopedia", "Lazada", "TikTok Shop"]), "VN": ("越南", "东南亚", "southeast-asia", ["越南语"], ["Shopee", "Lazada", "TikTok Shop"]), "PH": ("菲律宾", "东南亚", "southeast-asia", ["菲律宾语", "英语"], ["Shopee", "Lazada", "TikTok Shop"]), "ZA": ("南非", "南部非洲", "southern-africa", ["英语", "祖鲁语", "南非荷兰语"], ["Takealot", "Amazon South Africa"]), "PL": ("波兰", "中东欧", "central-europe", ["波兰语"], ["Allegro", "Amazon DE", "Empik"]), "SE": ("瑞典", "北欧", "nordic", ["瑞典语"], ["Amazon SE", "CDON"]), "DK": ("丹麦", "北欧", "nordic", ["丹麦语"], ["Amazon DE", "CDON"]), "NO": ("挪威", "北欧", "nordic", ["挪威语"], ["Amazon DE", "CDON"]), "FI": ("芬兰", "北欧", "nordic", ["芬兰语", "瑞典语"], ["Amazon DE", "CDON"]), "BE": ("比利时", "中西欧", "central-europe", ["荷兰语", "法语", "德语"], ["bol.com", "Amazon FR", "Amazon DE"]), "AT": ("奥地利", "中西欧", "central-europe", ["德语"], ["Amazon DE", "eBay DE"]), "CH": ("瑞士", "中西欧", "central-europe", ["德语", "法语", "意大利语"], ["Galaxus", "Amazon DE", "Amazon FR"]), "PT": ("葡萄牙", "南欧", "southern-europe", ["葡萄牙语"], ["Amazon ES", "Worten", "Etsy"]), "IE": ("爱尔兰", "英国及爱尔兰", "british-isles", ["英语", "爱尔兰语"], ["Amazon UK", "eBay", "Etsy"]), "CZ": ("捷克", "中东欧", "central-europe", ["捷克语"], ["Alza", "Amazon DE"]), "TR": ("土耳其", "欧亚市场", "turkiye", ["土耳其语"], ["Trendyol", "Hepsiburada", "Amazon TR"]), "AE": ("阿联酋", "中东", "islamic", ["阿拉伯语", "英语"], ["Amazon.ae", "Noon", "Temu"]), "RU": ("俄罗斯", "俄罗斯及欧亚", "central-europe", ["俄语"], ["Ozon", "Wildberries", "Yandex Market"]), } PLATFORM_PLAYBOOKS = { "Amazon": "核对活动提报与最晚入仓日；主图和标题使用当地语言，尺寸、材质、克重及洗护信息完整。", "Walmart": "核对促销资格、配送承诺和库存可售天数；优先准备高性价比套装与稳定补货。", "TikTok Shop": "提前准备当地语言短视频、达人样品和直播库存；避免未经授权使用节日、赛事或人物元素。", "Shopee": "核对站点大促报名、跨境仓截单和包邮门槛；轻小件、组合装和本地语言素材优先。", "Lazada": "核对站点活动日历、LGS 物流时效与优惠券成本；按东南亚气候准备轻薄、快干产品。", "Mercado Libre": "核对 Mercado Envios 入仓与配送承诺；西班牙语/葡萄牙语页面、尺寸单位和税费表达要本地化。", "Etsy": "强调原创图案、材质故事与个性化能力；上架前先完成商标、版权和节庆符号检索。", "eBay": "核对目的国配送承诺、退货地址和商品属性；标题关键词、尺寸单位和税费说明按站点本地化。", "Temu": "核对站点与托管模式、申报价和仓配时效；用高性价比组合装测试，不要用低价掩盖材质与尺寸信息。", "Ozon": "准备俄语标题、尺寸和认证信息；核对跨境物流、退货与卢布定价，保暖床品按当地季节提前排期。", "Wildberries": "核对跨境招商、仓配和罚则；俄语商品属性、条码与包装必须在发货前完成。", "Coupang": "准备韩语商品页与快速履约方案；床品尺寸、洗护和材质说明按韩国消费者习惯表达。", "乐天市场": "通过日本主体或代理核对店铺资格；用日语细化尺寸、材质、收纳与独居场景。", "OTTO": "先确认欧盟主体、税务与德语客服条件；适合已有欧洲合规和稳定补货能力的品牌。", "Cdiscount": "核对法国税务、EPR 与法语客服；床品和桌布需使用当地尺寸与材质术语。", } COUNTRY_NAMES = {code: values[0] for code, values in COUNTRY_DETAILS.items()} COUNTRY_MARKETS = {code: (values[1], values[2]) for code, values in COUNTRY_DETAILS.items()} COUNTRY_ENGLISH_NAMES = { "CN": "China", "US": "United States", "GB": "United Kingdom", "DE": "Germany", "FR": "France", "IT": "Italy", "ES": "Spain", "NL": "Netherlands", "CA": "Canada", "AU": "Australia", "JP": "Japan", "KR": "South Korea", "BR": "Brazil", "MX": "Mexico", "NZ": "New Zealand", "SG": "Singapore", "ID": "Indonesia", "VN": "Vietnam", "PH": "Philippines", "ZA": "South Africa", "PL": "Poland", "SE": "Sweden", "DK": "Denmark", "NO": "Norway", "FI": "Finland", "BE": "Belgium", "AT": "Austria", "CH": "Switzerland", "PT": "Portugal", "IE": "Ireland", "CZ": "Czechia", "TR": "Türkiye", "AE": "United Arab Emirates", "RU": "Russia", } LOCAL_HOLIDAY_NAMES: dict[str, dict[str, tuple[str, str]]] = { "back-to-school": { "US": ("Back to School / Back to College", "英语"), "GB": ("Back to School / Autumn Term", "英语"), "DE": ("Schulanfang / Schulbeginn", "德语"), "FR": ("Rentrée scolaire", "法语"), "JP": ("新学期（Shingakki）", "日语"), "CA": ("Back to School / Rentrée scolaire", "英语 / 法语"), "AU": ("Back to School / Term 1", "英语"), }, "black-friday": {"US": ("Black Friday", "英语"), "GB": ("Black Friday", "英语"), "DE": ("Black Friday", "德语市场通用英文名"), "FR": ("Black Friday", "法语市场通用英文名")}, "cyber-monday": {"US": ("Cyber Monday", "英语")}, "singles-day": {"CN": ("双十一", "简体中文")}, "winter-holiday": {"US": ("Holiday Season", "英语"), "CA": ("Holiday Season / Saison des Fêtes", "英语 / 法语")}, "christmas": { "US": ("Christmas Day", "英语"), "GB": ("Christmas Day", "英语"), "DE": ("Erster Weihnachtstag", "德语"), "FR": ("Noël", "法语"), "IT": ("Natale", "意大利语"), "ES": ("Navidad", "西班牙语"), "PT": ("Natal", "葡萄牙语"), "PL": ("Boże Narodzenie", "波兰语"), "BR": ("Natal", "葡萄牙语"), }, "boxing-day": {"GB": ("Boxing Day", "英语"), "CA": ("Boxing Day / Lendemain de Noël", "英语 / 法语"), "AU": ("Boxing Day", "英语"), "NZ": ("Boxing Day", "英语")}, "st-stephens-day": { "CA": ("St. Stephen's Day / Boxing Day", "英语 / 法语"), "BE": ("Saint-Étienne / Sint-Stefanus", "法语 / 荷兰语"), "DK": ("2. juledag", "丹麦语"), "AT": ("Stefanitag", "德语"), "DE": ("Zweiter Weihnachtstag", "德语"), "IT": ("Santo Stefano", "意大利语"), "NO": ("Andre juledag", "挪威语"), "CZ": ("2. svátek vánoční", "捷克语"), "PL": ("Drugi dzień Bożego Narodzenia", "波兰语"), "IE": ("Lá Fhéile Stiofáin", "爱尔兰语 / 英语"), "SE": ("Annandag jul", "瑞典语"), "CH": ("Stephanstag", "德语 / 法语 / 意大利语"), "FI": ("Tapaninpäivä", "芬兰语 / 瑞典语"), "NL": ("Tweede kerstdag", "荷兰语"), "PT": ("Primeira Oitava", "葡萄牙语"), "ES": ("Fiesta de San Esteban", "西班牙语"), "AU": ("Boxing Day (observed)", "英语"), "GB": ("Boxing Day (observed)", "英语"), }, "lunar-new-year": {"CN": ("春节", "简体中文"), "KR": ("설날", "韩语"), "VN": ("Tết Nguyên Đán", "越南语"), "SG": ("农历新年 / Chinese New Year", "简体中文 / 英语")}, "new-year-eve": {"DK": ("Nytårsaften", "丹麦语"), "SE": ("Nyårsafton", "瑞典语"), "PH": ("一年中的最后一天", "英语 / 菲律宾语")}, "eid-fitr": {"AE": ("عيد الفطر", "阿拉伯语"), "TR": ("Ramazan Bayramı", "土耳其语"), "ID": ("Idul Fitri", "印度尼西亚语")}, "eid-adha": {"AE": ("عيد الأضحى", "阿拉伯语"), "TR": ("Kurban Bayramı", "土耳其语"), "ID": ("Idul Adha", "印度尼西亚语")}, "assumption-day": { "AT": ("Mariä Himmelfahrt", "德语"), "DE": ("Mariä Himmelfahrt", "德语"), "IT": ("Ferragosto / Assunzione", "意大利语"), "BE": ("Onze-Lieve-Vrouw-Hemelvaart / Assomption", "荷兰语 / 法语"), "FR": ("Assomption", "法语"), "PL": ("Wniebowzięcie Najświętszej Maryi Panny", "波兰语"), "CH": ("Mariä Himmelfahrt / Assomption / Assunzione", "德语 / 法语 / 意大利语"), "PT": ("Assunção de Nossa Senhora", "葡萄牙语"), "ES": ("Asunción", "西班牙语"), }, "indonesia-independence": {"ID": ("Hari Kemerdekaan Republik Indonesia", "印度尼西亚语")}, "new-year": { "CN": ("元旦", "简体中文"), "JP": ("元日", "日语"), "RU": ("Новогодние каникулы", "俄语"), }, "public-holiday:JP:coming of age day": {"JP": ("成人の日", "日语")}, "public-holiday:JP:greenery day": {"JP": ("みどりの日", "日语")}, } FESTIVAL_TARGET_COUNTRIES = { "eid-fitr": ("AE", "TR", "ID"), "eid-adha": ("AE", "TR", "ID"), } HOLIDAY_TRANSLATIONS = { "new year's day": "元旦", "new year holiday": "新年假期", "chinese new year": "春节", "lunar new year": "农历新年", "spring festival": "春节", "good friday": "耶稣受难日", "easter sunday": "复活节", "easter monday": "复活节星期一", "christmas day": "圣诞节", "boxing day": "节礼日", "st. stephen's day": "圣斯蒂芬节", "labour day": "劳动节", "labor day": "劳动节", "independence day": "独立日", "national day": "国庆日", "republic day": "共和国日", "constitution day": "宪法日", "liberation day": "解放日", "victory day": "胜利日", "memorial day": "阵亡将士纪念日", "thanksgiving day": "感恩节", "assumption": "圣母升天节", "assumption day": "圣母升天节", "assumption of the virgin mary": "圣母升天节", "ascension day": "耶稣升天节", "all saints' day": "诸圣节", "epiphany": "主显节", "corpus christi": "基督圣体节", "reformation day": "宗教改革纪念日", "whit monday": "圣灵降临节星期一", "pentecost monday": "圣灵降临节星期一", "king's birthday": "国王诞辰", "mountain day": "山之日", "marine day": "海之日", "respect for the aged day": "敬老日", "culture day": "文化日", "children's day": "儿童节", "new year s day": "元旦", "new year holiday": "新年假期", "new year s eve": "跨年夜", "last day of the year": "跨年夜", "coming of age day": "成人节", "greenery day": "绿之日", "labour thanksgiving day": "勤劳感谢之日", "labor thanksgiving day": "勤劳感谢之日", } SUBDIVISION_NAMES = { "DE-BW": "巴登-符腾堡州", "DE-BY": "巴伐利亚州", "DE-BE": "柏林州", "DE-BB": "勃兰登堡州", "DE-HB": "不来梅州", "DE-HH": "汉堡州", "DE-HE": "黑森州", "DE-MV": "梅克伦堡-前波美拉尼亚州", "DE-NI": "下萨克森州", "DE-NW": "北莱茵-威斯特法伦州", "DE-RP": "莱茵兰-普法尔茨州", "DE-SL": "萨尔州", "DE-SN": "萨克森州", "DE-ST": "萨克森-安哈尔特州", "DE-SH": "石勒苏益格-荷尔斯泰因州", "DE-TH": "图林根州", "CH-AG": "阿尔高州", "CH-AI": "内阿彭策尔州", "CH-AR": "外阿彭策尔州", "CH-BE": "伯尔尼州", "CH-BL": "巴塞尔乡村州", "CH-BS": "巴塞尔城市州", "CH-FR": "弗里堡州", "CH-GE": "日内瓦州", "CH-GL": "格拉鲁斯州", "CH-GR": "格劳宾登州", "CH-JU": "汝拉州", "CH-LU": "卢塞恩州", "CH-NE": "纳沙泰尔州", "CH-NW": "下瓦尔登州", "CH-OW": "上瓦尔登州", "CH-SG": "圣加仑州", "CH-SH": "沙夫豪森州", "CH-SO": "索洛图恩州", "CH-SZ": "施维茨州", "CH-TG": "图尔高州", "CH-TI": "提契诺州", "CH-UR": "乌里州", "CH-VD": "沃州", "CH-VS": "瓦莱州", "CH-ZG": "楚格州", "CH-ZH": "苏黎世州", "AU-ACT": "首都领地", "AU-NSW": "新南威尔士州", "AU-NT": "北领地", "AU-QLD": "昆士兰州", "AU-SA": "南澳大利亚州", "AU-TAS": "塔斯马尼亚州", "AU-VIC": "维多利亚州", "AU-WA": "西澳大利亚州", "CA-AB": "艾伯塔省", "CA-BC": "不列颠哥伦比亚省", "CA-MB": "马尼托巴省", "CA-NB": "新不伦瑞克省", "CA-NL": "纽芬兰与拉布拉多省", "CA-NS": "新斯科舍省", "CA-NT": "西北地区", "CA-NU": "努纳武特地区", "CA-ON": "安大略省", "CA-PE": "爱德华王子岛省", "CA-QC": "魁北克省", "CA-SK": "萨斯喀彻温省", "CA-YT": "育空地区", } def calendar_scope(is_global: bool, subdivision_codes: list[str]) -> tuple[list[str], str]: if is_global or not subdivision_codes: return ["全国"], "全国适用" areas = [SUBDIVISION_NAMES.get(code, code) for code in subdivision_codes] preview = "、".join(areas[:4]) suffix = f"等 {len(areas)} 个州/省级地区" if len(areas) > 4 else "" return areas, f"仅适用于{preview}{suffix}" FESTIVAL_PROFILES = { "back-to-school": { "title": "美国开学季与大学返校季", "relevance": "high", "decision": "值得专项备货", "what": "美国中小学返校与大学宿舍入住消费季，核心机会集中在 Twin XL 宿舍床品、浴巾、收纳和一站式套装。", "scenes": ["大学宿舍入住", "学生公寓布置", "返校采购"], "products": ["Twin XL 床品套装", "枕芯与床垫保护套", "浴巾套装", "宿舍收纳软品"], "design": ["商品页明确 Twin XL 尺寸和套装清单", "使用宿舍小空间与耐洗场景"], "avoid": ["不要把普通单人床尺寸直接当作 Twin XL；避免漏写套装件数"], }, "black-friday": { "title": "黑色星期五", "relevance": "high", "decision": "值得专项备货", "what": "北美感恩节后的大型零售促销节点，并已扩展到欧洲等跨境市场。", "scenes": ["大促折扣", "礼赠采购", "冬季换新"], "products": ["冬季四件套", "盖毯组合装", "毛巾礼盒", "轻小件软装"], "design": ["突出折扣前后价与套装价值", "准备黑金之外的品牌主色素材"], "avoid": ["不要只降价不核算平台费用、退货和海外仓成本"], }, "cyber-monday": { "title": "网络星期一", "relevance": "high", "decision": "值得专项备货", "what": "紧接黑色星期五的线上零售促销节点，重点考验移动端转化、库存同步和快速履约。", "scenes": ["线上闪促", "移动端下单", "大促补货"], "products": ["轻量盖毯", "枕套组合", "毛巾套装", "快递友好包装"], "design": ["主图先讲尺寸、材质和折扣", "准备短视频与移动端竖版素材"], "avoid": ["不要使用体积过大、运费吞噬毛利的低客单产品做主推"], }, "singles-day": { "title": "双十一购物节", "relevance": "high", "decision": "值得专项备货", "what": "中国电商平台年度集中促销节点，也会影响跨境华人市场和部分海外平台营销节奏。", "scenes": ["家居焕新", "冬季换被", "礼盒囤货"], "products": ["保暖床品", "高客单套装", "智能温控产品", "礼盒装毛巾"], "design": ["分预售、付尾款和现货三套素材", "把克重、支数和保暖指标写清楚"], "avoid": ["不要照搬国内促销语言到非中文市场"], }, "winter-holiday": { "title": "北美冬季假日消费季", "relevance": "high", "decision": "值得专项备货", "what": "从感恩节延续到圣诞节前的礼赠、家庭聚会和冬季家居消费周期。", "scenes": ["家庭聚会", "节日礼赠", "冬季家居焕新"], "products": ["保暖床品", "沙发盖毯", "餐桌布艺", "礼赠套装"], "design": ["建立传统红绿、自然木色和中性冬季三套方案", "礼盒需适配快递与退换货"], "avoid": ["不要把宗教符号用于不明确的通用礼赠款"], }, "christmas": { "title": "圣诞节", "relevance": "high", "decision": "值得专项备货", "what": "欧美、大洋洲及部分亚洲市场的重要家庭团聚与礼赠节日。", "scenes": ["家庭团聚", "节日装饰", "礼赠与旅行"], "products": ["保暖四件套", "盖毯", "抱枕套", "餐桌布艺", "节庆礼盒"], "design": ["准备经典、自然和现代简约三种节庆风格", "兼顾公寓小空间与礼赠包装"], "avoid": ["面向多宗教市场时减少强宗教图案，改用冬季与团聚表达"], }, "boxing-day": { "title": "节礼日", "relevance": "high", "decision": "值得专项备货", "what": "英国、加拿大、澳大利亚和新西兰等市场圣诞节后的公共假日与清仓促销节点。", "scenes": ["节后清仓", "礼品卡消费", "居家换新"], "products": ["清仓床品套装", "基础毛巾", "盖毯", "次年常青款"], "design": ["突出库存有限与套装优惠", "把退换货规则写清楚"], "avoid": ["不要把节礼日误译为单纯送礼日"], }, "lunar-new-year": { "title": "农历新年", "relevance": "high", "decision": "值得专项备货", "what": "中国及多个东亚、东南亚市场的重要团聚、焕新与礼赠节庆。", "scenes": ["家庭团聚", "新居焕新", "节庆礼赠"], "products": ["红金床品", "新年礼盒", "沙发软装", "餐桌布艺"], "design": ["按中国、越南、韩国等市场分别处理生肖、文字和色彩", "准备华人市场双语素材"], "avoid": ["不要把单一中国春节视觉直接套用到所有亚洲市场"], }, "eid-fitr": { "title": "开斋节", "relevance": "high", "decision": "值得专项备货", "what": "斋月结束后的重要穆斯林节日，家庭团聚、礼赠与居家接待需求集中。", "scenes": ["家庭团聚", "居家宴请", "节庆礼赠"], "products": ["礼赠床品", "祈祷毯", "餐桌布艺", "宾客毛巾"], "design": ["使用几何、植物和建筑纹样", "为海湾与东南亚穆斯林市场分别配色"], "avoid": ["避免人物或宗教符号的随意商业化使用"], }, "eid-adha": { "title": "宰牲节", "relevance": "high", "decision": "值得专项备货", "what": "穆斯林重要节日，通常伴随家庭团聚、礼赠、旅行和居家接待。", "scenes": ["家庭接待", "礼赠", "旅行与酒店"], "products": ["礼赠床品", "客用毛巾", "祈祷毯", "酒店布草"], "design": ["采用克制的几何和金属色点缀", "关注耐洗和礼盒陈列"], "avoid": ["不要使用与宗教礼仪不符的图案和促销文案"], }, "easter": { "title": "复活节假期", "relevance": "medium", "decision": "按区域观察", "what": "欧美等市场的春季宗教与公共假期，常与家庭活动、短途旅行和春季换新叠加。", "scenes": ["春季换新", "家庭活动", "短途旅行"], "products": ["轻薄床品", "野餐毯", "淡彩抱枕", "儿童房软装"], "design": ["以春季植物、柔和色彩和户外场景为主", "宗教图案只用于明确受众"], "avoid": ["不同国家的放假范围不同，不要统一承诺配送时效"], }, "assumption-day": { "title": "圣母升天节", "relevance": "medium", "decision": "按区域观察", "what": "8 月 15 日的基督教传统节日，在法国、意大利、西班牙、奥地利等市场为全国公共假日；德国和瑞士只覆盖部分州，且常与欧洲夏季休假叠加。", "scenes": ["夏季长周末", "家庭出行", "酒店与民宿补货"], "products": ["轻薄床品", "浴巾", "旅行毯", "酒店布草"], "design": ["以夏季、海岸和天然材质表达为主", "各国素材分别使用当地语言"], "avoid": ["它不是所有国家都适合强促销的消费节，不要统一压主题库存"], }, "thanksgiving": { "title": "感恩节", "relevance": "high", "decision": "值得专项备货", "what": "美国、加拿大等市场的家庭团聚节日，但日期和消费节奏并不相同。", "scenes": ["家庭聚餐", "客房整理", "节日礼赠"], "products": ["餐桌布艺", "客房床品", "厨房毛巾", "沙发盖毯"], "design": ["使用秋季自然色与家庭场景", "美国和加拿大分开排期"], "avoid": ["不要把美国感恩节日期直接套到加拿大"], }, "new-year": { "title": "元旦与新年假期", "relevance": "medium", "decision": "按区域观察", "what": "公历新年公共假期，重点影响跨年旅行、酒店、物流和年初家居焕新。", "scenes": ["跨年旅行", "酒店住宿", "年初焕新"], "products": ["酒店布草", "基础床品", "浴巾", "收纳软品"], "design": ["使用新年焕新而非单一宗教表达", "按南北半球季节调整材质"], "avoid": ["南半球正值夏季，不要统一推保暖产品"], }, "new-year-eve": { "title": "跨年夜", "relevance": "low", "decision": "仅用于运营排班", "what": "公历新年前夜或年末公共休假节点，主要影响跨年营业、物流和客服排班。", "scenes": ["跨年营业", "物流排班"], "products": [], "design": [], "avoid": ["不要把跨年夜与元旦或连续新年假期拆成多个重复消费节"], }, "super-bowl": { "title": "超级碗观赛消费节点", "relevance": "high", "decision": "值得场景备货", "what": "美国职业橄榄球年度决赛，带动家庭观赛、聚会、酒店和城市活动消费。", "scenes": ["家庭观赛", "朋友聚会", "酒店与城市活动"], "products": ["沙发盖毯", "靠垫", "坐垫", "酒吧与酒店布草"], "design": ["使用通用运动与城市氛围", "优先开发可快速换色的软装组合"], "avoid": ["球队名称、赛事标志和球员肖像涉及知识产权，未经授权不要使用"], }, "la28": { "title": "洛杉矶 2028 奥运消费周期", "relevance": "high", "decision": "提前规划", "what": "大型国际体育赛事周期，机会集中在酒店、城市旅行、团体接待和跨境礼赠。", "scenes": ["酒店升级", "城市旅行", "团体接待"], "products": ["酒店床品", "功能毛巾", "旅行毯", "团体礼赠"], "design": ["使用通用运动、城市和多文化表达", "优先开发耐洗与快干材料"], "avoid": ["奥运标志、会徽和官方称谓受保护，营销前先做授权核验"], }, "mountain-day": { "title": "日本山之日", "relevance": "low", "decision": "以运营排班为主", "what": "日本的国民祝日，鼓励亲近山林；对家纺更接近夏季出行与客服排班节点。", "scenes": ["户外出行", "短途旅行"], "products": ["便携毯", "快干毛巾"], "design": ["采用自然、山林和清爽材质表达"], "avoid": ["缺少专项消费证据时不要单独大规模压货"], }, "national:ID": { "title": "印度尼西亚独立日", "relevance": "medium", "decision": "按平台活动判断", "what": "8 月 17 日是印度尼西亚独立日，全国会举行社区庆祝和红白主题活动，也是 Shopee、Tokopedia、Lazada 与 TikTok Shop 常见的 8.17 营销节点。", "scenes": ["社区庆祝", "家庭布置", "平台 8.17 活动"], "products": ["红白软装", "轻薄床品", "快干毛巾", "户外坐垫"], "design": ["优先使用当地语言与红白生活方式场景", "热带市场突出轻薄、快干和易清洗"], "avoid": ["国旗与国家象征的使用需尊重当地规范，不要把政治符号随意商品化"], }, "national:PH": { "title": "菲律宾国家英雄日", "relevance": "low", "decision": "以排班与克制表达为主", "what": "菲律宾每年 8 月最后一个星期一纪念国家英雄，属于公共假日，但不是应默认建立家纺主题库存的强消费节。", "scenes": ["公共休假", "家庭出行", "物流与客服排班"], "products": [], "design": ["如参与平台活动，使用尊重历史与本地文化的克制表达"], "avoid": ["不要为了促销把英雄纪念语境包装成娱乐化主题"], }, "national:US": { "title": "美国独立日", "relevance": "high", "decision": "值得场景备货", "what": "7 月 4 日是美国全国性公共假日，家庭聚会、户外活动、旅行和季中促销会共同带动家居与户外纺织需求。", "scenes": ["户外聚会", "家庭烧烤", "夏季旅行", "季中促销"], "products": ["户外毯", "野餐布", "沙发盖毯", "厨房毛巾"], "design": ["使用夏季户外与家庭聚会场景", "平台素材需提前核查广告与配送截止日"], "avoid": ["国旗图形、军政元素和品牌联名不得未经核验直接使用"], }, "national:CN": { "title": "中国国庆假期", "relevance": "medium", "decision": "按内销与出行场景判断", "what": "中国国庆假期会影响国内生产、物流、客服和旅行消费节奏，跨境卖家还需提前安排工厂放假前的交付与补货。", "scenes": ["工厂与物流放假", "旅行住宿", "家庭换新"], "products": ["酒店布草", "旅行用品", "秋冬基础床品"], "design": ["重点表达秋季换新与旅行住宿", "跨境订单先锁定工厂排期"], "avoid": ["不要把国内假期误当作海外平台的统一消费节"], }, "national": { "title": "国家纪念与公共假日", "relevance": "low", "decision": "先核对当地消费证据", "what": "国家纪念日、独立日或共和国日首先影响公共休假、物流和本地广告语境；没有平台活动或消费数据时不应自动转成备货机会。", "scenes": ["公共休假", "物流排班", "本地广告语境"], "products": [], "design": ["只在确认当地平台活动后制作本地化素材"], "avoid": ["国旗、国徽和政治符号需核验使用规范；不要批量套模板或制造主题库存"], }, "memorial": { "title": "纪念日与悼念节点", "relevance": "low", "decision": "仅做排班与克制陈列", "what": "以纪念、悼念或宗教追思为主的公共节点，通常不适合强促销。", "scenes": ["公共休假", "克制陈列"], "products": [], "design": ["使用低饱和与克制表达"], "avoid": ["不要把悼念节点包装成热闹促销节"], }, "public-holiday": { "title": "地区公共假日", "relevance": "low", "decision": "仅用于运营排班", "what": "该市场的法定或地方公共假日，首先影响物流、仓储、客服和门店营业。", "scenes": ["物流排班", "客服安排"], "products": [], "design": [], "avoid": ["没有明确消费证据时，不应为了日历数量制造专项备货建议"], }, "st-stephens-day": { "title": "圣斯蒂芬节", "relevance": "low", "decision": "仅用于运营排班", "what": "12 月 26 日在欧洲、加拿大等市场使用不同当地名称庆祝或放假，部分市场也称圣诞次日或节礼日；主要影响物流、客服和门店营业，不等同于统一消费节。", "scenes": ["公共休假", "物流排班", "节后门店营业"], "products": [], "design": [], "avoid": ["不要把各国同日名称差异拆成多个节日，也不要在没有平台活动证据时专项备货"], }, } GLOBAL_AGGREGATE_KEYS = { "black-friday", "cyber-monday", "winter-holiday", "christmas", "boxing-day", "lunar-new-year", "eid-fitr", "eid-adha", "easter", "assumption-day", "new-year", "new-year-eve", "st-stephens-day", } RANGE_AGGREGATE_KEYS = {"new-year", "eid-fitr", "eid-adha", "lunar-new-year"} FESTIVAL_ENGLISH_TITLES = { "back-to-school": "Back to School", "black-friday": "Black Friday", "boxing-day": "Boxing Day", "christmas": "Christmas Day", "cyber-monday": "Cyber Monday", "easter": "Easter", "eid-adha": "Eid al-Adha", "eid-fitr": "Eid al-Fitr", "lunar-new-year": "Lunar New Year", "new-year": "New Year's Day", "new-year-eve": "New Year's Eve", "singles-day": "Singles' Day", "st-stephens-day": "St. Stephen's Day", "super-bowl": "Super Bowl", "thanksgiving": "Thanksgiving Day", "winter-holiday": "Holiday Season", } GENERIC_HOLIDAY_TITLES = {"国家纪念与公共假日", "地区公共假日"} UNSAFE_CROSS_COUNTRY_TITLES = {"独立日", "国庆日", "共和国日", "宪法日", "解放日", "胜利日", "纪念日"} HOLIDAY_TITLE_ALIASES = {"五一劳动节": "劳动节"} def _normalized_name(value: str) -> str: text = value.lower().replace("’", "'") text = re.sub(r"\([^)]*\)", " ", text) text = re.sub(r"\b(observed|substitute day|tentative date)\b", " ", text) return " ".join(re.sub(r"[^a-z0-9\u4e00-\u9fff]+", " ", text).split()) def festival_key(name: str, source_id: str = "", country_code: str = "") -> str: lower = _normalized_name(name) if source_id in ("calendar_uk_school_terms", "calendar_de_school_holidays"): return "back-to-school" if country_code == "JP" and "labour thanksgiving" in lower: return "public-holiday:JP:labour-thanksgiving" if source_id == "calendar_tmall" or "双十一" in lower: return "singles-day" if any(token in lower for token in ( "back to school", "back to college", "开学季", "返校季", "新学期", "新学年", "学生住房", "大学宿舍", "独居搬家", "学生住宿", )): return "back-to-school" if "black friday" in lower or "黑色星期五" in lower: return "black-friday" if "cyber monday" in lower or "网络星期一" in lower: return "cyber-monday" if "winter holiday" in lower or "冬季假日消费季" in lower: return "winter-holiday" if source_id == "calendar_nfl" or "super bowl" in lower or "超级碗" in lower: return "super-bowl" if source_id == "calendar_la28" or "la28" in lower or "olympic" in lower: return "la28" if any(token in lower for token in ("chinese new year", "lunar new year", "spring festival", "春节", "农历新年")): return "lunar-new-year" if "st stephen s day" in lower or "saint stephen s day" in lower or "圣斯蒂芬" in lower: return "st-stephens-day" if "boxing day" in lower or "节礼日" in lower: return "boxing-day" if "christmas" in lower or "圣诞" in lower: return "christmas" if country_code in ("US", "CA") and ("thanksgiving" in lower or "感恩节" in lower): return "thanksgiving" if "assumption" in lower or "圣母升天" in lower or lower == "假设": return "assumption-day" if "mountain day" in lower or "山之日" in lower: return "mountain-day" if any(token in lower for token in ("eid al fitr", "eid ul fitr", "hari raya puasa", "开斋")): return "eid-fitr" if any(token in lower for token in ("eid al adha", "eid ul adha", "宰牲")): return "eid-adha" if any(token in lower for token in ("easter", "good friday", "pentecost", "whit monday", "复活节", "耶稣受难")): return "easter" if any(token in lower for token in ("new year s eve", "last day of the year", "跨年夜")): return "new-year-eve" if any(token in lower for token in ("new year s day", "new year holiday", "new year s holiday", "元旦", "新年假期")): return "new-year" if any(token in lower for token in ("memorial", "remembrance", "all souls", "追悼", "纪念")): return "memorial" if any(token in lower for token in ("national", "independence", "republic", "constitution", "liberation", "victory", "国庆", "独立")): return f"national:{country_code}" if country_code else "national" return f"public-holiday:{country_code}:{lower or 'unknown'}" def calendar_event_type(name: str, source_id: str = "") -> str: key = festival_key(name, source_id) if key in ("back-to-school", "black-friday", "cyber-monday", "singles-day", "winter-holiday"): return "retail" if key in ("super-bowl", "la28"): return "sport" if key in ("eid-fitr", "eid-adha") or source_id == "calendar_aladhan": return "islamic" if key == "lunar-new-year": return "lunar-new-year" if key in ("christmas", "boxing-day", "thanksgiving"): return "christmas" if key == "easter": return "easter" if key == "national" or key.startswith("national:"): return "national" if key == "memorial": return "memorial" return "public-holiday" def holiday_title(local_name: str, english_name: str, country_code: str) -> str: normalized = _normalized_name(english_name) if country_code == "ID" and normalized == "independence day": return "印度尼西亚独立日" if country_code == "PH" and normalized == "national heroes day": return "菲律宾国家英雄日" translated = HOLIDAY_TRANSLATIONS.get(english_name.lower()) or HOLIDAY_TRANSLATIONS.get(_normalized_name(english_name)) if translated: return translated if country_code in ("CN", "JP", "KR") and local_name: return local_name return local_name or english_name or "公共假日" def platform_family(platform: str) -> str: for family in PLATFORM_PLAYBOOKS: if platform == family or platform.startswith(f"{family} "): return family return platform def platform_actions(platforms: list[str]) -> list[dict[str, str]]: actions: list[dict[str, str]] = [] for platform in platforms: family = platform_family(platform) action = PLATFORM_PLAYBOOKS.get(family) if action and not any(row["platform"] == family for row in actions): actions.append({"platform": family, "action": action}) return actions def calendar_culture(country_code: str, event_type: str) -> tuple[str, str, str]: if event_type == "islamic": return "中东及穆斯林市场", "islamic", "家庭团聚、礼赠与夜间消费" if event_type == "sport": return "全球体育消费", "sport", "观赛、旅行与酒店场景" if event_type == "retail": return COUNTRY_MARKETS.get(country_code, ("全球电商", "retail"))[0], "retail", "价格、流量与履约效率" market_group, culture_key = COUNTRY_MARKETS.get(country_code, ("全球", "central-europe")) return market_group, culture_key, "按当地文化、季节和公共假期安排运营" def profile_for(key: str) -> dict[str, Any]: if key.startswith("public-holiday:"): return FESTIVAL_PROFILES["public-holiday"] if key.startswith("national:") and key not in FESTIVAL_PROFILES: return FESTIVAL_PROFILES["national"] return FESTIVAL_PROFILES.get(key, FESTIVAL_PROFILES["public-holiday"]) def profile_for_market(key: str, country_code: str) -> dict[str, Any]: profile = dict(profile_for(key)) if key != "back-to-school": return profile overrides = { "GB": { "title": "英国秋季返校与学生住宿采购季", "what": "英国各地区秋季学期开学时间不完全一致，采购机会集中在学生住宿、耐洗床品、浴巾和小空间软装；具体日期按政府地区校历核对。", "products": ["单人床品套装", "床垫保护套", "耐洗浴巾", "宿舍收纳软品"], "design": ["突出耐洗、易护理和小空间收纳", "按英国单人床尺寸与目标学校住宿要求核对规格"], }, "DE": { "title": "德国夏末返校与学生住宿采购季", "what": "德国各州开学时间不同，机会集中在学生宿舍、租住公寓和耐用基础床品；具体州别日期以德国教育部长联席会议校历为准。", "products": ["单人被套与枕套", "床垫保护套", "耐洗毛巾", "中性色靠垫与收纳软品"], "design": ["优先低饱和中性色与耐久材质", "商品页标清厘米尺寸、洗护温度和材料认证"], }, "FR": { "title": "法国新学年返校与学生住房采购季", "what": "法国返校日按学年与大区安排，学生住房采购集中在八月下旬至九月；具体日期以法国教育部大区校历为准。", "products": ["单人被套与床单", "浴巾", "小户型窗帘", "靠垫与收纳软品"], "design": ["使用克制的低饱和色与现代图案", "法语商品页标清厘米尺寸、材质和洗护方式"], }, "JP": { "title": "日本新学期与独居搬家采购季", "what": "日本多数学校四月进入新学年，同时叠加大学入学、就职和独居搬家；具体日期由学校与地方教育委员会确定。", "products": ["日式单人寝具", "薄被与床垫保护套", "毛巾套装", "遮光窗帘与收纳软品"], "design": ["控制体积、突出易收纳与易护理", "按日本单人床和本地厘米规格核对尺寸"], }, "CA": { "title": "加拿大返校与大学宿舍采购季", "what": "加拿大返校日期按省、学区和学校安排，主要采购窗口集中在八月至九月；节点以安大略省政府校历作示例并要求复核目标省。", "products": ["保暖单人床品", "床垫保护套", "厚浴巾", "宿舍收纳与盖毯"], "design": ["兼顾早秋温差和冬季保暖", "按目标学校宿舍床型核对 Twin 与 Twin XL"], }, "AU": { "title": "澳大利亚新学年与学生住宿采购季", "what": "澳大利亚各州第一学期通常在一月至二月开始，日期由州教育部门确定；采购窗口与北半球返校季不同。", "products": ["透气单人床品", "轻薄被", "浴巾", "遮光防晒窗帘与学生公寓软装"], "design": ["按南半球夏季强调透气、凉感和防晒", "按目标州校历与当地厘米规格核对商品信息"], }, } profile.update(overrides.get(country_code, {})) return profile def calendar_opportunity(name: str, source_id: str = "") -> str: profile = profile_for(festival_key(name, source_id)) products = profile.get("products") or [] if products: return f"{profile['decision']}：优先评估{'、'.join(products[:3])}，并按平台入仓时点倒排生产。" return "以物流、客服和仓储排班为主；没有明确消费证据时不建议建立专项库存。" def _planning_stage(now: date, start: date, end: date, stocking_start: date, stocking_end: date) -> tuple[str, str]: if now > end: return "今年节点已结束", "复盘销量、退货和库存，把有效款加入下一年度计划。" if start <= now <= end: return "今年备货已结束", "当前只做履约、客服和活动复盘，不再临时追加大批库存。" if now > stocking_end: return "营销执行期", "库存不再大幅追加，重点完成素材、定价、客服和履约检查。" if now >= stocking_start: return "备货窗口", "立即确认订单、生产交期、国际物流和平台最晚入仓日期。" return "规划期", "先确定目标国家、平台和产品，再安排打样、报价与生产计划。" def enrich_calendar_item(item: dict[str, Any], now: date, country_code: str, poster_for: Callable[..., dict[str, str]]) -> dict[str, Any]: english_name = str(item.get("title_english") or "").strip() local_name = str(item.get("title_original") or "").strip() combined_name = local_name if country_code in ("AU", "GB", "NZ", "CA") and _normalized_name(local_name) == "boxing day" else english_name combined_name = combined_name or " ".join(filter(None, (str(item.get("title") or ""), local_name))) source_id = str(item.get("source_id") or "") key = festival_key(combined_name, source_id, country_code) profile = profile_for_market(key, country_code) event_type = calendar_event_type(combined_name, source_id) market_group, culture_key, cultural_note = calendar_culture(country_code, event_type) country_detail = COUNTRY_DETAILS.get(country_code, (item.get("region") or "全球", market_group, culture_key, [], [])) start = date.fromisoformat(str(item["start_date"])[:10]) end = date.fromisoformat(str(item.get("end_date") or item["start_date"])[:10]) lead_days = { "retail": 165, "sport": 180, "christmas": 150, "lunar-new-year": 165, "islamic": 120, "national": 100, "easter": 90, "memorial": 60, "public-holiday": 75, }[event_type] stocking_start = start - timedelta(days=lead_days) stocking_end = start - timedelta(days=max(21, min(45, lead_days // 3))) planning_stage, next_action = _planning_stage(now, start, end, stocking_start, stocking_end) relevance = str(profile["relevance"]) impact = "高" if relevance == "high" else ("中" if relevance == "medium" else "低") priority_score = {"high": 120, "medium": 80, "low": 35}[relevance] + max(0, 180 - min((start - now).days, 180)) // 6 item.update({ "country_code": country_code, "market_group": market_group, "culture_key": culture_key, "cultural_note": cultural_note, "festival_key": key, "event_type": event_type, "impact": impact, "business_relevance": relevance, "decision_label": profile["decision"], "what_it_is": profile["what"], "consumption_scenes": list(profile.get("scenes") or []), "design_opportunities": list(profile.get("design") or []), "cultural_avoidances": list(profile.get("avoid") or []), "languages": list(country_detail[3]), "platforms": list(country_detail[4]), "lead_days": lead_days, "stocking_start": stocking_start.isoformat(), "stocking_end": stocking_end.isoformat(), "planning_stage": planning_stage, "next_action": next_action, "days_until": (start - now).days, "priority_score": priority_score, "product_suggestions": list(profile.get("products") or []), "analysis_basis": "官方日期 + 系统经营分析", }) item["poster"] = poster_for(str(item["id"]), "calendar", culture_key) return item def _dedupe(values: list[str]) -> list[str]: return list(dict.fromkeys(value for value in values if value)) def culture_reference_url(title: str) -> str: """国际访客默认使用条目质量更完整的中文 Wikipedia。""" return f"https://zh.wikipedia.org/wiki/{quote(title.replace(' ', '_'), safe='')}" def culture_reference_cn_url(title: str, festival_key: str = "") -> str: """中国大陆访客使用国内网络更易访问的百度百科。""" aliases = {"new-year": "元旦"} return f"https://baike.baidu.com/item/{quote(aliases.get(festival_key, title), safe='')}" def visual_reference_url(title: str, country_details: list[dict[str, Any]], title_english: str = "") -> str: """图片入口只搜索节日本身，不复用来源页标题。""" detail = next((row for row in country_details if row.get("country")), {}) query_title = title_english.strip() or str(detail.get("local_name") or title).strip() if query_title in GENERIC_HOLIDAY_TITLES or not query_title: query_title = str(detail.get("local_name") or title).strip() country = str(detail.get("country_english") or detail.get("country") or "").strip() query = " ".join(_dedupe([query_title, country, "holiday"]))[:120] return f"https://www.bing.com/images/search?q={quote(query, safe='')}&setlang=zh-hans" def calendar_group_identity(item: dict[str, Any]) -> tuple[str, str]: """同日同名的明确节日跨国家聚合；国家纪念类泛称仍按国家拆分。""" key = str(item.get("festival_key") or "public-holiday") title = HOLIDAY_TITLE_ALIASES.get(str(item.get("title") or "").strip(), str(item.get("title") or "").strip()) if title and title not in GENERIC_HOLIDAY_TITLES and ( key.startswith("public-holiday:") or key == "memorial" or (key.startswith("national:") and title not in UNSAFE_CROSS_COUNTRY_TITLES) ): return f"named-holiday:{_normalized_name(title)}", "" country_partition = "" if key in GLOBAL_AGGREGATE_KEYS else str(item.get("country_code") or item.get("market_area") or item.get("region") or "") return key, country_partition def calendar_group_date(item: dict[str, Any]) -> str: """圣诞季共用一张决策卡，其他节日仍按实际日期聚合。""" start_date = str(item["start_date"]) if item.get("festival_key") in RANGE_AGGREGATE_KEYS: return f"@{start_date[:4]}" if item.get("festival_key") != "christmas": return start_date value = date.fromisoformat(start_date) season_year = value.year - 1 if value.month == 1 and value.day <= 10 else value.year return f"{season_year}-12-25" def christmas_date_label(value: str, primary_date: str) -> str: if value == primary_date: return "主要日期" month_day = value[5:] if month_day == "12-24": return "平安夜" if month_day in ("01-06", "01-07"): return "东正教传统日期" if month_day in ("12-26", "12-27", "12-28"): return "法定假日顺延" return "地区日期" def aggregate_calendar_insights(items: list[dict[str, Any]], now: date, poster_for: Callable[..., dict[str, str]]) -> list[dict[str, Any]]: grouped: dict[tuple[str, str, str], list[dict[str, Any]]] = {} for item in items: group_key, country_partition = calendar_group_identity(item) grouped.setdefault((calendar_group_date(item), group_key, country_partition), []).append(item) insights: list[dict[str, Any]] = [] for (group_date, group_key, _), rows in grouped.items(): range_group = group_date.startswith("@") start_date = min(str(row.get("start_date") or group_date) for row in rows) if range_group else group_date rows = sorted(rows, key=lambda row: ( str(row.get("start_date")) != start_date, 0 if str(row.get("country_code") or "") == "CN" else 1, str(row.get("country_code") or ""), str(row.get("start_date") or ""), )) row_keys = _dedupe([str(row.get("festival_key") or "public-holiday") for row in rows]) key = row_keys[0] if len(row_keys) == 1 else f"public-holiday:{group_key.removeprefix('named-holiday:')}" profile = profile_for_market(key, str(rows[0].get("country_code") or "")) country_codes = _dedupe([str(row.get("country_code") or "") for row in rows]) market_groups = _dedupe([str(row.get("market_group") or "") for row in rows]) languages = _dedupe([value for row in rows for value in row.get("languages") or []]) platforms = _dedupe([value for row in rows for value in row.get("platforms") or []]) titles = [str(row.get("title") or "") for row in rows if row.get("title")] title = str(profile.get("title") or Counter(titles).most_common(1)[0][0]) if key.startswith(("public-holiday:", "national:")) or key in ("national", "memorial"): title = Counter(titles).most_common(1)[0][0] english_titles = [str(row.get("title_english") or "").strip() for row in rows if row.get("title_english")] title_english = FESTIVAL_ENGLISH_TITLES.get(key, "") if not title_english and english_titles: title_english = Counter(english_titles).most_common(1)[0][0] if not title_english: original_titles = [str(row.get("title_original") or "").strip() for row in rows] title_english = next((value for value in original_titles if re.search(r"[A-Za-z]", value)), title) digest = hashlib.sha256(f"{start_date}|{key}|{'|'.join(country_codes)}".encode("utf-8")).hexdigest()[:14] official_sources = [] seen_sources: set[tuple[str, str]] = set() for row in rows: source_pair = (str(row.get("source") or ""), str(row.get("source_url") or row.get("url") or "")) if source_pair in seen_sources: continue seen_sources.add(source_pair) official_sources.append({"name": source_pair[0], "url": source_pair[1]}) relevance = str(profile["relevance"]) if not profile.get("products"): platforms = [] country_details_by_name: dict[str, dict[str, Any]] = {} for row in rows: code = str(row.get("country_code") or "") raw_region = str(row.get("region") or "") country = COUNTRY_DETAILS.get(code, (raw_region,))[0] if code else raw_region if not code and ("市场" in country or "全球" in country): continue fallback_scope = "以来源覆盖范围为准" if "市场" in raw_region or "全球" in raw_region else "全国适用" local_name = str(row.get("title_original") or row.get("title") or "") local_language = " / ".join(row.get("languages") or []) if code == "ZA" and row.get("title_english") == "Day of Goodwill": local_name, local_language = "Day of Goodwill", "英语" mapped_local = LOCAL_HOLIDAY_NAMES.get(key, {}).get(code) if mapped_local: local_name, local_language = mapped_local detail = { "country": country, "country_code": code, "country_english": COUNTRY_ENGLISH_NAMES.get(code, code), "local_name": local_name, "local_language": local_language, "languages": list(row.get("languages") or []), "scope": str(row.get("country_scope") or fallback_scope), "areas": list(row.get("applicable_areas") or (["全国"] if fallback_scope == "全国适用" else [])), "dates": [str(row.get("start_date") or start_date)], } existing = country_details_by_name.get(country) if not existing: country_details_by_name[country] = detail continue existing["languages"] = _dedupe([*existing["languages"], *detail["languages"]]) existing["areas"] = _dedupe([*existing["areas"], *detail["areas"]]) existing["dates"] = _dedupe([*existing["dates"], *detail["dates"]]) if "全国适用" in (existing["scope"], detail["scope"]): existing["scope"] = "全国适用" existing["areas"] = ["全国"] elif existing["areas"]: if country == "英国" and {"英格兰和威尔士", "苏格兰", "北爱尔兰"}.issubset(existing["areas"]): existing["scope"] = "英国全境（英格兰和威尔士、苏格兰、北爱尔兰）" else: existing["scope"] = f"仅适用于{'、'.join(existing['areas'])}" if not country_details_by_name: for code in FESTIVAL_TARGET_COUNTRIES.get(key, ()): country, target_market, _, target_languages, target_platforms = COUNTRY_DETAILS[code] local_name, local_language = LOCAL_HOLIDAY_NAMES[key][code] country_details_by_name[country] = { "country": country, "country_code": code, "country_english": COUNTRY_ENGLISH_NAMES[code], "local_name": local_name, "local_language": local_language, "languages": list(target_languages), "scope": "重点经营市场；日期与放假范围以当地官方公告为准", "areas": [], "dates": [start_date], } country_codes.append(code) market_groups.append(target_market) languages.extend(target_languages) platforms.extend(target_platforms) country_codes = _dedupe(country_codes) market_groups = _dedupe(market_groups) languages = _dedupe(languages) platforms = _dedupe(platforms) country_details = list(country_details_by_name.values()) countries = list(country_details_by_name) if len(countries) == 1: region = countries[0] elif len(countries) > 1: region = f"{market_groups[0]}多国" if len(market_groups) == 1 else f"{len(countries)} 个国家/地区" else: region = market_groups[0] if market_groups else str(rows[0].get("region") or "全球") first = rows[0] related_dates = sorted(_dedupe([str(row.get("start_date") or start_date) for row in rows])) date_variants = [] for value in related_dates: variant_rows = [row for row in rows if str(row.get("start_date") or "") == value] variant_countries = _dedupe([ COUNTRY_DETAILS.get(str(row.get("country_code") or ""), (str(row.get("region") or ""),))[0] for row in variant_rows ]) date_variants.append({ "date": value, "label": christmas_date_label(value, start_date) if key == "christmas" else "地区日期", "countries": variant_countries, }) end_date = start_date if key == "christmas" else max(str(row.get("end_date") or start_date) for row in rows) if key == "new-year" and "RU" in country_codes: end_date = max(end_date, f"{start_date[:4]}-01-08") insight = { "id": f"calendar-insight-{digest}", "section": "calendar", "source_id": str(first.get("source_id") or ""), "source": official_sources[0]["name"] if official_sources else "权威日期来源", "authority": str(first.get("authority") or "权威日期已核验"), "region": region, "title": title, "title_english": title_english, "title_original": country_details[0]["local_name"] if country_details else "", "summary": str(profile["what"]), "what_it_is": str(profile["what"]), "url": str(first.get("url") or first.get("source_url") or ""), "source_url": str(first.get("source_url") or first.get("url") or ""), "official_sources": official_sources, "image": "", "verified_at": max(str(row.get("verified_at") or "") for row in rows), "change_status": "官方日期已核验", "confidence": "高" if official_sources else "中高", "start_date": start_date, "end_date": end_date, "related_dates": related_dates, "date_variants": date_variants, "date_variation_note": ( "12月24日是平安夜；多数市场在12月25日庆祝圣诞节。部分东正教传统在次年1月6日或7日庆祝；周末产生的法定补休不代表庆祝日期改变。" if key == "christmas" else "" ), "impact": "高" if relevance == "high" else ("中" if relevance == "medium" else "低"), "business_relevance": relevance, "decision_label": str(profile["decision"]), "opportunity": str(first.get("next_action") or ""), "next_action": str(first.get("next_action") or ""), "market_group": "、".join(market_groups), "affected_regions": market_groups, "affected_countries": countries, "affected_country_codes": country_codes, "country_details": country_details, "languages": languages, "platforms": platforms, "platform_actions": platform_actions(platforms), "country_count": len(countries), "festival_key": key, "event_type": str(first.get("event_type") or "public-holiday"), "culture_key": str(first.get("culture_key") or "central-europe"), "consumption_scenes": list(profile.get("scenes") or []), "product_suggestions": list(profile.get("products") or []), "design_opportunities": list(profile.get("design") or []), "cultural_avoidances": list(profile.get("avoid") or []), "stocking_start": min(str(row.get("stocking_start") or start_date) for row in rows), "stocking_end": max(str(row.get("stocking_end") or start_date) for row in rows), "planning_stage": str(first.get("planning_stage") or "规划期"), "days_until": (date.fromisoformat(start_date) - now).days, "priority_score": max(int(row.get("priority_score") or 0) for row in rows) + min(12, len(countries)), "analysis_basis": "事实层：官方日期与适用国家；分析层：家纺经营场景推断", "visual_reference_url": visual_reference_url(title, country_details, title_english), "culture_reference_url": culture_reference_url(title), "culture_reference_cn_url": culture_reference_cn_url(title, key), } translation = { key: first[key] for key in ( "source_language", "needs_translation", "google_translation_supported", "translation_url", "translation_provider", "translation_fallback_url", "translation_fallback_provider", "translation_notice", ) if key in first } if "CN" in country_codes: translation.update({ "source_language": "zh-CN", "needs_translation": False, "google_translation_supported": False, "translation_url": "", "translation_provider": "", "translation_fallback_url": "", "translation_fallback_provider": "", "translation_notice": "该节日包含中国市场，中文访客直接查看中文节日资料。", }) insight.update(translation) insight["poster"] = poster_for(insight["id"], "calendar", insight["culture_key"]) insights.append(insight) return sorted(insights, key=lambda row: (row["start_date"], -int(row["priority_score"]), row["title"]))