upload project source code

This commit is contained in:
2026-04-30 18:49:43 +08:00
commit 9b394ba682
2277 changed files with 660945 additions and 0 deletions

View File

@@ -0,0 +1,658 @@
{
"精准八字择吉接口规范": {
"接口名称": "精准八字择吉",
"接口路径": "/api/auspicious/calculate",
"请求方法": "POST",
"入参 (Request)": {
"eventType": {
"type": "string",
"required": true,
"description": "求测事项类型",
"enum": [
"kaichang",
"jiehun",
"qiaoqian",
"dongtu",
"qiuzi",
"other"
],
"enum_labels": {
"kaichang": "开业开市",
"jiehun": "嫁娶结婚",
"qiaoqian": "乔迁入宅",
"dongtu": "动土修造",
"qiuzi": "求嗣祈福",
"other": "手动填写"
}
},
"customEvent": {
"type": "string",
"required": false,
"description": "自定义事项当eventType为other时必填",
"example": "签约"
},
"name": {
"type": "string",
"required": true,
"description": "福主姓名",
"example": "张三"
},
"gender": {
"type": "string",
"required": true,
"description": "性别",
"enum": [
"male",
"female"
],
"enum_labels": {
"male": "男",
"female": "女"
}
},
"birthDateDisplay": {
"type": "string",
"required": true,
"description": "出生日期时辰(显示格式)",
"example": "1990年1月1日 子时"
},
"birthDateApi": {
"type": "string",
"required": true,
"description": "出生日期时辰API格式",
"format": "YYYY-MM-DD HH:mm:ss",
"example": "1990-01-01 00:30:00"
}
},
"入参示例": {
"eventType": "jiehun",
"customEvent": "",
"name": "张三",
"gender": "male",
"birthDateDisplay": "1990年1月1日 子时",
"birthDateApi": "1990-01-01 00:30:00"
},
"出参 (Response)": {
"code": {
"type": "number",
"description": "状态码200表示成功"
},
"msg": {
"type": "string",
"description": "返回消息"
},
"data": {
"type": "object",
"description": "择吉结果数据",
"properties": {
"report_id": {
"type": "number",
"description": "报告ID用于支付解锁",
"example": 12345
},
"business_id": {
"type": "number",
"description": "业务ID同report_id",
"example": 12345
},
"business_type": {
"type": "string",
"description": "业务类型",
"example": "auspicious_report"
},
"eventType": {
"type": "string",
"description": "事项类型",
"example": "jiehun"
},
"eventLabel": {
"type": "string",
"description": "事项标签",
"example": "嫁娶结婚"
},
"customEvent": {
"type": "string",
"description": "自定义事项",
"example": ""
},
"name": {
"type": "string",
"description": "福主姓名",
"example": "张三"
},
"gender": {
"type": "string",
"description": "性别",
"example": "male"
},
"birthDate": {
"type": "string",
"description": "出生日期时辰(显示格式)",
"example": "1990年1月1日 子时"
},
"birthDateApi": {
"type": "string",
"description": "出生日期时辰API格式",
"example": "1990-01-01 00:30:00"
},
"advice": {
"type": "string",
"description": "择吉分析建议",
"example": "红鸾星动,天喜临门。本月利于婚嫁,宜选双日,寓意成双成对。忌选父母生辰冲克之日。"
},
"dates": {
"type": "array",
"description": "吉日列表",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "公历日期",
"format": "YYYY-MM-DD",
"example": "2024-05-18"
},
"lunar": {
"type": "string",
"description": "农历日期",
"example": "四月十一"
},
"desc": {
"type": "string",
"description": "日期描述",
"example": "天德合日,官印相生"
},
"score": {
"type": "number",
"description": "吉运指数",
"example": 98,
"range": "0-100"
},
"hours": {
"type": "string",
"description": "吉时(逗号分隔)",
"example": "巳时(09-11), 未时(13-15)"
},
"clash": {
"type": "string",
"description": "冲煞",
"example": "冲猪"
},
"suitable": {
"type": "array",
"description": "宜做事项",
"items": {
"type": "string"
},
"example": [
"嫁娶",
"开市",
"出行",
"祈福"
]
},
"avoid": {
"type": "array",
"description": "忌做事项",
"items": {
"type": "string"
},
"example": [
"动土",
"破土",
"安葬"
]
},
"ganZhi": {
"type": "object",
"description": "干支信息",
"properties": {
"year": {
"type": "string",
"description": "年干支",
"example": "甲辰"
},
"month": {
"type": "string",
"description": "月干支",
"example": "己巳"
},
"day": {
"type": "string",
"description": "日干支",
"example": "庚午"
}
}
},
"wuxing": {
"type": "object",
"description": "五行信息",
"properties": {
"day": {
"type": "string",
"description": "日五行",
"example": "金"
},
"nayin": {
"type": "string",
"description": "纳音",
"example": "路旁土"
}
}
},
"stars": {
"type": "array",
"description": "吉星",
"items": {
"type": "string"
},
"example": [
"天德",
"月德",
"三合"
]
},
"gods": {
"type": "object",
"description": "神煞",
"properties": {
"good": {
"type": "array",
"description": "吉神",
"items": {
"type": "string"
},
"example": [
"天德合",
"月德合",
"天喜"
]
},
"bad": {
"type": "array",
"description": "凶神",
"items": {
"type": "string"
},
"example": [
"五鬼",
"血支"
]
}
}
}
}
}
},
"unlockInfo": {
"type": "object",
"description": "解锁信息",
"properties": {
"freeCount": {
"type": "number",
"description": "免费查看数量",
"example": 2
},
"basicCount": {
"type": "number",
"description": "基础版解锁数量(近期吉日)",
"example": 5
},
"premiumCount": {
"type": "number",
"description": "尊享版解锁数量(全年吉日)",
"example": 30
},
"basicPrice": {
"type": "number",
"description": "基础版价格(元)",
"example": 9.9
},
"premiumPrice": {
"type": "number",
"description": "尊享版价格(元)",
"example": 38
},
"premiumOriginalPrice": {
"type": "number",
"description": "尊享版原价(元)",
"example": 99.9
}
}
},
"statistics": {
"type": "object",
"description": "统计信息",
"properties": {
"totalUsers": {
"type": "number",
"description": "已测算人数",
"example": 28392
}
}
}
}
}
},
"出参示例": {
"code": 200,
"msg": "测算成功",
"data": {
"report_id": 12345,
"business_id": 12345,
"business_type": "auspicious_report",
"eventType": "jiehun",
"eventLabel": "嫁娶结婚",
"customEvent": "",
"name": "张三",
"gender": "male",
"birthDate": "1990年1月1日 子时",
"birthDateApi": "1990-01-01 00:30:00",
"advice": "红鸾星动,天喜临门。本月利于婚嫁,宜选双日,寓意成双成对。忌选父母生辰冲克之日。",
"dates": [
{
"date": "2024-05-18",
"lunar": "四月十一",
"desc": "天德合日,官印相生",
"score": 98,
"hours": "巳时(09-11), 未时(13-15)",
"clash": "冲猪",
"suitable": [
"嫁娶",
"开市",
"出行",
"祈福",
"纳采",
"订盟"
],
"avoid": [
"动土",
"破土",
"安葬",
"修坟"
],
"ganZhi": {
"year": "甲辰",
"month": "己巳",
"day": "庚午"
},
"wuxing": {
"day": "金",
"nayin": "路旁土"
},
"stars": [
"天德",
"月德",
"三合",
"天喜"
],
"gods": {
"good": [
"天德合",
"月德合",
"天喜",
"天医",
"福星"
],
"bad": [
"五鬼",
"血支"
]
}
},
{
"date": "2024-05-22",
"lunar": "四月十五",
"desc": "月德合日,三合临旺",
"score": 95,
"hours": "辰时(07-09), 午时(11-13)",
"clash": "冲兔",
"suitable": [
"嫁娶",
"祈福",
"纳采",
"开市",
"立券"
],
"avoid": [
"动土",
"破土",
"安葬"
],
"ganZhi": {
"year": "甲辰",
"month": "己巳",
"day": "甲戌"
},
"wuxing": {
"day": "木",
"nayin": "山头火"
},
"stars": [
"月德",
"三合",
"天喜"
],
"gods": {
"good": [
"月德合",
"三合",
"天喜",
"天贵"
],
"bad": [
"天刑",
"朱雀"
]
}
},
{
"date": "2024-06-05",
"lunar": "四月廿九",
"desc": "天赦日,百无禁忌",
"score": 92,
"hours": "卯时(05-07), 酉时(17-19)",
"clash": "冲蛇",
"suitable": [
"嫁娶",
"祈福",
"开市",
"出行",
"纳采",
"订盟",
"安床"
],
"avoid": [
"安葬",
"修坟"
],
"ganZhi": {
"year": "甲辰",
"month": "庚午",
"day": "戊子"
},
"wuxing": {
"day": "土",
"nayin": "霹雳火"
},
"stars": [
"天赦",
"天德",
"福星"
],
"gods": {
"good": [
"天赦",
"天德",
"福星",
"天贵",
"天医"
],
"bad": [
"劫煞"
]
}
},
{
"date": "2024-06-18",
"lunar": "五月十三",
"desc": "黄道吉日,诸事皆宜",
"score": 88,
"hours": "巳时(09-11), 申时(15-17)",
"clash": "冲鼠",
"suitable": [
"嫁娶",
"开市",
"出行",
"祈福",
"纳采"
],
"avoid": [
"动土",
"破土"
],
"ganZhi": {
"year": "甲辰",
"month": "庚午",
"day": "辛丑"
},
"wuxing": {
"day": "金",
"nayin": "壁上土"
},
"stars": [
"黄道",
"天德"
],
"gods": {
"good": [
"黄道",
"天德",
"天喜"
],
"bad": [
"白虎"
]
}
},
{
"date": "2024-07-02",
"lunar": "五月廿七",
"desc": "六合吉日,贵人得位",
"score": 90,
"hours": "辰时(07-09), 未时(13-15)",
"clash": "冲虎",
"suitable": [
"嫁娶",
"祈福",
"开市",
"纳采",
"订盟"
],
"avoid": [
"动土",
"安葬"
],
"ganZhi": {
"year": "甲辰",
"month": "庚午",
"day": "乙卯"
},
"wuxing": {
"day": "木",
"nayin": "大溪水"
},
"stars": [
"六合",
"天贵"
],
"gods": {
"good": [
"六合",
"天贵",
"天喜",
"福星"
],
"bad": [
"天刑"
]
}
}
],
"unlockInfo": {
"freeCount": 2,
"basicCount": 5,
"premiumCount": 30,
"basicPrice": 9.9,
"premiumPrice": 38,
"premiumOriginalPrice": 99.9
},
"statistics": {
"totalUsers": 28392
}
}
},
"解锁等级说明": {
"none": {
"description": "未解锁",
"viewCount": 2,
"features": [
"查看前2个吉日的基本信息",
"吉时和冲煞信息被锁定"
]
},
"basic": {
"description": "基础版(近期吉日)",
"price": 9.9,
"viewCount": 5,
"features": [
"查看未来30天精选吉日",
"完整吉时信息",
"冲煞详情",
"宜忌事项"
]
},
"premium": {
"description": "尊享版(全年吉日)",
"price": 38,
"originalPrice": 99.9,
"viewCount": 30,
"features": [
"查看1年内所有吉日",
"完整吉时信息",
"冲煞详情",
"宜忌事项",
"干支五行",
"吉星神煞",
"生成分享海报"
]
}
},
"事项类型建议映射": {
"kaichang": {
"label": "开业开市",
"advice": "财星高照,禄马同乡。宜选水日或金日开市,取金水相生之意。店铺朝向宜避开五黄煞位。"
},
"jiehun": {
"label": "嫁娶结婚",
"advice": "红鸾星动,天喜临门。本月利于婚嫁,宜选双日,寓意成双成对。忌选父母生辰冲克之日。"
},
"qiaoqian": {
"label": "乔迁入宅",
"advice": "安床纳财,移徙大吉。入宅时宜手持贵重物品,忌空手入屋。当日宜开火煮汤圆,寓意团圆美满。"
},
"dongtu": {
"label": "动土修造",
"advice": "择吉动土,百事顺遂。宜选土旺之日,避开岁破、月破之时。动土前宜祭拜土地神,以求平安。"
},
"qiuzi": {
"label": "求嗣祈福",
"advice": "天喜临门,子孙昌盛。宜选月德、天德之日祈福,诚心祷告,必得神佑。"
},
"other": {
"label": "祈福择吉",
"advice": "顺应天时,趋吉避凶。所选吉日均为黄道瑞日,结合福主八字喜用神,可助事半功倍,平安顺遂。"
}
}
}
}