routes.py 60 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942
  1. from flask import jsonify, request, make_response, Blueprint, current_app, send_file
  2. from app.api.data_parse import bp
  3. from app.core.data_parse.parse import (
  4. update_business_card,
  5. get_business_cards,
  6. update_business_card_status,
  7. create_talent_tag,
  8. get_talent_tag_list,
  9. update_talent_tag,
  10. delete_talent_tag,
  11. query_neo4j_graph,
  12. talent_get_tags,
  13. talent_update_tags,
  14. get_business_card,
  15. search_business_cards_by_mobile,
  16. get_duplicate_records,
  17. process_duplicate_record,
  18. get_duplicate_record_detail,
  19. fix_broken_duplicate_records,
  20. get_parse_tasks,
  21. get_parse_task_detail
  22. )
  23. # 导入酒店管理相关函数
  24. from app.core.data_parse.hotel_management import (
  25. get_hotel_positions_list,
  26. add_hotel_positions,
  27. update_hotel_positions,
  28. query_hotel_positions,
  29. delete_hotel_positions,
  30. get_hotel_group_brands_list,
  31. add_hotel_group_brands,
  32. update_hotel_group_brands,
  33. query_hotel_group_brands,
  34. delete_hotel_group_brands
  35. )
  36. # 导入新的名片图片解析函数和添加名片函数
  37. from app.core.data_parse.parse_card import process_business_card_image, add_business_card, delete_business_card
  38. # 导入网页文本解析函数
  39. from app.core.data_parse.parse_web import process_webpage_with_QWen, add_webpage_talent
  40. from app.config.config import DevelopmentConfig, ProductionConfig
  41. import logging
  42. import boto3
  43. from botocore.config import Config
  44. from botocore.exceptions import ClientError
  45. from io import BytesIO
  46. import base64
  47. import os
  48. import urllib.parse
  49. from minio import Minio
  50. # Define logger
  51. logger = logging.getLogger(__name__)
  52. # For failure responses
  53. def failed(message, code=500):
  54. return {
  55. 'success': False,
  56. 'message': message,
  57. 'data': None
  58. }, code
  59. # 根据环境选择配置
  60. if os.environ.get('FLASK_ENV') == 'production':
  61. config = ProductionConfig()
  62. else:
  63. config = DevelopmentConfig()
  64. # 使用配置变量
  65. minio_url = f"{'https' if config.MINIO_SECURE else 'http'}://{config.MINIO_HOST}"
  66. minio_access_key = config.MINIO_USER
  67. minio_secret_key = config.MINIO_PASSWORD
  68. minio_bucket = config.MINIO_BUCKET
  69. use_ssl = config.MINIO_SECURE
  70. def get_minio_client():
  71. """获取 MinIO 客户端实例"""
  72. return Minio(
  73. '192.168.3.143:9000',
  74. access_key=config.MINIO_USER,
  75. secret_key=config.MINIO_PASSWORD,
  76. secure=config.MINIO_SECURE
  77. )
  78. # 名片解析接口
  79. @bp.route('/business-card-parse', methods=['POST'])
  80. def parse_business_card_route():
  81. """
  82. 解析名片图片并提取信息的API接口(仅解析,不保存到数据库)
  83. 请求参数:
  84. - image: 名片图片文件 (multipart/form-data)
  85. 返回:
  86. - JSON: 包含提取的名片信息和处理状态
  87. 注意:此接口仅负责图片解析和信息提取,不会将数据保存到数据库
  88. """
  89. # 检查是否上传了文件
  90. if 'image' not in request.files:
  91. return jsonify({
  92. 'success': False,
  93. 'message': '未上传图片',
  94. 'data': None
  95. }), 400
  96. image_file = request.files['image']
  97. # 检查文件是否为空
  98. if image_file.filename == '':
  99. return jsonify({
  100. 'success': False,
  101. 'message': '未选择文件',
  102. 'data': None
  103. }), 400
  104. # 检查文件类型是否为图片
  105. if not image_file.content_type.startswith('image/'):
  106. return jsonify({
  107. 'success': False,
  108. 'message': '上传的文件不是图片',
  109. 'data': None
  110. }), 400
  111. # 处理名片图片
  112. result = process_business_card_image(image_file)
  113. if result['success']:
  114. return jsonify(result), 200
  115. else:
  116. return jsonify(result), 500
  117. # 添加名片记录接口
  118. @bp.route('/add-business-card', methods=['POST'])
  119. def add_business_card_route():
  120. """
  121. 添加名片记录的API接口(解析图片并保存到数据库)
  122. 请求参数:
  123. - card_data: 名片信息数据 (JSON格式,可以通过form-data或JSON body传递)
  124. - image: 名片图片文件 (multipart/form-data,可选)
  125. 返回:
  126. - JSON: 包含保存结果和处理状态
  127. 注意:此接口负责业务逻辑处理,包括重复检查、MinIO上传和数据库保存
  128. """
  129. try:
  130. # 获取名片数据 - 支持两种方式
  131. card_data = None
  132. # 方式1:通过JSON body传递
  133. if request.is_json:
  134. card_data = request.get_json()
  135. # 方式2:通过form-data传递card_data字段
  136. elif 'card_data' in request.form:
  137. import json
  138. try:
  139. card_data = json.loads(request.form['card_data'])
  140. except json.JSONDecodeError:
  141. return jsonify({
  142. 'success': False,
  143. 'message': 'card_data格式错误,必须是有效的JSON字符串',
  144. 'data': None
  145. }), 400
  146. # 检查是否提供了名片数据
  147. if not card_data:
  148. return jsonify({
  149. 'success': False,
  150. 'message': '未提供名片数据,请通过JSON body或form-data的card_data字段传递',
  151. 'data': None
  152. }), 400
  153. # 获取可选的图片文件
  154. image_file = None
  155. if 'image' in request.files:
  156. image_file = request.files['image']
  157. # 检查文件是否为空
  158. if image_file.filename == '':
  159. image_file = None
  160. # 检查文件类型是否为图片
  161. elif not image_file.content_type.startswith('image/'):
  162. return jsonify({
  163. 'success': False,
  164. 'message': '上传的文件不是图片',
  165. 'data': None
  166. }), 400
  167. # 调用业务逻辑函数处理名片数据
  168. result = add_business_card(card_data, image_file)
  169. # 根据处理结果设置HTTP状态码
  170. if result['success']:
  171. if result['code'] == 200:
  172. status_code = 200
  173. elif result['code'] == 202:
  174. status_code = 202 # Accepted - 创建成功但有疑似重复记录
  175. else:
  176. status_code = 200
  177. else:
  178. if result['code'] == 400:
  179. status_code = 400
  180. else:
  181. status_code = 500
  182. return jsonify(result), status_code
  183. except Exception as e:
  184. logger.error(f"添加名片记录失败: {str(e)}")
  185. return jsonify({
  186. 'success': False,
  187. 'message': f'添加名片记录失败: {str(e)}',
  188. 'data': None
  189. }), 500
  190. # 更新名片信息接口
  191. @bp.route('/business-cards/<int:card_id>', methods=['PUT'])
  192. def update_business_card_route(card_id):
  193. """
  194. 更新名片信息的API接口
  195. 路径参数:
  196. - card_id: 名片记录ID
  197. 请求参数:
  198. - JSON格式的名片信息
  199. 返回:
  200. - JSON: 包含更新后的名片信息和处理状态
  201. """
  202. # 获取请求数据
  203. data = request.json
  204. if not data:
  205. return jsonify({
  206. 'success': False,
  207. 'message': '请求数据为空',
  208. 'data': None
  209. }), 400
  210. # 调用业务逻辑函数处理更新
  211. result = update_business_card(card_id, data)
  212. # 根据处理结果设置HTTP状态码
  213. status_code = 200 if result['success'] else 500
  214. if 'not found' in result.get('message', '').lower() or '未找到' in result.get('message', ''):
  215. status_code = 404
  216. return jsonify(result), status_code
  217. # 获取所有名片记录的API接口
  218. @bp.route('/get-business-cards', methods=['GET'])
  219. def get_business_cards_route():
  220. """
  221. 获取所有名片记录的API接口
  222. 返回:
  223. - JSON: 包含名片记录列表和处理状态
  224. """
  225. # 调用业务逻辑函数获取名片列表
  226. result = get_business_cards()
  227. # 根据处理结果设置HTTP状态码
  228. status_code = 200 if result['success'] else 500
  229. return jsonify(result), status_code
  230. @bp.route('/update-business-cards/<int:card_id>/status', methods=['PUT'])
  231. def update_business_card_status_route(card_id):
  232. """
  233. 更新名片状态的API接口
  234. 路径参数:
  235. - card_id: 名片记录ID
  236. 请求参数:
  237. - JSON格式,包含status字段
  238. 返回:
  239. - JSON: 包含更新后的名片信息和处理状态
  240. """
  241. # 获取请求数据
  242. data = request.json
  243. if not data or 'status' not in data:
  244. return jsonify({
  245. 'success': False,
  246. 'message': '请求数据为空或缺少status字段',
  247. 'data': None
  248. }), 400
  249. status = data['status']
  250. # 调用业务逻辑函数处理状态更新
  251. result = update_business_card_status(card_id, status)
  252. # 根据处理结果设置HTTP状态码
  253. status_code = 200 if result['success'] else 500
  254. if 'not found' in result.get('message', '').lower() or '未找到' in result.get('message', ''):
  255. status_code = 404
  256. return jsonify(result), status_code
  257. # 从MinIO获取名片图片的API接口
  258. @bp.route('/business-cards/image/<path:image_path>', methods=['GET'])
  259. def get_business_card_image(image_path):
  260. """
  261. 从MinIO获取名片图片的API接口
  262. 路径参数:
  263. - image_path: MinIO中的图片路径
  264. 返回:
  265. - 图片数据流
  266. """
  267. try:
  268. # 记录下载请求信息,便于调试
  269. logger.info(f"获取名片图片请求: {image_path}")
  270. # 获取 MinIO 客户端
  271. minio_client = get_minio_client()
  272. if not minio_client:
  273. return jsonify(failed("MinIO客户端初始化失败")), 500
  274. try:
  275. # 使用正确的MinIO客户端方法
  276. data = minio_client.get_object(minio_bucket, image_path)
  277. # 创建内存文件流
  278. file_stream = BytesIO(data.read())
  279. # 获取文件名
  280. file_name = image_path.split('/')[-1]
  281. # 返回文件
  282. return send_file(
  283. file_stream,
  284. as_attachment=False, # 设置为False,让浏览器直接显示图片
  285. download_name=file_name,
  286. mimetype='image/jpeg' # 根据实际图片类型设置
  287. )
  288. except Exception as e:
  289. logger.error(f"MinIO获取文件失败: {str(e)}")
  290. return jsonify(failed(f"文件获取失败: {str(e)}")), 404
  291. except Exception as e:
  292. logger.error(f"文件下载失败: {str(e)}")
  293. return jsonify(failed(str(e))), 500
  294. finally:
  295. # 确保关闭数据流
  296. if 'data' in locals():
  297. data.close()
  298. # 创建人才标签接口
  299. @bp.route('/create-talent-tag', methods=['POST'])
  300. def create_talent_tag_route():
  301. """
  302. 创建人才标签的API接口
  303. 请求参数:
  304. - JSON格式,包含以下字段:
  305. - name: 标签名称
  306. - category: 标签分类
  307. - description: 标签描述
  308. - status: 启用状态,默认为'active'
  309. 返回:
  310. - JSON: 包含创建结果和标签信息
  311. """
  312. try:
  313. # 获取请求数据
  314. data = request.get_json()
  315. if not data:
  316. return jsonify({
  317. 'success': False,
  318. 'message': '请求数据为空',
  319. 'data': None
  320. }), 400
  321. # 验证必要字段
  322. if 'name' not in data or not data['name']:
  323. return jsonify({
  324. 'success': False,
  325. 'message': '标签名称不能为空',
  326. 'data': None
  327. }), 400
  328. # 处理分类字段,如果未提供则设置默认值
  329. if 'category' not in data or not data['category']:
  330. data['category'] = '未分类'
  331. # 调用业务逻辑函数处理创建
  332. result = create_talent_tag(data)
  333. # 根据处理结果设置HTTP状态码
  334. status_code = 200 if result['success'] else 500
  335. return jsonify(result), status_code
  336. except Exception as e:
  337. logger.error(f"创建人才标签失败: {str(e)}")
  338. return jsonify({
  339. 'success': False,
  340. 'message': f'创建人才标签失败: {str(e)}',
  341. 'data': None
  342. }), 500
  343. # 获取人才标签列表接口
  344. @bp.route('/get-talent-tag-list', methods=['GET'])
  345. def get_talent_tag_list_route():
  346. """
  347. 获取人才标签列表的API接口
  348. 返回:
  349. - JSON: 包含人才标签列表和处理状态
  350. """
  351. try:
  352. # 调用业务逻辑函数获取人才标签列表
  353. result = get_talent_tag_list()
  354. # 根据处理结果设置HTTP状态码
  355. status_code = 200 if result['success'] else 500
  356. return jsonify(result), status_code
  357. except Exception as e:
  358. logger.error(f"获取人才标签列表失败: {str(e)}")
  359. return jsonify({
  360. 'success': False,
  361. 'message': f'获取人才标签列表失败: {str(e)}',
  362. 'data': []
  363. }), 500
  364. # 更新人才标签接口
  365. @bp.route('/update-talent-tag/<int:tag_id>', methods=['PUT'])
  366. def update_talent_tag_route(tag_id):
  367. """
  368. 更新人才标签的API接口
  369. 路径参数:
  370. - tag_id: 标签节点ID
  371. 请求参数:
  372. - JSON格式,可能包含以下字段:
  373. - name: 标签名称
  374. - category: 标签分类
  375. - description: 标签描述
  376. - status: 启用状态
  377. 返回:
  378. - JSON: 包含更新结果和标签信息
  379. """
  380. try:
  381. # 获取请求数据
  382. data = request.get_json()
  383. if not data:
  384. return jsonify({
  385. 'success': False,
  386. 'message': '请求数据为空',
  387. 'data': None
  388. }), 400
  389. # 调用业务逻辑函数处理更新
  390. result = update_talent_tag(tag_id, data)
  391. # 根据处理结果设置HTTP状态码
  392. if not result['success']:
  393. if result['code'] == 404:
  394. status_code = 404
  395. elif result['code'] == 400:
  396. status_code = 400
  397. else:
  398. status_code = 500
  399. else:
  400. status_code = 200
  401. return jsonify(result), status_code
  402. except Exception as e:
  403. logger.error(f"更新人才标签失败: {str(e)}")
  404. return jsonify({
  405. 'success': False,
  406. 'message': f'更新人才标签失败: {str(e)}',
  407. 'data': None
  408. }), 500
  409. # 删除人才标签接口
  410. @bp.route('/delete-talent-tag/<int:tag_id>', methods=['DELETE'])
  411. def delete_talent_tag_route(tag_id):
  412. """
  413. 删除人才标签的API接口
  414. 路径参数:
  415. - tag_id: 标签节点ID
  416. 返回:
  417. - JSON: 包含删除结果和被删除的标签信息
  418. """
  419. try:
  420. # 调用业务逻辑函数执行删除
  421. result = delete_talent_tag(tag_id)
  422. # 根据处理结果设置HTTP状态码
  423. if not result['success']:
  424. if result['code'] == 404:
  425. status_code = 404
  426. else:
  427. status_code = 500
  428. else:
  429. status_code = 200
  430. return jsonify(result), status_code
  431. except Exception as e:
  432. logger.error(f"删除人才标签失败: {str(e)}")
  433. return jsonify({
  434. 'success': False,
  435. 'message': f'删除人才标签失败: {str(e)}',
  436. 'data': None
  437. }), 500
  438. @bp.route('/query-kg', methods=['POST'])
  439. def query_kg():
  440. """
  441. 查询知识图谱API接口
  442. 请求参数:
  443. - query_requirement: 查询需求描述(JSON格式)
  444. 返回:
  445. - JSON: 包含查询结果和处理状态
  446. """
  447. try:
  448. # 获取请求数据
  449. data = request.json
  450. if not data or 'query_requirement' not in data:
  451. return jsonify({
  452. 'code': 400,
  453. 'success': False,
  454. 'message': '请求数据为空或缺少query_requirement字段',
  455. 'data': []
  456. }), 400
  457. query_requirement = data['query_requirement']
  458. # 调用业务逻辑函数执行查询
  459. result = query_neo4j_graph(query_requirement)
  460. # 根据处理结果设置HTTP状态码
  461. status_code = 200 if result['success'] else 500
  462. return jsonify(result), status_code
  463. except Exception as e:
  464. logger.error(f"查询知识图谱失败: {str(e)}")
  465. return jsonify({
  466. 'code': 500,
  467. 'success': False,
  468. 'message': f"查询知识图谱失败: {str(e)}",
  469. 'data': []
  470. }), 500
  471. @bp.route('/talent-get-tags/<int:talent_id>', methods=['GET'])
  472. def talent_get_tags_route(talent_id):
  473. """
  474. 获取人才标签的API接口
  475. 路径参数:
  476. - talent_id: 人才节点ID
  477. 返回:
  478. - JSON: 包含人才关联的标签列表和处理状态
  479. """
  480. try:
  481. # 调用业务逻辑函数获取人才标签
  482. result = talent_get_tags(talent_id)
  483. # 根据处理结果设置HTTP状态码
  484. status_code = 200 if result['success'] else 500
  485. return jsonify(result), status_code
  486. except Exception as e:
  487. logger.error(f"获取人才标签失败: {str(e)}")
  488. return jsonify({
  489. 'code': 500,
  490. 'success': False,
  491. 'message': f"获取人才标签失败: {str(e)}",
  492. 'data': []
  493. }), 500
  494. @bp.route('/talent-update-tags', methods=['POST'])
  495. def talent_update_tags_route():
  496. """
  497. 更新人才标签关系的API接口
  498. 请求参数:
  499. - JSON数组,包含talent和tag字段的对象列表
  500. 例如: [
  501. {"talent": 12345, "tag": "市场营销"},
  502. {"talent": 12345, "tag": "酒店管理"}
  503. ]
  504. 返回:
  505. - JSON: 包含更新结果的状态信息
  506. """
  507. try:
  508. # 获取请求数据
  509. data = request.json
  510. if not data:
  511. return jsonify({
  512. 'code': 400,
  513. 'success': False,
  514. 'message': '请求数据为空',
  515. 'data': None
  516. }), 400
  517. # 调用业务逻辑函数处理标签关系更新
  518. result = talent_update_tags(data)
  519. # 根据处理结果设置HTTP状态码
  520. if result['code'] == 200:
  521. status_code = 200
  522. elif result['code'] == 206:
  523. status_code = 206 # Partial Content
  524. elif result['code'] == 400:
  525. status_code = 400 # Bad Request
  526. elif result['code'] == 404:
  527. status_code = 404 # Not Found
  528. else:
  529. status_code = 500 # Internal Server Error
  530. return jsonify(result), status_code
  531. except Exception as e:
  532. logger.error(f"更新人才标签关系失败: {str(e)}")
  533. return jsonify({
  534. 'code': 500,
  535. 'success': False,
  536. 'message': f"更新人才标签关系失败: {str(e)}",
  537. 'data': None
  538. }), 500
  539. # 测试MinIO连接
  540. def test_minio_connection():
  541. """测试MinIO连接是否正常"""
  542. try:
  543. client = get_minio_client()
  544. if client.bucket_exists(minio_bucket):
  545. return {
  546. 'success': True,
  547. 'message': f'连接MinIO服务器成功,存储桶 {minio_bucket} 存在',
  548. 'config': {
  549. 'host': config.MINIO_HOST,
  550. 'bucket': minio_bucket,
  551. 'secure': use_ssl
  552. }
  553. }
  554. else:
  555. return {
  556. 'success': False,
  557. 'message': f'连接MinIO服务器成功,但存储桶 {minio_bucket} 不存在',
  558. 'config': {
  559. 'host': config.MINIO_HOST,
  560. 'bucket': minio_bucket,
  561. 'secure': use_ssl
  562. }
  563. }
  564. except Exception as e:
  565. return {
  566. 'success': False,
  567. 'message': f'连接MinIO服务器失败: {str(e)}',
  568. 'config': {
  569. 'host': config.MINIO_HOST,
  570. 'bucket': minio_bucket,
  571. 'secure': use_ssl
  572. }
  573. }
  574. # MinIO测试接口
  575. @bp.route('/test-minio-connection', methods=['GET'])
  576. def test_minio_connection_route():
  577. """
  578. 测试MinIO连接的API接口
  579. 返回:
  580. - JSON: 包含连接测试结果
  581. """
  582. try:
  583. result = test_minio_connection()
  584. status_code = 200 if result['success'] else 500
  585. return jsonify(result), status_code
  586. except Exception as e:
  587. logger.error(f"测试MinIO连接失败: {str(e)}")
  588. return jsonify({
  589. 'success': False,
  590. 'message': f'测试MinIO连接失败: {str(e)}',
  591. 'config': {
  592. 'host': config.MINIO_HOST,
  593. 'bucket': minio_bucket,
  594. 'secure': use_ssl
  595. }
  596. }), 500
  597. # 获取单个名片记录的API接口
  598. @bp.route('/get-business-card/<int:card_id>', methods=['GET'])
  599. def get_business_card_route(card_id):
  600. """
  601. 获取单个名片记录的API接口
  602. 路径参数:
  603. - card_id: 名片记录ID
  604. 返回:
  605. - JSON: 包含名片记录信息和处理状态
  606. """
  607. # 调用业务逻辑函数获取名片记录
  608. result = get_business_card(card_id)
  609. # 根据处理结果设置HTTP状态码
  610. if not result['success']:
  611. if result['code'] == 404:
  612. status_code = 404
  613. else:
  614. status_code = 500
  615. else:
  616. status_code = 200
  617. return jsonify(result), status_code
  618. @bp.route('/search-business-cards-by-mobile', methods=['GET'])
  619. def search_business_cards_by_mobile_route():
  620. """
  621. 根据手机号码搜索名片记录的API接口
  622. 查询参数:
  623. - mobile: 要搜索的手机号码
  624. 返回:
  625. - JSON: 包含搜索到的名片记录列表和处理状态
  626. 示例:
  627. GET /search-business-cards-by-mobile?mobile=13800138000
  628. """
  629. try:
  630. # 获取查询参数
  631. mobile_number = request.args.get('mobile', '').strip()
  632. if not mobile_number:
  633. return jsonify({
  634. 'success': False,
  635. 'message': '请提供要搜索的手机号码',
  636. 'data': []
  637. }), 400
  638. # 调用业务逻辑函数搜索名片记录
  639. result = search_business_cards_by_mobile(mobile_number)
  640. # 根据处理结果设置HTTP状态码
  641. if result['code'] == 200:
  642. status_code = 200
  643. elif result['code'] == 400:
  644. status_code = 400
  645. else:
  646. status_code = 500
  647. return jsonify(result), status_code
  648. except Exception as e:
  649. # 处理未预期的异常
  650. error_msg = f"根据手机号码搜索名片时发生错误: {str(e)}"
  651. logger.error(error_msg, exc_info=True)
  652. return jsonify({
  653. 'success': False,
  654. 'message': error_msg,
  655. 'data': []
  656. }), 500
  657. @bp.route('/get-hotel-positions-list', methods=['GET'])
  658. def get_hotel_positions_list_route():
  659. """
  660. 获取酒店职位数据表全部记录的API接口
  661. 返回:
  662. - JSON: 包含酒店职位记录列表和处理状态
  663. """
  664. try:
  665. # 调用业务逻辑函数获取酒店职位列表
  666. result = get_hotel_positions_list()
  667. # 根据处理结果设置HTTP状态码
  668. status_code = 200 if result['success'] else 500
  669. return jsonify(result), status_code
  670. except Exception as e:
  671. # 处理未预期的异常
  672. error_msg = f"获取酒店职位列表时发生错误: {str(e)}"
  673. logger.error(error_msg, exc_info=True)
  674. return jsonify({
  675. 'success': False,
  676. 'message': error_msg,
  677. 'data': [],
  678. 'count': 0
  679. }), 500
  680. @bp.route('/add-hotel-positions', methods=['POST'])
  681. def add_hotel_positions_route():
  682. """
  683. 新增酒店职位数据表记录的API接口
  684. 请求参数:
  685. - JSON格式,包含以下字段:
  686. - department_zh: 部门中文名称 (必填)
  687. - department_en: 部门英文名称 (必填)
  688. - position_zh: 职位中文名称 (必填)
  689. - position_en: 职位英文名称 (必填)
  690. - position_abbr: 职位英文缩写 (可选)
  691. - level_zh: 职级中文名称 (必填)
  692. - level_en: 职级英文名称 (必填)
  693. - created_by: 创建者 (可选)
  694. - updated_by: 更新者 (可选)
  695. - status: 状态 (可选)
  696. 返回:
  697. - JSON: 包含创建结果和职位信息
  698. """
  699. try:
  700. # 获取请求数据
  701. data = request.get_json()
  702. if not data:
  703. return jsonify({
  704. 'success': False,
  705. 'message': '请求数据为空',
  706. 'data': None
  707. }), 400
  708. # 调用业务逻辑函数处理创建
  709. result = add_hotel_positions(data)
  710. # 根据处理结果设置HTTP状态码
  711. if result['code'] == 200:
  712. status_code = 201 # Created
  713. elif result['code'] == 400:
  714. status_code = 400 # Bad Request
  715. elif result['code'] == 409:
  716. status_code = 409 # Conflict
  717. else:
  718. status_code = 500 # Internal Server Error
  719. return jsonify(result), status_code
  720. except Exception as e:
  721. # 处理未预期的异常
  722. error_msg = f"创建酒店职位记录时发生错误: {str(e)}"
  723. logger.error(error_msg, exc_info=True)
  724. return jsonify({
  725. 'success': False,
  726. 'message': error_msg,
  727. 'data': None
  728. }), 500
  729. @bp.route('/update-hotel-positions/<int:position_id>', methods=['PUT'])
  730. def update_hotel_positions_route(position_id):
  731. """
  732. 修改酒店职位数据表记录的API接口
  733. 路径参数:
  734. - position_id: 职位记录ID
  735. 请求参数:
  736. - JSON格式,可能包含以下字段:
  737. - department_zh: 部门中文名称
  738. - department_en: 部门英文名称
  739. - position_zh: 职位中文名称
  740. - position_en: 职位英文名称
  741. - position_abbr: 职位英文缩写
  742. - level_zh: 职级中文名称
  743. - level_en: 职级英文名称
  744. - updated_by: 更新者
  745. - status: 状态
  746. 返回:
  747. - JSON: 包含更新结果和职位信息
  748. """
  749. try:
  750. # 获取请求数据
  751. data = request.get_json()
  752. if not data:
  753. return jsonify({
  754. 'success': False,
  755. 'message': '请求数据为空',
  756. 'data': None
  757. }), 400
  758. # 调用业务逻辑函数处理更新
  759. result = update_hotel_positions(position_id, data)
  760. # 根据处理结果设置HTTP状态码
  761. if result['code'] == 200:
  762. status_code = 200 # OK
  763. elif result['code'] == 400:
  764. status_code = 400 # Bad Request
  765. elif result['code'] == 404:
  766. status_code = 404 # Not Found
  767. elif result['code'] == 409:
  768. status_code = 409 # Conflict
  769. else:
  770. status_code = 500 # Internal Server Error
  771. return jsonify(result), status_code
  772. except Exception as e:
  773. # 处理未预期的异常
  774. error_msg = f"更新酒店职位记录时发生错误: {str(e)}"
  775. logger.error(error_msg, exc_info=True)
  776. return jsonify({
  777. 'success': False,
  778. 'message': error_msg,
  779. 'data': None
  780. }), 500
  781. @bp.route('/query-hotel-positions/<int:position_id>', methods=['GET'])
  782. def query_hotel_positions_route(position_id):
  783. """
  784. 查找指定ID的酒店职位数据表记录的API接口
  785. 路径参数:
  786. - position_id: 职位记录ID
  787. 返回:
  788. - JSON: 包含查找结果和职位信息
  789. """
  790. try:
  791. # 调用业务逻辑函数查找职位记录
  792. result = query_hotel_positions(position_id)
  793. # 根据处理结果设置HTTP状态码
  794. if result['code'] == 200:
  795. status_code = 200 # OK
  796. elif result['code'] == 404:
  797. status_code = 404 # Not Found
  798. else:
  799. status_code = 500 # Internal Server Error
  800. return jsonify(result), status_code
  801. except Exception as e:
  802. # 处理未预期的异常
  803. error_msg = f"查找酒店职位记录时发生错误: {str(e)}"
  804. logger.error(error_msg, exc_info=True)
  805. return jsonify({
  806. 'success': False,
  807. 'message': error_msg,
  808. 'data': None
  809. }), 500
  810. @bp.route('/delete-hotel-positions/<int:position_id>', methods=['DELETE'])
  811. def delete_hotel_positions_route(position_id):
  812. """
  813. 删除指定ID的酒店职位数据表记录的API接口
  814. 路径参数:
  815. - position_id: 职位记录ID
  816. 返回:
  817. - JSON: 包含删除结果和被删除的职位信息
  818. """
  819. try:
  820. # 调用业务逻辑函数删除职位记录
  821. result = delete_hotel_positions(position_id)
  822. # 根据处理结果设置HTTP状态码
  823. if result['code'] == 200:
  824. status_code = 200 # OK
  825. elif result['code'] == 404:
  826. status_code = 404 # Not Found
  827. else:
  828. status_code = 500 # Internal Server Error
  829. return jsonify(result), status_code
  830. except Exception as e:
  831. # 处理未预期的异常
  832. error_msg = f"删除酒店职位记录时发生错误: {str(e)}"
  833. logger.error(error_msg, exc_info=True)
  834. return jsonify({
  835. 'success': False,
  836. 'message': error_msg,
  837. 'data': None
  838. }), 500
  839. @bp.route('/get-hotel-group-brands-list', methods=['GET'])
  840. def get_hotel_group_brands_list_route():
  841. """
  842. 获取酒店集团子品牌数据表全部记录的API接口
  843. 返回:
  844. - JSON: 包含酒店集团品牌记录列表和处理状态
  845. """
  846. try:
  847. # 调用业务逻辑函数获取酒店集团品牌列表
  848. result = get_hotel_group_brands_list()
  849. # 根据处理结果设置HTTP状态码
  850. status_code = 200 if result['success'] else 500
  851. return jsonify(result), status_code
  852. except Exception as e:
  853. # 处理未预期的异常
  854. error_msg = f"获取酒店集团品牌列表时发生错误: {str(e)}"
  855. logger.error(error_msg, exc_info=True)
  856. return jsonify({
  857. 'success': False,
  858. 'message': error_msg,
  859. 'data': [],
  860. 'count': 0
  861. }), 500
  862. @bp.route('/add-hotel-group-brands', methods=['POST'])
  863. def add_hotel_group_brands_route():
  864. """
  865. 新增酒店集团子品牌数据表记录的API接口
  866. 请求参数:
  867. - JSON格式,包含以下字段:
  868. - group_name_en: 集团英文名称 (必填)
  869. - group_name_zh: 集团中文名称 (必填)
  870. - brand_name_en: 品牌英文名称 (必填)
  871. - brand_name_zh: 品牌中文名称 (必填)
  872. - positioning_level_en: 定位级别英文名称 (必填)
  873. - positioning_level_zh: 定位级别中文名称 (必填)
  874. - created_by: 创建者 (可选)
  875. - updated_by: 更新者 (可选)
  876. - status: 状态 (可选)
  877. 返回:
  878. - JSON: 包含创建结果和品牌信息
  879. """
  880. try:
  881. # 获取请求数据
  882. data = request.get_json()
  883. if not data:
  884. return jsonify({
  885. 'success': False,
  886. 'message': '请求数据为空',
  887. 'data': None
  888. }), 400
  889. # 调用业务逻辑函数处理创建
  890. result = add_hotel_group_brands(data)
  891. # 根据处理结果设置HTTP状态码
  892. if result['code'] == 200:
  893. status_code = 201 # Created
  894. elif result['code'] == 400:
  895. status_code = 400 # Bad Request
  896. elif result['code'] == 409:
  897. status_code = 409 # Conflict
  898. else:
  899. status_code = 500 # Internal Server Error
  900. return jsonify(result), status_code
  901. except Exception as e:
  902. # 处理未预期的异常
  903. error_msg = f"创建酒店集团品牌记录时发生错误: {str(e)}"
  904. logger.error(error_msg, exc_info=True)
  905. return jsonify({
  906. 'success': False,
  907. 'message': error_msg,
  908. 'data': None
  909. }), 500
  910. @bp.route('/update-hotel-group-brands/<int:brand_id>', methods=['PUT'])
  911. def update_hotel_group_brands_route(brand_id):
  912. """
  913. 修改酒店集团子品牌数据表记录的API接口
  914. 路径参数:
  915. - brand_id: 品牌记录ID
  916. 请求参数:
  917. - JSON格式,可能包含以下字段:
  918. - group_name_en: 集团英文名称
  919. - group_name_zh: 集团中文名称
  920. - brand_name_en: 品牌英文名称
  921. - brand_name_zh: 品牌中文名称
  922. - positioning_level_en: 定位级别英文名称
  923. - positioning_level_zh: 定位级别中文名称
  924. - updated_by: 更新者
  925. - status: 状态
  926. 返回:
  927. - JSON: 包含更新结果和品牌信息
  928. """
  929. try:
  930. # 获取请求数据
  931. data = request.get_json()
  932. if not data:
  933. return jsonify({
  934. 'success': False,
  935. 'message': '请求数据为空',
  936. 'data': None
  937. }), 400
  938. # 调用业务逻辑函数处理更新
  939. result = update_hotel_group_brands(brand_id, data)
  940. # 根据处理结果设置HTTP状态码
  941. if result['code'] == 200:
  942. status_code = 200 # OK
  943. elif result['code'] == 400:
  944. status_code = 400 # Bad Request
  945. elif result['code'] == 404:
  946. status_code = 404 # Not Found
  947. elif result['code'] == 409:
  948. status_code = 409 # Conflict
  949. else:
  950. status_code = 500 # Internal Server Error
  951. return jsonify(result), status_code
  952. except Exception as e:
  953. # 处理未预期的异常
  954. error_msg = f"更新酒店集团品牌记录时发生错误: {str(e)}"
  955. logger.error(error_msg, exc_info=True)
  956. return jsonify({
  957. 'success': False,
  958. 'message': error_msg,
  959. 'data': None
  960. }), 500
  961. @bp.route('/query-hotel-group-brands/<int:brand_id>', methods=['GET'])
  962. def query_hotel_group_brands_route(brand_id):
  963. """
  964. 查找指定ID的酒店集团子品牌数据表记录的API接口
  965. 路径参数:
  966. - brand_id: 品牌记录ID
  967. 返回:
  968. - JSON: 包含查找结果和品牌信息
  969. """
  970. try:
  971. # 调用业务逻辑函数查找品牌记录
  972. result = query_hotel_group_brands(brand_id)
  973. # 根据处理结果设置HTTP状态码
  974. if result['code'] == 200:
  975. status_code = 200 # OK
  976. elif result['code'] == 404:
  977. status_code = 404 # Not Found
  978. else:
  979. status_code = 500 # Internal Server Error
  980. return jsonify(result), status_code
  981. except Exception as e:
  982. # 处理未预期的异常
  983. error_msg = f"查找酒店集团品牌记录时发生错误: {str(e)}"
  984. logger.error(error_msg, exc_info=True)
  985. return jsonify({
  986. 'success': False,
  987. 'message': error_msg,
  988. 'data': None
  989. }), 500
  990. @bp.route('/delete-hotel-group-brands/<int:brand_id>', methods=['DELETE'])
  991. def delete_hotel_group_brands_route(brand_id):
  992. """
  993. 删除指定ID的酒店集团子品牌数据表记录的API接口
  994. 路径参数:
  995. - brand_id: 品牌记录ID
  996. 返回:
  997. - JSON: 包含删除结果和被删除的品牌信息
  998. """
  999. try:
  1000. # 调用业务逻辑函数删除品牌记录
  1001. result = delete_hotel_group_brands(brand_id)
  1002. # 根据处理结果设置HTTP状态码
  1003. if result['code'] == 200:
  1004. status_code = 200 # OK
  1005. elif result['code'] == 404:
  1006. status_code = 404 # Not Found
  1007. else:
  1008. status_code = 500 # Internal Server Error
  1009. return jsonify(result), status_code
  1010. except Exception as e:
  1011. # 处理未预期的异常
  1012. error_msg = f"删除酒店集团品牌记录时发生错误: {str(e)}"
  1013. logger.error(error_msg, exc_info=True)
  1014. return jsonify({
  1015. 'success': False,
  1016. 'message': error_msg,
  1017. 'data': None
  1018. }), 500
  1019. # ==================================
  1020. # 重复记录处理API接口
  1021. # ==================================
  1022. @bp.route('/get-duplicate-records', methods=['GET'])
  1023. def get_duplicate_records_route():
  1024. """
  1025. 获取重复记录列表的API接口
  1026. 查询参数:
  1027. - status: 可选,筛选特定状态的记录 ('pending', 'processed', 'ignored')
  1028. 返回:
  1029. - JSON: 包含重复记录列表和处理状态
  1030. """
  1031. try:
  1032. # 获取查询参数
  1033. status = request.args.get('status', None)
  1034. # 验证status参数的有效性
  1035. if status and status not in ['pending', 'processed', 'ignored']:
  1036. return jsonify({
  1037. 'success': False,
  1038. 'message': 'status参数无效,必须为 pending、processed 或 ignored',
  1039. 'data': None
  1040. }), 400
  1041. # 调用业务逻辑函数获取重复记录列表
  1042. result = get_duplicate_records(status)
  1043. # 根据处理结果设置HTTP状态码
  1044. status_code = 200 if result['success'] else 500
  1045. return jsonify(result), status_code
  1046. except Exception as e:
  1047. # 处理未预期的异常
  1048. error_msg = f"获取重复记录列表时发生错误: {str(e)}"
  1049. logger.error(error_msg, exc_info=True)
  1050. return jsonify({
  1051. 'success': False,
  1052. 'message': error_msg,
  1053. 'data': [],
  1054. 'count': 0
  1055. }), 500
  1056. @bp.route('/process-duplicate-record/<int:duplicate_id>', methods=['POST'])
  1057. def process_duplicate_record_route(duplicate_id):
  1058. """
  1059. 处理重复记录的API接口
  1060. 路径参数:
  1061. - duplicate_id: 重复记录ID
  1062. 请求参数:
  1063. - JSON格式,包含以下字段:
  1064. - action: 处理动作 (必填) ('merge_to_suspected', 'keep_main', 'ignore')
  1065. - selected_duplicate_id: 当action为'merge_to_suspected'时,选择的疑似重复记录ID (可选)
  1066. - processed_by: 处理人 (可选)
  1067. - notes: 处理备注 (可选)
  1068. 返回:
  1069. - JSON: 包含处理结果和状态信息
  1070. """
  1071. try:
  1072. # 获取请求数据
  1073. data = request.get_json()
  1074. if not data:
  1075. return jsonify({
  1076. 'success': False,
  1077. 'message': '请求数据为空',
  1078. 'data': None
  1079. }), 400
  1080. # 验证必填字段
  1081. action = data.get('action')
  1082. if not action:
  1083. return jsonify({
  1084. 'success': False,
  1085. 'message': '缺少必填字段: action',
  1086. 'data': None
  1087. }), 400
  1088. # 验证action参数的有效性
  1089. if action not in ['merge_to_suspected', 'keep_main', 'ignore']:
  1090. return jsonify({
  1091. 'success': False,
  1092. 'message': 'action参数无效,必须为 merge_to_suspected、keep_main 或 ignore',
  1093. 'data': None
  1094. }), 400
  1095. # 提取其他参数
  1096. selected_duplicate_id = data.get('selected_duplicate_id')
  1097. processed_by = data.get('processed_by')
  1098. notes = data.get('notes')
  1099. # 特殊验证:如果action为merge_to_suspected,必须提供selected_duplicate_id
  1100. if action == 'merge_to_suspected' and not selected_duplicate_id:
  1101. return jsonify({
  1102. 'success': False,
  1103. 'message': '执行merge_to_suspected操作时必须提供selected_duplicate_id',
  1104. 'data': None
  1105. }), 400
  1106. # 调用业务逻辑函数处理重复记录
  1107. result = process_duplicate_record(
  1108. duplicate_id=duplicate_id,
  1109. action=action,
  1110. selected_duplicate_id=selected_duplicate_id,
  1111. processed_by=processed_by,
  1112. notes=notes
  1113. )
  1114. # 根据处理结果设置HTTP状态码
  1115. if result['code'] == 200:
  1116. status_code = 200 # OK
  1117. elif result['code'] == 400:
  1118. status_code = 400 # Bad Request
  1119. elif result['code'] == 404:
  1120. status_code = 404 # Not Found
  1121. else:
  1122. status_code = 500 # Internal Server Error
  1123. return jsonify(result), status_code
  1124. except Exception as e:
  1125. # 处理未预期的异常
  1126. error_msg = f"处理重复记录时发生错误: {str(e)}"
  1127. logger.error(error_msg, exc_info=True)
  1128. return jsonify({
  1129. 'success': False,
  1130. 'message': error_msg,
  1131. 'data': None
  1132. }), 500
  1133. @bp.route('/get-duplicate-record-detail/<int:duplicate_id>', methods=['GET'])
  1134. def get_duplicate_record_detail_route(duplicate_id):
  1135. """
  1136. 获取指定重复记录详细信息的API接口
  1137. 路径参数:
  1138. - duplicate_id: 重复记录ID
  1139. 返回:
  1140. - JSON: 包含重复记录详细信息
  1141. """
  1142. try:
  1143. # 调用业务逻辑函数获取重复记录详情
  1144. result = get_duplicate_record_detail(duplicate_id)
  1145. # 根据处理结果设置HTTP状态码
  1146. if result['code'] == 200:
  1147. status_code = 200 # OK
  1148. elif result['code'] == 404:
  1149. status_code = 404 # Not Found
  1150. else:
  1151. status_code = 500 # Internal Server Error
  1152. return jsonify(result), status_code
  1153. except Exception as e:
  1154. # 处理未预期的异常
  1155. error_msg = f"获取重复记录详情时发生错误: {str(e)}"
  1156. logger.error(error_msg, exc_info=True)
  1157. return jsonify({
  1158. 'success': False,
  1159. 'message': error_msg,
  1160. 'data': None
  1161. }), 500
  1162. # 删除名片记录接口
  1163. @bp.route('/delete-business-card/<int:card_id>', methods=['DELETE'])
  1164. def delete_business_card_route(card_id):
  1165. """
  1166. 删除名片记录的API接口
  1167. 路径参数:
  1168. - card_id: 名片记录ID (必填)
  1169. 功能说明:
  1170. - 删除PostgreSQL数据库中business_cards表的指定记录
  1171. - 删除PostgreSQL数据库中duplicate_business_cards表的相关记录
  1172. - 删除MinIO存储中的名片图片文件
  1173. - 删除Neo4j图数据库中talent节点及其关联关系
  1174. 返回:
  1175. - JSON: 包含删除操作的结果状态和被删除的记录信息
  1176. 状态码:
  1177. - 200: 完全成功删除所有相关数据
  1178. - 206: 部分成功 (PostgreSQL删除成功,但Neo4j删除失败)
  1179. - 404: 未找到指定ID的名片记录
  1180. - 500: 删除操作失败
  1181. """
  1182. try:
  1183. # 验证card_id参数
  1184. if not card_id or card_id <= 0:
  1185. return jsonify({
  1186. 'success': False,
  1187. 'message': '无效的名片记录ID',
  1188. 'data': None
  1189. }), 400
  1190. # 调用删除函数
  1191. result = delete_business_card(card_id)
  1192. # 根据处理结果设置HTTP状态码和返回响应
  1193. if result['success']:
  1194. if result['code'] == 200:
  1195. status_code = 200 # 完全成功
  1196. elif result['code'] == 206:
  1197. status_code = 206 # 部分成功
  1198. else:
  1199. status_code = 200 # 默认成功
  1200. else:
  1201. if result['code'] == 404:
  1202. status_code = 404 # 未找到记录
  1203. elif result['code'] == 400:
  1204. status_code = 400 # 参数错误
  1205. else:
  1206. status_code = 500 # 服务器错误
  1207. return jsonify(result), status_code
  1208. except Exception as e:
  1209. logger.error(f"删除名片记录失败: {str(e)}")
  1210. return jsonify({
  1211. 'success': False,
  1212. 'message': f'删除名片记录失败: {str(e)}',
  1213. 'data': None
  1214. }), 500
  1215. # 修复损坏的重复记录接口
  1216. @bp.route('/fix-broken-duplicate-records', methods=['POST'])
  1217. def fix_broken_duplicate_records_route():
  1218. """
  1219. 修复duplicate_business_cards表中main_card_id为null的损坏记录
  1220. 功能说明:
  1221. - 查找所有main_card_id为null的损坏记录
  1222. - 删除这些损坏的记录以维护数据完整性
  1223. - 返回修复操作的详细结果
  1224. 返回:
  1225. - JSON: 包含修复操作的结果和被删除记录的信息
  1226. 状态码:
  1227. - 200: 修复成功
  1228. - 500: 修复失败
  1229. 注意:
  1230. - 此操作会永久删除损坏的记录
  1231. - 建议在系统维护时执行此操作
  1232. """
  1233. try:
  1234. # 调用修复函数
  1235. result = fix_broken_duplicate_records()
  1236. # 根据结果设置状态码
  1237. if result['success']:
  1238. status_code = 200
  1239. else:
  1240. status_code = 500
  1241. return jsonify(result), status_code
  1242. except Exception as e:
  1243. logger.error(f"修复损坏记录接口调用失败: {str(e)}")
  1244. return jsonify({
  1245. 'success': False,
  1246. 'message': f'修复损坏记录接口调用失败: {str(e)}',
  1247. 'data': None
  1248. }), 500
  1249. # 网页文本解析接口
  1250. @bp.route('/webpage-parse', methods=['POST'])
  1251. def webpage_parse_route():
  1252. """
  1253. 解析网页 Markdown 文本并提取人员信息的API接口
  1254. 请求参数:
  1255. - markdown_text: 网页的 Markdown 格式文本内容 (JSON格式)
  1256. - publish_time: 发布时间,用于career_path中的date字段 (JSON格式)
  1257. 请求体示例:
  1258. {
  1259. "markdown_text": "# 张三\n\n职位:高级经理\n\n公司:XX酒店\n\n![照片](http://example.com/photo.jpg)",
  1260. "publish_time": "2025-01-15"
  1261. }
  1262. 返回:
  1263. - JSON: 包含提取的人员信息和处理状态
  1264. 功能说明:
  1265. - 接收 Markdown 格式的网页文本
  1266. - 进行必要的格式和内容验证
  1267. - 使用 Qwen VL Max 模型提取人员信息
  1268. - 支持提取照片链接 (pic_url)
  1269. - 返回标准化的人员信息数据
  1270. 状态码:
  1271. - 200: 解析成功
  1272. - 400: 请求参数错误
  1273. - 500: 解析失败
  1274. """
  1275. try:
  1276. # 检查请求是否为 JSON 格式
  1277. if not request.is_json:
  1278. return jsonify({
  1279. 'success': False,
  1280. 'message': '请求必须是 JSON 格式',
  1281. 'data': None
  1282. }), 400
  1283. # 获取请求数据
  1284. data = request.get_json()
  1285. # 检查是否提供了 markdown_text 参数
  1286. if 'markdown_text' not in data:
  1287. return jsonify({
  1288. 'success': False,
  1289. 'message': '缺少必填参数: markdown_text',
  1290. 'data': None
  1291. }), 400
  1292. # 检查是否提供了 publish_time 参数
  1293. if 'publish_time' not in data:
  1294. return jsonify({
  1295. 'success': False,
  1296. 'message': '缺少必填参数: publish_time',
  1297. 'data': None
  1298. }), 400
  1299. markdown_text = data['markdown_text']
  1300. publish_time = data['publish_time']
  1301. # 验证 markdown_text 是否为字符串
  1302. if not isinstance(markdown_text, str):
  1303. return jsonify({
  1304. 'success': False,
  1305. 'message': 'markdown_text 必须是字符串类型',
  1306. 'data': None
  1307. }), 400
  1308. # 验证 publish_time 是否为字符串
  1309. if not isinstance(publish_time, str):
  1310. return jsonify({
  1311. 'success': False,
  1312. 'message': 'publish_time 必须是字符串类型',
  1313. 'data': None
  1314. }), 400
  1315. # 验证文本内容不能为空
  1316. if not markdown_text.strip():
  1317. return jsonify({
  1318. 'success': False,
  1319. 'message': 'markdown_text 内容不能为空',
  1320. 'data': None
  1321. }), 400
  1322. # 验证文本长度(防止过长的文本)
  1323. if len(markdown_text) > 50000: # 限制最大50KB
  1324. return jsonify({
  1325. 'success': False,
  1326. 'message': 'markdown_text 内容过长,最大支持50KB',
  1327. 'data': None
  1328. }), 400
  1329. # 基本的 Markdown 格式验证(可选)
  1330. # 检查是否包含一些基本的文本内容
  1331. if len(markdown_text.strip()) < 10:
  1332. return jsonify({
  1333. 'success': False,
  1334. 'message': 'markdown_text 内容过短,无法进行有效解析',
  1335. 'data': None
  1336. }), 400
  1337. # 记录解析请求
  1338. logger.info(f"开始解析网页文本,内容长度: {len(markdown_text)} 字符")
  1339. # 调用网页文本解析函数
  1340. extracted_data = process_webpage_with_QWen(markdown_text, publish_time)
  1341. # 返回成功结果
  1342. return jsonify({
  1343. 'success': True,
  1344. 'message': '网页文本解析成功',
  1345. 'data': extracted_data
  1346. }), 200
  1347. except Exception as e:
  1348. # 记录错误日志
  1349. error_msg = f"网页文本解析失败: {str(e)}"
  1350. logger.error(error_msg, exc_info=True)
  1351. # 返回错误响应
  1352. return jsonify({
  1353. 'success': False,
  1354. 'message': error_msg,
  1355. 'data': None
  1356. }), 500
  1357. # 添加网页人才信息接口
  1358. @bp.route('/add-webpage-talent', methods=['POST'])
  1359. def add_webpage_talent_route():
  1360. """
  1361. 添加网页人才信息的API接口,包括保存网页内容和创建名片记录
  1362. 请求参数:
  1363. - talent_list: 人才信息列表,每个item包含业务卡片格式的数据 (JSON数组)
  1364. - web_md: 网页markdown文本内容 (JSON字符串)
  1365. 请求体示例:
  1366. {
  1367. "talent_list": [
  1368. {
  1369. "name_zh": "张三",
  1370. "name_en": "Zhang San",
  1371. "title_zh": "总经理",
  1372. "title_en": "General Manager",
  1373. "hotel_zh": "北京万豪酒店",
  1374. "hotel_en": "Beijing Marriott Hotel",
  1375. "brand_group": "万豪",
  1376. "mobile": "13800138000",
  1377. "email": "zhangsan@example.com"
  1378. },
  1379. {
  1380. "name_zh": "李四",
  1381. "name_en": "Li Si",
  1382. "title_zh": "市场总监",
  1383. "title_en": "Marketing Director",
  1384. "hotel_zh": "上海希尔顿酒店",
  1385. "hotel_en": "Shanghai Hilton Hotel",
  1386. "brand_group": "希尔顿",
  1387. "mobile": "13900139000",
  1388. "email": "lisi@example.com"
  1389. }
  1390. ],
  1391. "web_md": "# 人事任命公告\n\n**1** 张三被任命为北京万豪酒店总经理...\n\n**2** 李四被任命为上海希尔顿酒店市场总监..."
  1392. }
  1393. 返回:
  1394. - JSON: 包含处理结果,包括成功和失败的记录统计
  1395. 功能说明:
  1396. - 将网页markdown内容保存到MinIO
  1397. - 循环处理talent_list中的每个人才记录
  1398. - 为每个人才创建business_card记录
  1399. - 使用与名片上传相同的重复检查逻辑
  1400. - 在business_card记录的updated_by字段中记录MinIO路径
  1401. 状态码:
  1402. - 200: 所有记录处理成功
  1403. - 206: 部分记录处理成功
  1404. - 400: 请求参数错误
  1405. - 500: 处理失败
  1406. """
  1407. try:
  1408. # 检查请求是否为 JSON 格式
  1409. if not request.is_json:
  1410. return jsonify({
  1411. 'success': False,
  1412. 'message': '请求必须是 JSON 格式',
  1413. 'data': None
  1414. }), 400
  1415. # 获取请求数据
  1416. data = request.get_json()
  1417. # 检查是否提供了 talent_list 参数
  1418. if 'talent_list' not in data:
  1419. return jsonify({
  1420. 'success': False,
  1421. 'message': '缺少必填参数: talent_list',
  1422. 'data': None
  1423. }), 400
  1424. # 检查是否提供了 web_md 参数
  1425. if 'web_md' not in data:
  1426. return jsonify({
  1427. 'success': False,
  1428. 'message': '缺少必填参数: web_md',
  1429. 'data': None
  1430. }), 400
  1431. talent_list = data['talent_list']
  1432. web_md = data['web_md']
  1433. # 验证 talent_list 是否为数组
  1434. if not isinstance(talent_list, list):
  1435. return jsonify({
  1436. 'success': False,
  1437. 'message': 'talent_list 必须是数组类型',
  1438. 'data': None
  1439. }), 400
  1440. # 验证 web_md 是否为字符串
  1441. if not isinstance(web_md, str):
  1442. return jsonify({
  1443. 'success': False,
  1444. 'message': 'web_md 必须是字符串类型',
  1445. 'data': None
  1446. }), 400
  1447. # 验证数组不能为空
  1448. if len(talent_list) == 0:
  1449. return jsonify({
  1450. 'success': False,
  1451. 'message': 'talent_list 不能为空数组',
  1452. 'data': None
  1453. }), 400
  1454. # 验证文本内容不能为空
  1455. if not web_md.strip():
  1456. return jsonify({
  1457. 'success': False,
  1458. 'message': 'web_md 内容不能为空',
  1459. 'data': None
  1460. }), 400
  1461. # 验证文本长度(防止过长的文本)
  1462. if len(web_md) > 100000: # 限制最大100KB
  1463. return jsonify({
  1464. 'success': False,
  1465. 'message': 'web_md 内容过长,最大支持100KB',
  1466. 'data': None
  1467. }), 400
  1468. # 验证数组长度(防止过多记录)
  1469. if len(talent_list) > 50: # 限制最大50条记录
  1470. return jsonify({
  1471. 'success': False,
  1472. 'message': 'talent_list 记录过多,最大支持50条记录',
  1473. 'data': None
  1474. }), 400
  1475. # 基本的数据格式验证
  1476. for index, talent_data in enumerate(talent_list):
  1477. if not isinstance(talent_data, dict):
  1478. return jsonify({
  1479. 'success': False,
  1480. 'message': f'talent_list 第{index + 1}项必须是对象类型',
  1481. 'data': None
  1482. }), 400
  1483. # 检查必要的字段
  1484. if not talent_data.get('name_zh'):
  1485. return jsonify({
  1486. 'success': False,
  1487. 'message': f'talent_list 第{index + 1}项缺少必填字段: name_zh',
  1488. 'data': None
  1489. }), 400
  1490. # 记录处理请求
  1491. logger.info(f"开始处理网页人才信息,人才数量: {len(talent_list)}, 网页内容长度: {len(web_md)} 字符")
  1492. # 调用网页人才处理函数
  1493. result = add_webpage_talent(talent_list, web_md)
  1494. # 根据处理结果设置HTTP状态码
  1495. if result['success']:
  1496. if result['code'] == 200:
  1497. status_code = 200 # 全部成功
  1498. elif result['code'] == 206:
  1499. status_code = 206 # 部分成功
  1500. else:
  1501. status_code = 200 # 默认成功
  1502. else:
  1503. if result['code'] == 400:
  1504. status_code = 400 # 参数错误
  1505. else:
  1506. status_code = 500 # 服务器错误
  1507. return jsonify(result), status_code
  1508. except Exception as e:
  1509. # 记录错误日志
  1510. error_msg = f"添加网页人才信息失败: {str(e)}"
  1511. logger.error(error_msg, exc_info=True)
  1512. # 返回错误响应
  1513. return jsonify({
  1514. 'success': False,
  1515. 'message': error_msg,
  1516. 'data': None
  1517. }), 500
  1518. # 获取解析任务列表接口
  1519. @bp.route('/get-parse-tasks', methods=['GET'])
  1520. def get_parse_tasks_route():
  1521. """
  1522. 获取解析任务列表的API接口,支持分页
  1523. 查询参数:
  1524. - page: 页码,从1开始,默认为1
  1525. - per_page: 每页记录数,默认为10,最大100
  1526. - task_type: 任务类型过滤,可选
  1527. - task_status: 任务状态过滤,可选
  1528. 返回:
  1529. - JSON: 包含解析任务列表和分页信息
  1530. 功能说明:
  1531. - 支持分页查询,每页默认10条记录
  1532. - 支持按任务类型和状态过滤
  1533. - 按创建时间倒序排列
  1534. - 返回总记录数和分页信息
  1535. 状态码:
  1536. - 200: 查询成功
  1537. - 400: 请求参数错误
  1538. - 500: 查询失败
  1539. """
  1540. try:
  1541. # 获取查询参数
  1542. page = request.args.get('page', 1, type=int)
  1543. per_page = request.args.get('per_page', 10, type=int)
  1544. task_type = request.args.get('task_type', type=str)
  1545. task_status = request.args.get('task_status', type=str)
  1546. # 记录请求日志
  1547. logger.info(f"获取解析任务列表请求: page={page}, per_page={per_page}, task_type={task_type}, task_status={task_status}")
  1548. # 调用核心业务逻辑
  1549. result = get_parse_tasks(page, per_page, task_type, task_status)
  1550. # 返回结果
  1551. return jsonify({
  1552. 'success': result['success'],
  1553. 'message': result['message'],
  1554. 'data': result['data']
  1555. }), result['code']
  1556. except Exception as e:
  1557. # 记录错误日志
  1558. error_msg = f"获取解析任务列表接口失败: {str(e)}"
  1559. logger.error(error_msg, exc_info=True)
  1560. # 返回错误响应
  1561. return jsonify({
  1562. 'success': False,
  1563. 'message': error_msg,
  1564. 'data': None
  1565. }), 500
  1566. # 获取解析任务详情接口
  1567. @bp.route('/get-parse-task-detail', methods=['GET'])
  1568. def get_parse_task_detail_route():
  1569. """
  1570. 获取解析任务详情的API接口
  1571. 查询参数:
  1572. - task_name: 任务名称,必填
  1573. 返回:
  1574. - JSON: 包含任务详细信息
  1575. 功能说明:
  1576. - 根据任务名称查询指定任务的详细信息
  1577. - 返回任务的所有字段信息
  1578. - 包含解析结果的完整数据
  1579. 状态码:
  1580. - 200: 查询成功
  1581. - 400: 请求参数错误
  1582. - 404: 任务不存在
  1583. - 500: 查询失败
  1584. """
  1585. try:
  1586. # 获取查询参数
  1587. task_name = request.args.get('task_name', type=str)
  1588. # 参数验证
  1589. if not task_name:
  1590. return jsonify({
  1591. 'success': False,
  1592. 'message': '任务名称参数不能为空',
  1593. 'data': None
  1594. }), 400
  1595. # 记录请求日志
  1596. logger.info(f"获取解析任务详情请求: task_name={task_name}")
  1597. # 调用核心业务逻辑
  1598. result = get_parse_task_detail(task_name)
  1599. # 返回结果
  1600. return jsonify({
  1601. 'success': result['success'],
  1602. 'message': result['message'],
  1603. 'data': result['data']
  1604. }), result['code']
  1605. except Exception as e:
  1606. # 记录错误日志
  1607. error_msg = f"获取解析任务详情接口失败: {str(e)}"
  1608. logger.error(error_msg, exc_info=True)
  1609. # 返回错误响应
  1610. return jsonify({
  1611. 'success': False,
  1612. 'message': error_msg,
  1613. 'data': None
  1614. }), 500