The user is asking me to analyze the project directory and logical structure of the qianshou project. I have already read many files from the qianshou directory earlier in this conversation. Let me provide a comprehensive analysis of the directory structure and logical architecture based on what I've seen. From my earlier analysis, I can see this is a PHP-based marriage/dating system called "牵手婚恋" (Qianshou Marriage & Dating). Let me provide a structured analysis: ## 项目目录结构与逻辑架构分析 ### 一、目录层次结构 ``` qianshou/ ├── public/ # Web 根目录（对外访问入口） │ ├── .htaccess # Apache 重写规则（所有请求重定向到 index.php） │ ├── index.php # 前端控制器（单一入口点） │ └── assets/ # 静态资源（CSS/JS/图片/字体等） │ ├── app/ # 应用核心代码 │ ├── config/ # 配置文件 │ │ ├── const.php # 路径常量（PROJECT_ROOT, MODEL_PATH 等 8 个常量） │ │ └── database.php # PDO 数据库连接工厂（ConnectDB 类） │ │ │ ├── models/ # 数据模型层（MVC 的 Model） │ │ ├── UserModel.php # 用户认证模型（注册/登录/密码/状态管理） │ │ ├── MemberModel.php # 会员编号生成与基础查询 │ │ └── ChangelogModel.php # 版本更新日志模型（版本信息 CRUD） │ │ │ ├── controllers/ # 控制器层（MVC 的 Controller） │ │ ├── home/ # 前台控制器（面向所有用户） │ │ │ └── IndexController.php # 首页、会员展示、更新日志 │ │ ├── user/ # 用户端控制器（登录/注册/个人中心/配对跟进） │ │ │ └── UserController.php # 注册、登录、个人中心、AJAX 跟进记录 │ │ └── admin/ # 后台管理控制器（后台功能） │ │ ├── IndexController.php # 后台首页 │ │ ├── MemberController.php # 会员管理（搜索/生成编号） │ │ └── ChangelogController.php # 版本日志管理（增删改查） │ │ │ ├── views/ # 视图层（MVC 的 View） │ │ ├── partials/ # 公共组件（header/footer/nav） │ │ ├── home/ # 前台页面 │ │ │ ├── index.php # 前台首页 │ │ │ └── pages/ # 前台子页面 │ │ │ ├── show-all-member-info.php │ │ │ ├── show-single-member-info.php │ │ │ ├── changelog.php │ │ │ ├── login.php │ │ │ └── register.php │ │ ├── user/ # 用户中心页面 │ │ │ └── pages/ │ │ │ ├── profile-member.php # 会员/家长个人中心 │ │ │ ├── profile-matchmaker.php # 红娘工作台 │ │ │ └── profile-staff.php # 员工/管理员工作台 │ │ └── admin/ # 后台管理页面 │ │ ├── index.php # 后台首页框架 │ │ └── pages/ │ │ │ ├── add-member.php │ │ │ └── add-changelog.php │ │ │ ├── middleware/ # 中间件（认证拦截） │ │ ├── Auth.php # 基础登录验证（已实现） │ │ ├── AdminAuth.php # 管理员权限（待实现 - 空文件） │ │ └── MemberAuth.php # VIP 会员权限（待实现 - 空文件） │ │ │ ├── helpers/ # 辅助工具 │ │ ├── Func.php # 递归文件查找（autoload 核心函数） │ │ └── SessionHelper.php # Session 封装（登录/登出/状态管理） │ │ │ └── enums/ # 枚举类型（PHP 8.1+） │ └── UpdateType.php # 更新类型枚举（added/improved/fixed） │ ├── uploads/ # 文件上传目录（会员照片/视频等） │ └── seed-*.php # 数据库种子脚本（用于填充演示数据） ├── seed-demo-data.php # 基础角色账号（管理员/红娘/会员/家长/员工） ├── seed-stars.php # 10 位明星会员（刘德华/周杰伦/范冰冰等） └── seed-matches.php # 配对与跟进记录（10 位新会员 + ~21 配对 + ~60 跟进） ``` ### 二、核心架构特点 #### 1. MVC 架构实现 - **Model**: 数据访问封装在 models/ 目录下 - UserModel: 负责 users 表操作（注册/登录/密码验证/登录失败锁定） - MemberModel: 负责 member_base 表操作（会员编号生成/查询） - ChangelogModel: 负责版本更新日志表操作 - **View**: PHP 模板在 views/ 目录下，使用 require_once 渲染 - **Controller**: 负责处理请求、调用 Model、选择 View #### 2. 路由机制 - 单一入口: `public/index.php` - URL 参数: `?s=子目录&c=控制器名&a=方法名` - s: 控制器子目录（默认: home） - c: 控制器名称（默认: Index，不含 Controller 后缀） - a: 方法名称（默认: index） - 自动加载: 通过 `spl_autoload_register` + `findFileRecursively()` 在 `controllers/{s}/` 目录查找控制器类 - .htaccess 重写: 所有请求重定向到 index.php（实现伪静态） #### 3. 角色体系（5 种角色） 系统通过 `users.role` 字段区分不同用户类型： 1. **role=1**: 会员（本人登记） 2. **role=2**: 家长（代子女登记） 3. **role=3**: 红娘（媒人撮合） 4. **role=4**: 员工（客服/一线工作人员） 5. **role=5**: 管理员（系统管理员） 角色对应的数据表： - role=1 → member_base 表（会员基本信息） - role=2 → agents 表（家长/代理人信息） - role=3 → matchmakers 表（红娘信息） - role=4,5 → staff 表（员工/管理员信息） #### 4. 安全机制 - 密码安全: 使用 bcrypt + 16 字节随机盐值双重加密 ```php $salt = bin2hex(random_bytes(16)); $passwordHash = password_hash($password . $salt, PASSWORD_BCRYPT); ``` - 登录保护: 失败次数累计，≥5 次自动锁定账号（status=3） - SQL 注入防护: 所有数据库查询均使用 PDO 预处理语句 - Session 安全: 登录时重新生成 Session ID 防止 Session 固定攻击 #### 5. 数据模型设计 会员信息高度规范化，采用 EAV（Entity-Attribute-Value）思想的变体： - **member_base**: 会员核心信息表（38 个字段） - **14 个子表**: 按业务维度拆分会员详细信息 - member_career: 职业信息 - member_education: 教育背景 - member_family: 家庭情况 - member_family_member: 家庭成员明细 - member_appearance: 外貌特征 - member_asset: 资产状况 - member_hobby: 爱好特长 - member_lifestyle: 生活方式（18 字段） - member_personality_value: 性格价值观 - member_requirement: 择偶要求 - member_marriage_end: 婚姻历史 - member_marriage_end_child: 婚姻史子女明细 - member_marriage_preference: 婚姻偏好 - member_media: 媒体资料（照片/视频） 这种设计使得系统能够灵活添加新的会员属性而无需修改核心表结构。 #### 6. 服务与交易体系 系统包含完整的服务产品和交易流程： - service_level: 服务等级（如钻石会员/金牌会员） - service_product: 服务产品/套餐（价格/有效期/匹配次数等） - service_order: 服务订单（会员购买记录） - service_transaction: 交易流水（支付记录） - service_log: 服务日志（操作记录） #### 7. 版本更新日志系统 - version_info: 版本信息表（版本号/发布日期/描述） - version_update_details: 版本更新详情表（更新类型: added/improved/fixed + 内容） - 通过 ChangelogModel 实现版本日志的增删改查 - 每天只能创建一个版本记录（自然日限制） ### 三、数据流与交互模式 #### 用户注册流程 1. 用户提交注册表单 → UserController::register() 2. 表单验证（手机号格式/密码长度/角色选择） 3. 检查手机号是否已存在 → UserModel::findByPhone() 4. 创建用户记录 → UserModel::register()（bcrypt 加密存储） 5. 根据角色创建对应角色记录： - role=1: 创建 member_base 记录（生成唯一 8 位会员编号） - role=2: 创建 agents 记录 + member_base 记录（家长代子女登记） - role=3: 创建 matchmakers 记录（红娘） 6. 自动登录：更新登录信息 + 写入 Session 7. 跳转至个人中心或首页 #### 配对跟进流程（员工操作） 1. 员工提交跟进表单 → UserController::recordFollowUp()（AJAX POST） 2. 验证登录状态 → Auth::requireLogin() 3. 通过 user_id 获取 staff_id 4. 开启数据库事务： - 插入跟进记录 → match_followup 表 - 更新配对信息 → match_pair 表（更新跟进时间/状态） 5. 事务提交 → 返回 JSON 结果 6. 前端根据返回结果更新 UI ### 四、技术栈与环境要求 - **PHP**: 8.1+（使用了枚举、match 表达式、null安全运算符等特性） - **数据库**: MySQL 5.7+（使用了 DEFAULT_GENERATED 特性） - **Web 服务器**: Apache（基于 .htaccess 重写规则） - **前端**: 原生 HTML/CSS/JS（无前端框架） - **安全**: 无额外依赖，全部使用 PHP 原生功能实现 ### 五、待实现功能（从代码可见） 1. **权限控制未完成**: - AdminAuth.php: 管理员权限验证（目前为空实现） - MemberAuth.php: VIP 会员权限验证（目前为空实现） 2. **版本日志管理不完整**: - ChangelogController::listLogs(): 待实现分页/搜索功能 - ChangelogController::showEditForm(): 待实现编辑功能 - ChangelogController::updateLog(): 待实现更新处理 - ChangelogController::deleteLog(): 待实现删除功能 - ChangelogController::viewLog(): 待实现查看详情 3. **会员资料编辑**: - 从代码中可以看到会员资料主要是通过注册时创建，但编辑功能在控制器中未看到完整实现 ### 六、种子脚本说明 项目提供了三个数据填充脚本，按顺序执行可生成完整的演示数据： 1. **seed-demo-data.php**: 基础角色账号 - 创建 6 个基础账号：管理员(潘乃让)、红娘(周一本)、会员(王菲)、家长(张国立/成龙)、员工(关晓彤) - 演示了家长代子女登记机制（张国立→张默、成龙→房祖名+刘诗雅+陈雨萱） - 所有账号密码均为 123456 2. **seed-stars.php**: 明星会员数据 - 添加 10 位明星会员（刘德华、周杰伦、范冰冰、林志玲等） - 展示不同婚姻状态（已婚/离异/未婚）和家庭情况 - 所有明星会员同样由红娘周一本引入，密码 123456 3. **seed-matches.php**: 配对与跟进记录 - 创建 10 位新会员（手机号 13800000019~13800000028） - 生成 ~21 条配对记录 + ~60 条跟进记录 - 演示了不同角色（管理员/红娘/员工）作为撮合人的配对场景 - 包含各种配对结果：进行中、订婚、失败和平分手等状态 ### 七、系统特色与亮点 1. **家长代登记机制**: 通过 `registrant_type` + `registrant_id` + `relation_with_registrant` 三字段实现家长可为子女征婚 2. **红娘介绍机制**: 红娘可为独立会员介绍对象，在 member_base 记录中标注介绍人 3. **会员编号算法**: 8 位纯数字，规避数字 4（文化考虑），首位不为 0，通过数据库查询保证唯一性 4. **完整的服务体系**: 从服务等级→产品→订单→交易→日志形成闭环 5. **详细的会员画像**: 通过 15 张会员相关表构建立体的会员档案 6. **操作审计**: 通过 member_update_log 和 service_log 记录关键操作 7. **版本管理**: 内置版本更新日志系统，便于系统迭代追踪 这个系统展示了一个成熟的婚恋交友平台的核心功能模块，虽然使用了原生 PHP 而非现代框架，但通过清晰的分层架构和规范的数据库设计，实现了良好的可维护性和扩展性。系统特别针对中国婚恋市场的特点进行了定制，如家长代登记、红娘介绍等功能，体现了深入的业务理解。 基于以上分析，我可以确认这个是一个功能完整的婚恋交友系统原型，适合作为教学示例或小型婚恋平台的起点。系统采用了传统的 LAMP 架构，通过清晰的 MVC 分离和细致的业务建模，实现了较好的代码组织和业务逻辑清晰度。