姓名评测系统产品系统

立项原因： 旨在解决传统命理测算过程中人工排盘耗时长、易出错以及报告撰写格式不统一的痛点，通过自动化技术大幅提升测算效率与准确性。
行业场景： 应用于玄学文化研究、在线起名服务及个人运势咨询领域。该系统利用Python爬虫获取专业评测数据，结合内置的八字计算引擎，能够批量处理用户输入的姓名与生辰信息，自动生成包含五行分析、三才配置及详细运势解读的标准化PDF/DOCX报告，为从业者提供高效的数据支持工具。

- 信息录入模块 ：支持输入姓氏、性别、出生日期（公历/农历）、出生时间，以及待测姓名列表。系统支持同时测试多个姓名，姓名可通过空格或换行分隔。
- 命理计算模块 ：实现了完整的八字计算引擎，包括农历转换、四柱八字计算、五行分析、用神喜神判断、纳音查询、星座性格分析等功能。
- 数据爬取模块 ：集成网站爬虫，可获取专业姓名评测数据，包括字义解析、五格数理分析、三才配置、基础运、成功运、人际关系等详细信息。
- 报告生成模块 ：支持HTML预览、DOCX导出、PDF导出三种格式，报告包含基础信息、星座分析、名字解析、结构解析四大章节，采用竖排姓名、蓝色下划线标签等专业排版样式。
业务流程、功能路径描述

用户使用流程为：①录入基本信息（姓氏、性别、出生日期）→②输入待测姓名列表→③点击"开始测评"→④系统自动完成农历转换、八字计算、爬取数据→⑤展示报告预览→⑥选择导出DOCX或PDF格式报告。

1、整体架构和设计思路，不同模块使用的技术栈

系统采用前后端分离架构：

- 前端层 ：使用原生HTML/CSS/JavaScript实现，包含响应式表单、日期时间选择器、进度展示、报告预览等组件。
- 后端层 ：基于Python Flask框架构建RESTful API，包含命名服务API（ naming.py ）和导出API（ export_api.py ）两个蓝图。
- 服务层 ：包含四个核心服务类：
- LunarService ：农历转换服务
- BaziService ：八字计算服务，实现四柱八字推算、五行分析算法
- MeimingtengCrawler ：美名腾爬虫服务，基于HTTP请求获取外部数据
- ReportService ：报告生成服务，支持HTML/DOCX/PDF三种格式输出

本人独立完成了整个项目的设计与开发，包括：

- 后端架构设计：完成Flask应用初始化、CORS配置、蓝图注册，实现健康检查接口。
- 八字计算引擎：实现完整的四柱八字推算算法，包括年柱、月柱、日柱、时柱计算，五行分析，用神喜神判断。
- 报告生成服务：开发了支持DOCX和PDF格式的报告生成功能，实现了竖排姓名布局、蓝色下划线标签等专业排版样式。
- 爬虫服务集成：实现了网站数据爬取，支持批量姓名测试，提高了评测数据的专业性和完整性。
- 前端交互开发：实现了完整的用户界面，包括信息录入表单、进度展示、报告预览、导出按钮等交互组件。
在开发过程中遇到的主要难点及解决方案：

- 难点一：八字算法复杂性 ：四柱八字计算涉及天干地支推算、节气判断等复杂逻辑。解决方案：参考传统命理算法，实现了基于基准日的日柱推算方法，确保计算准确性。
- 难点二：文档格式兼容性 ：DOCX报告需要实现竖排姓名布局和蓝色下划线标签样式。解决方案：深入研究python-do