业务设计文档

2026-04-07-tianhe-miniapp-design.md

@@ -0,0 +1,993 @@
+# 天河基地小程序 - 软件需求文档
+
+**版本**：1.1
+**日期**：2026-04-07
+**状态**：草稿（已经 Spec Review 修订）
+
+---
+
+## 第一章 项目概述
+
+### 1.1 项目背景与目标
+
+**项目名称**：天河基地小程序
+**委托方**：天河基地（甲方）
+**开发方**：乙方技术团队
+
+**项目背景**：天河基地是以企业服务为核心的产业园区，需要一个数字化服务平台，整合园区入驻、活动、会场预约、成果对接等服务，并结合 AI 智能能力提升服务效率。
+
+**核心目标**：
+- 为企业/个人用户提供一站式园区服务入口
+- 通过飞书集成实现审批流程数字化
+- 通过 AI 能力降低信息填写门槛、提升运营洞察
+
+**交付时间**：合同签订后 **25 个工作日**内提交完整功能初版用于内部测试
+
+---
+
+### 1.2 技术架构选型
+
+| 层级 | 技术选型 |
+|------|---------|
+| 前端 | 微信原生小程序（WXML / WXSS / JavaScript）|
+| 后端 | Python（建议 FastAPI 或 Django REST Framework）|
+| 数据库 | MySQL 8.0+（关系型）|
+| 文件存储 | 腾讯云 COS 或微信云存储 |
+| AI 能力 | 接入大模型 API（如 GPT / 文心 / 通义）|
+| OCR | 腾讯云 OCR 或百度 OCR |
+| 地图 | 微信内置地图 / 腾讯地图 API |
+| 短信 | 腾讯云短信 / 阿里云短信 |
+| 第三方集成 | 飞书开放平台 API |
+| 消息推送 | 微信订阅消息 + 飞书机器人 |
+
+---
+
+### 1.3 开发周期与功能优先级
+
+**优先级定义**：
+- **P0（必须上线）**：基础功能，影响核心流程
+- **P1（应该上线）**：常规功能，提升体验
+- **P2（可延后）**：AI 增强功能，迭代优化
+
+**交付计划建议**：
+
+| 阶段 | 时间 | 目标 |
+|------|------|------|
+| 第1周 | Day 1-5 | 架构搭建、用户认证、首页、关于基地 |
+| 第2周 | Day 6-10 | 企业服务中心（入驻申请、场地展示、成果供需）+ 飞书集成启动（不可晚于 Day 6，需与客户 IT 团队联调）|
+| 第3周 | Day 11-15 | 活动与会场预约、飞书集成完成 |
+| 第4周 | Day 16-20 | 平台管理后台、消息通知、SMS 集成 |
+| 第5周 | Day 21-25 | AI 功能（P2 项目，可能延期至上线后迭代）、集成测试、联调 |
+
+> **注意**：AI 增强功能（P2）时间预算紧张，建议与甲方确认：P2 功能可在正式上线后第一个迭代版本补齐，不影响25日交付验收。
+
+---
+
+## 第二章 用户角色与权限矩阵
+
+### 2.1 角色定义
+
+| 角色 | 标识 | 说明 |
+|------|------|------|
+| 游客 | GUEST | 未登录用户，只能浏览公开信息 |
+| 注册用户 | USER | 微信登录后的普通用户 |
+| 企业用户 | ENTERPRISE | 完成企业认证的用户，可发布需求、申请入驻 |
+| 社区合伙人 | PARTNER | 审核通过后，拥有部分后台查看权限 |
+| 管理员 | ADMIN | 后台全权管理，内容审核、数据统计 |
+
+### 2.2 权限矩阵
+
+| 功能模块 | 游客 | 注册用户 | 企业用户 | 合伙人 | 管理员 |
+|---------|------|---------|---------|-------|-------|
+| 首页浏览 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 活动报名 | ❌ | ✅ | ✅ | ✅ | ✅ |
+| 活动报名信息查看 | ❌ | ❌ | ❌ | ✅ | ✅ |
+| 入驻申请 | ❌ | ✅ | ✅ | ✅ | ✅ |
+| 发布需求（找人才/资金）| ❌ | ❌ | ✅ | ✅ | ✅ |
+| 提交其他需求 | ❌ | ✅ | ✅ | ✅ | ✅ |
+| 问题反馈 | ❌ | ✅ | ✅ | ✅ | ✅ |
+| 会场预约 | ❌ | ✅ | ✅ | ✅ | ✅ |
+| 收藏/关注内容 | ❌ | ✅ | ✅ | ✅ | ✅ |
+| 内容审核 | ❌ | ❌ | ❌ | ❌ | ✅ |
+| 用户管理 | ❌ | ❌ | ❌ | ❌ | ✅ |
+| 数据统计后台 | ❌ | ❌ | ❌ | ❌ | ✅ |
+| 评分管理 | ❌ | ❌ | ❌ | ❌ | ✅ |
+
+---
+
+## 第三章 功能模块需求
+
+### 3.1 平台首页
+
+#### 用户故事
+- 作为**游客**，我希望打开小程序就能看到基地动态、活动公告、空间介绍，了解园区
+- 作为**注册用户**，我希望首页能展示与我相关的推荐内容
+- 作为**企业用户**，我希望快速入口能直达入驻申请、需求发布等核心功能
+
+#### 业务流程
+```
+用户打开小程序
+  ├── 未登录 → 展示公开内容（Banner/活动/空间）
+  └── 已登录 → 展示个性化内容 + 快捷入口
+        ├── Banner 轮播（后台配置）
+        ├── 活动公告栏（近2周活动）
+        ├── 空间展示（办公/商业/会场）
+        ├── 科技成果对接入口
+        ├── 企业需求发布入口
+        ├── 技术经理人平台入口
+        └── 申请成为社区合伙人入口
+```
+
+#### 数据模型与字段
+
+**Banner 表（`banner`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| title | VARCHAR(100) | 标题 |
+| image_url | VARCHAR(255) | 图片链接 |
+| link_type | ENUM('page','url','none') | 跳转类型 |
+| link_target | VARCHAR(255) | 跳转目标路径或 URL |
+| sort_order | INT | 排序权重 |
+| is_active | BOOLEAN | 是否启用 |
+| created_at | DATETIME | 创建时间 |
+
+#### API 接口清单
+
+| 方法 | 路径 | 说明 | 优先级 |
+|------|------|------|-------|
+| GET | `/api/v1/banners` | 获取首页 Banner 列表 | P0 |
+| GET | `/api/v1/home/activities` | 获取近2周活动（最多10条）| P0 |
+| GET | `/api/v1/home/spaces/summary` | 获取空间展示摘要 | P0 |
+| GET | `/api/v1/home/achievements` | 获取科技成果展示列表 | P0 |
+| POST | `/api/v1/partner/apply` | 提交社区合伙人申请 | P1 |
+| GET | `/api/v1/admin/partner-applications` | 后台查看合伙人申请列表 | P1 |
+| PUT | `/api/v1/admin/partner-applications/{id}/review` | 审核合伙人申请 | P1 |
+| GET | `/api/v1/admin/activity-registrations` | 合伙人/管理员查看活动报名信息 | P1 |
+
+---
+
+### 3.2 企业服务中心
+
+#### 用户故事
+- 作为**企业用户**，我希望在线提交入驻申请，并实时追踪审批进度
+- 作为**企业用户**，我希望发布招聘、融资等需求，让其他用户看到
+- 作为**企业用户**，我希望对场地/设施问题进行反馈并跟踪处理进度
+- 作为**管理员**，我希望在飞书内完成审批，结果自动同步到小程序
+
+#### 业务流程
+
+**入驻申请流程：**
+```
+企业用户填写多步骤申请表单
+  → 上传营业执照等材料（OCR 自动识别填充）
+  → 提交申请
+  → 飞书审批流程触发（通知审批人）
+  → 审批进度实时同步到小程序
+  → 审批通过 → 企业状态升级为"入驻企业"
+  → 审批拒绝 → 通知用户并说明原因
+```
+
+**成果供需发布流程：**
+```
+企业用户填写需求（找人才/找资金/找政策/找技术）
+  → AI 辅助生成标题和描述（可选）
+  → 提交审核
+  → 管理员审核通过后公开展示
+  → 其他用户可查看并联系
+```
+
+**问题反馈流程：**
+```
+用户提交反馈（场地/设施/服务）
+  → AI 自动分类工单类型
+  → 分配给对应处理人
+  → 处理人更新进度（用户实时可见）
+  → 问题解决 → 用户满意度评价
+```
+
+#### 数据模型与字段
+
+**企业信息表（`enterprise`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| user_id | INT FK | 关联用户 |
+| name | VARCHAR(100) | 企业名称 |
+| unified_credit_code | VARCHAR(50) | 统一社会信用代码 |
+| industry | VARCHAR(50) | 所属行业 |
+| scale | ENUM('1-10','11-50','51-200','200+') | 企业规模 |
+| business_license_url | VARCHAR(255) | 营业执照图片 |
+| status | ENUM('pending','approved','rejected') | 认证状态 |
+| created_at | DATETIME | 创建时间 |
+| updated_at | DATETIME | 更新时间 |
+
+**入驻申请表（`settlement_application`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| user_id | INT FK | 提交用户（直接关联，支持快速查询"我的申请"）|
+| enterprise_id | INT FK | 关联企业 |
+| project_name | VARCHAR(100) | 项目名称 |
+| project_desc | TEXT | 项目简介 |
+| space_type | ENUM('office','commercial') | 需求空间类型 |
+| space_area | DECIMAL(8,2) | 需求面积（㎡）|
+| budget | DECIMAL(10,2) | 预算（元/月）|
+| attachments | JSON | 附件 URL 列表 |
+| feishu_approval_id | VARCHAR(100) | 飞书审批实例 ID（审批触发后填写）|
+| status | ENUM('draft','submitted','reviewing','approved','rejected') | 申请状态 |
+| reject_reason | TEXT | 拒绝原因 |
+| created_at | DATETIME | 创建时间 |
+| updated_at | DATETIME | 更新时间 |
+
+**场地表（`space`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| name | VARCHAR(100) | 场地名称 |
+| type | ENUM('office','commercial') | 场地类型 |
+| images | JSON | 图片列表 |
+| floor | VARCHAR(20) | 楼层 |
+| area | DECIMAL(8,2) | 面积（㎡）|
+| price_per_month | DECIMAL(10,2) | 月租金（元）|
+| description | TEXT | 详情描述 |
+| is_available | BOOLEAN | 是否可租 |
+| sort_order | INT | 排序 |
+| created_at | DATETIME | 创建时间 |
+| updated_at | DATETIME | 更新时间 |
+
+**成果供需表（`requirement_post`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| user_id | INT FK | 发布用户（所有用户可发布"其他需求"）|
+| enterprise_id | INT FK NULLABLE | 发布企业（企业用户发布人才/资金等需求时填写）|
+| type | ENUM('talent','funding','policy','technology','other') | 需求类型（'other' 类型无需企业认证）|
+| title | VARCHAR(200) | 标题（可 AI 生成）|
+| description | TEXT | 详细描述（可 AI 生成）|
+| budget | DECIMAL(10,2) | 预算/金额（可选）|
+| attachments | JSON | 附件 URL 列表 |
+| status | ENUM('pending','published','rejected') | 审核状态 |
+| view_count | INT | 浏览次数 |
+| created_at | DATETIME | 创建时间 |
+| updated_at | DATETIME | 更新时间 |
+
+> **业务规则**：type 为 'talent'/'funding'/'technology' 时，`enterprise_id` 必填（需企业用户权限）；type 为 'other'/'policy' 时，`enterprise_id` 可为 NULL（注册用户即可发布）。
+
+**技术成果表（`tech_achievement`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| title | VARCHAR(200) | 成果名称 |
+| institution | VARCHAR(100) | 来源高校/院所 |
+| description | TEXT | 成果描述 |
+| images | JSON | 图片列表 |
+| contact_name | VARCHAR(50) | 联系人 |
+| contact_phone | VARCHAR(20) | 联系电话 |
+| status | ENUM('pending','published','archived') | 状态（archived 表示已下架）|
+| created_at | DATETIME | 创建时间 |
+| updated_at | DATETIME | 更新时间 |
+
+**技术经理人表（`tech_manager`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| name | VARCHAR(50) | 姓名 |
+| avatar_url | VARCHAR(255) | 头像 |
+| title | VARCHAR(100) | 职称/头衔 |
+| expertise | VARCHAR(200) | 擅长领域 |
+| description | TEXT | 个人简介 |
+| contact_phone | VARCHAR(20) | 联系电话 |
+| is_active | BOOLEAN | 是否展示 |
+| sort_order | INT | 排序 |
+| created_at | DATETIME | 创建时间 |
+| updated_at | DATETIME | 更新时间 |
+
+> 技术经理人为管理员维护的静态数据，通过后台 CRUD 管理。
+
+**用户收藏表（`user_favorite`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| user_id | INT FK | 关联用户 |
+| target_type | ENUM('activity','requirement','achievement','tech_manager','policy') | 收藏内容类型 |
+| target_id | INT | 被收藏内容的 ID |
+| created_at | DATETIME | 收藏时间 |
+
+> UNIQUE 约束：`(user_id, target_type, target_id)`，防止重复收藏。
+
+**社区合伙人申请表（`partner_application`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| user_id | INT FK | 申请用户 |
+| name | VARCHAR(50) | 姓名 |
+| company | VARCHAR(100) | 单位 |
+| reason | TEXT | 申请理由 |
+| status | ENUM('pending','approved','rejected') | 审核状态 |
+| reject_reason | TEXT | 拒绝原因 |
+| created_at | DATETIME | 申请时间 |
+| updated_at | DATETIME | 更新时间 |
+
+**问题工单表（`feedback_ticket`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| user_id | INT FK | 提交用户 |
+| category | ENUM('space','facility','service','other') | 问题分类（AI 自动分类）|
+| title | VARCHAR(200) | 问题标题 |
+| content | TEXT | 问题详情 |
+| attachments | JSON | 图片附件 |
+| assignee_id | INT FK | 处理人 |
+| status | ENUM('pending','processing','resolved','closed') | 工单状态 |
+| satisfaction | TINYINT | 满意度评分（1-5）|
+| created_at | DATETIME | 创建时间 |
+| resolved_at | DATETIME | 解决时间 |
+| updated_at | DATETIME | 更新时间 |
+
+#### API 接口清单
+
+| 方法 | 路径 | 说明 | 优先级 |
+|------|------|------|-------|
+| POST | `/api/v1/settlement/apply` | 提交入驻申请 | P0 |
+| GET | `/api/v1/settlement/status` | 查询我的申请状态 | P0 |
+| GET | `/api/v1/spaces` | 获取场地列表 | P0 |
+| GET | `/api/v1/spaces/{id}` | 获取场地详情 | P0 |
+| GET | `/api/v1/achievements` | 获取科技成果列表 | P0 |
+| GET | `/api/v1/tech-managers` | 获取技术经理人列表 | P0 |
+| GET | `/api/v1/requirements` | 获取成果供需列表 | P0 |
+| POST | `/api/v1/requirements` | 发布需求（人才/资金等）| P0 |
+| GET | `/api/v1/requirements/{id}` | 需求详情 | P0 |
+| POST | `/api/v1/feedback` | 提交问题反馈 | P0 |
+| GET | `/api/v1/feedback/mine` | 查看我的反馈工单列表 | P0 |
+| GET | `/api/v1/feedback/{id}` | 查看工单详情及进度 | P0 |
+| POST | `/api/v1/feedback/{id}/rate` | 提交满意度评价 | P0 |
+| POST | `/api/v1/favorites` | 添加收藏 | P1 |
+| DELETE | `/api/v1/favorites/{target_type}/{target_id}` | 取消收藏 | P1 |
+| GET | `/api/v1/favorites` | 我的收藏列表（可按 target_type 筛选）| P1 |
+| POST | `/api/v1/ai/generate-content` | AI 辅助生成需求标题/描述 | P2 |
+| POST | `/api/v1/ocr/business-license` | 营业执照 OCR 识别 | P1 |
+| POST | `/api/v1/ai/classify-feedback` | AI 自动分类工单 | P2 |
+| GET | `/api/v1/ai/recommend-spaces` | AI 智能推荐场地（别名同 recommend-venues）| P2 |
+
+---
+
+### 3.3 活动与会场
+
+#### 用户故事
+- 作为**注册用户**，我希望浏览活动列表并在线报名，收到活动提醒
+- 作为**注册用户**，我希望查看会场详情并在线预约会议室
+- 作为**管理员**，我希望审批会场申请并自动推送门禁密码给预约人
+
+#### 业务流程
+
+**活动报名流程：**
+```
+用户浏览活动列表（支持卡片/瀑布流）
+  → 查看活动详情（图片/时间/地点定位）
+  → 选择报名方式
+      ├── 扫二维码报名
+      └── 小程序内填写信息报名
+  → 报名成功 → 微信订阅消息通知
+  → 活动开始前3天自动提醒
+```
+
+**会场预约流程：**
+```
+用户浏览会场列表（按时间/容量/设施筛选）
+  → 查看会场详情（图片/规格/租金）
+  → 选择预约类型
+      ├── 共享会议室 → 直接选时间段预约
+      └── 大型会场 → 填写申请资料 + 上传文件
+  → 提交预约
+  → 管理员审批（大型会场）或直接确认（共享会议室）
+  → 预约成功 → 推送确认通知 + 门禁密码
+  → 使用后自动统计会场使用率
+```
+
+#### 数据模型与字段
+
+**活动表（`activity`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| title | VARCHAR(200) | 活动名称 |
+| cover_image | VARCHAR(255) | 封面图 |
+| images | JSON | 活动图片列表 |
+| content | TEXT | 活动详情（富文本）|
+| start_time | DATETIME | 开始时间 |
+| end_time | DATETIME | 结束时间 |
+| location | VARCHAR(200) | 活动地点 |
+| latitude | DECIMAL(10,7) | 纬度 |
+| longitude | DECIMAL(10,7) | 经度 |
+| signup_type | ENUM('qrcode','inapp','both') | 报名方式 |
+| qrcode_url | VARCHAR(255) | 二维码图片 |
+| max_participants | INT | 最大报名人数（0为不限）|
+| current_participants | INT | 当前报名人数 |
+| status | ENUM('draft','published','cancelled','ended') | 活动状态 |
+| created_by | INT FK | 创建管理员 |
+| created_at | DATETIME | 创建时间 |
+| updated_at | DATETIME | 更新时间 |
+
+**活动报名表（`activity_registration`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| activity_id | INT FK | 关联活动 |
+| user_id | INT FK | 报名用户 |
+| name | VARCHAR(50) | 姓名 |
+| phone | VARCHAR(20) | 手机号 |
+| company | VARCHAR(100) | 单位（可选）|
+| extra_info | JSON | 自定义报名字段 |
+| status | ENUM('registered','cancelled') DEFAULT 'registered' | 报名状态 |
+| registered_at | DATETIME | 报名时间 |
+| updated_at | DATETIME | 更新时间 |
+
+> UNIQUE 约束：`(activity_id, user_id)`，防止重复报名。取消报名通过 status 字段标记，不删除记录。
+
+**会场表（`venue`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| name | VARCHAR(100) | 会场名称 |
+| type | ENUM('meeting_room','conference','hall') | 类型 |
+| images | JSON | 图片列表 |
+| capacity | INT | 容纳人数 |
+| area | DECIMAL(8,2) | 面积（㎡）|
+| floor | VARCHAR(20) | 楼层 |
+| price_per_hour | DECIMAL(8,2) | 每小时租金 |
+| facilities | JSON | 设施列表（投影/白板/空调等）|
+| is_shared | BOOLEAN | 是否共享会议室（直接预约）|
+| is_active | BOOLEAN | 是否可预约 |
+| created_at | DATETIME | 创建时间 |
+| updated_at | DATETIME | 更新时间 |
+
+**会场预约表（`venue_booking`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| venue_id | INT FK | 关联会场 |
+| user_id | INT FK | 预约用户 |
+| enterprise_id | INT FK NULLABLE | 关联企业（可选）|
+| start_time | DATETIME | 预约开始时间 |
+| end_time | DATETIME | 预约结束时间 |
+| purpose | TEXT | 使用目的 |
+| participants_count | INT | 参与人数 |
+| attachments | JSON | 申请附件（大型会场）|
+| feishu_approval_id | VARCHAR(100) NULLABLE | 飞书审批实例 ID（大型会场审批触发后填写）|
+| access_code | VARCHAR(20) | 门禁密码（审批通过后生成）|
+| status | ENUM('pending','approved','rejected','cancelled','completed') | 预约状态 |
+| reject_reason | TEXT | 拒绝原因 |
+| created_at | DATETIME | 创建时间 |
+| updated_at | DATETIME | 更新时间 |
+
+#### API 接口清单
+
+| 方法 | 路径 | 说明 | 优先级 |
+|------|------|------|-------|
+| GET | `/api/v1/activities` | 活动列表（分页+筛选）| P0 |
+| GET | `/api/v1/activities/{id}` | 活动详情 | P0 |
+| POST | `/api/v1/activities/{id}/register` | 活动报名 | P0 |
+| PUT | `/api/v1/activities/{id}/cancel-registration` | 取消报名 | P0 |
+| GET | `/api/v1/my/activity-registrations` | 我的报名记录 | P0 |
+| GET | `/api/v1/venues` | 会场列表（支持筛选）| P0 |
+| GET | `/api/v1/venues/{id}` | 会场详情 | P0 |
+| GET | `/api/v1/venues/{id}/availability` | 查询会场可用时间段 | P0 |
+| POST | `/api/v1/venues/{id}/book` | 提交会场预约 | P0 |
+| GET | `/api/v1/my/venue-bookings` | 我的预约记录 | P0 |
+| GET | `/api/v1/ai/recommend-activities` | AI 推荐活动 | P2 |
+
+---
+
+### 3.4 AI 智能助手
+
+#### 用户故事
+- 作为**用户**，我希望发布需求时 AI 能根据关键词自动生成标题和描述
+- 作为**用户**，我希望活动开始前3天收到自动提醒
+- 作为**管理员**，我希望 AI 自动分类反馈工单，减少人工分拣
+
+#### AI 能力清单与调用策略
+
+| AI 功能 | 触发时机 | 调用方式 | 降级方案 | 优先级 |
+|---------|---------|---------|---------|-------|
+| 智能表单填写 | OCR 识别营业执照后 | 同步调用 | 用户手动填写 | P1 |
+| 需求内容生成 | 用户输入关键词时 | 异步调用 | 用户自行编写 | P2 |
+| 智能场地推荐 | 用户进入找场地页面 | 异步调用 | 展示全部列表 | P2 |
+| 工单自动分类 | 用户提交反馈后 | 异步调用 | 默认分类"其他" | P2 |
+| 活动智能推荐 | 用户进入活动列表 | 异步调用 | 按时间排序 | P2 |
+| AI 数据分析报告 | 管理员触发/定时任务 | 异步调用 | 展示原始数据 | P2 |
+| 满意度分析 | 评价数据积累后 | 定时批处理 | 跳过 | P2 |
+
+#### 数据模型与字段
+
+**AI 调用日志表（`ai_call_log`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| user_id | INT FK | 调用用户 |
+| feature | VARCHAR(50) | 功能标识 |
+| input | TEXT | 输入内容 |
+| output | TEXT | AI 输出内容 |
+| tokens_used | INT | Token 消耗 |
+| latency_ms | INT | 响应时长（ms）|
+| status | ENUM('success','failed','fallback') | 调用状态 |
+| created_at | DATETIME | 调用时间 |
+
+#### API 接口清单
+
+| 方法 | 路径 | 说明 | 优先级 |
+|------|------|------|-------|
+| POST | `/api/v1/ai/generate-content` | AI 生成需求标题/描述 | P2 |
+| POST | `/api/v1/ai/classify-feedback` | AI 分类工单 | P2 |
+| POST | `/api/v1/ai/recommend-venues` | 智能推荐场地（统一入口）| P2 |
+| GET | `/api/v1/ai/recommend-activities` | 推荐活动列表 | P2 |
+| POST | `/api/v1/ai/analysis-report` | 生成数据分析报告 | P2 |
+
+---
+
+### 3.5 系统集成
+
+#### 3.5.1 飞书集成
+
+**审批流程集成**：
+
+```
+入驻申请提交
+  → 后端调用飞书审批 API 创建审批实例
+  → 飞书推送审批任务给审批人
+  → 审批人在飞书完成审批
+  → 飞书回调 Webhook 通知后端
+  → 后端更新申请状态
+  → 微信订阅消息通知申请人结果
+```
+
+**飞书集成配置（环境变量 + 运营配置表）**
+
+> **安全说明**：飞书 `app_id` 和 `app_secret` 通过环境变量注入（`FEISHU_APP_ID` / `FEISHU_APP_SECRET`），不存入数据库，与 Section 5.2 安全要求保持一致。
+
+数据库仅存储非敏感运营配置：
+
+**飞书运营配置表（`feishu_config`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键（单行）|
+| approval_code | VARCHAR(100) | 审批定义 Code |
+| webhook_token | VARCHAR(100) | 回调验证 Token |
+| is_active | BOOLEAN | 是否启用飞书集成 |
+| updated_at | DATETIME | 最后更新时间 |
+
+#### 3.5.2 OCR 识别
+
+| 识别场景 | 文件类型 | 提取字段 |
+|---------|---------|---------|
+| 营业执照 | 图片/PDF | 企业名称、统一社会信用代码、法人姓名、注册地址 |
+| 项目计划书 | PDF/Word | 项目名称、团队规模（辅助填写）|
+
+#### 3.5.3 短信服务
+
+短信服务用于手机号验证码绑定，作为微信授权的补充渠道。
+
+| 使用场景 | 说明 |
+|---------|------|
+| 手机号绑定验证码 | 用户绑定手机号时发送 6 位验证码，有效期 5 分钟 |
+| 关键审批结果备用通知 | 当用户未订阅微信模板消息时，可通过短信通知审批结果（可选）|
+
+**验证码记录表（`sms_verification`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| phone | VARCHAR(20) | 手机号 |
+| code | VARCHAR(10) | 验证码 |
+| purpose | VARCHAR(50) | 用途（当前值：bind_phone；预留扩展）|
+| is_used | BOOLEAN | 是否已使用 |
+| expired_at | DATETIME | 过期时间 |
+| created_at | DATETIME | 创建时间 |
+
+#### 3.5.4 消息通知策略
+
+| 通知场景 | 通知方式 | 接收方 |
+|---------|---------|-------|
+| 入驻申请审批结果 | 微信订阅消息 | 申请人 |
+| 新入驻申请待审批 | 飞书消息 | 管理员 |
+| 活动报名成功 | 微信订阅消息 | 报名人 |
+| 活动开始前3天提醒 | 微信订阅消息 | 报名人 |
+| 会场预约审批结果 | 微信订阅消息 | 预约人 |
+| 会场门禁密码 | 微信订阅消息 | 预约人 |
+| 反馈工单状态变更 | 微信订阅消息 | 提交人 |
+| 需求审核结果 | 微信订阅消息 | 发布企业 |
+| 手机号绑定验证码 | 短信 | 绑定用户 |
+
+#### API 接口清单
+
+| 方法 | 路径 | 说明 | 优先级 |
+|------|------|------|-------|
+| POST | `/api/v1/feishu/callback` | 飞书审批回调 Webhook | P1 |
+| POST | `/api/v1/ocr/business-license` | 营业执照 OCR | P1 |
+| POST | `/api/v1/sms/send` | 发送手机号验证码 | P1 |
+| POST | `/api/v1/notify/send` | 内部触发通知（系统调用）| P1 |
+
+---
+
+### 3.6 平台管理后台
+
+#### 用户故事
+- 作为**管理员**，我希望管理所有用户、审核内容、配置 Banner
+- 作为**管理员**，我希望看到运营数据看板并生成报告
+
+#### 数据模型与字段
+
+**用户表（`user`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| openid | VARCHAR(100) UNIQUE | 微信 OpenID（应用维度唯一标识）|
+| union_id | VARCHAR(100) NULLABLE | 微信 UnionID（跨应用唯一标识，有开放平台时填写）|
+| nickname | VARCHAR(50) | 微信昵称 |
+| avatar_url | VARCHAR(255) | 头像 |
+| phone | VARCHAR(20) | 手机号（加密存储）|
+| role | ENUM('user','enterprise','partner','admin') | 角色 |
+| is_active | BOOLEAN | 是否启用 |
+| created_at | DATETIME | 注册时间 |
+| last_login_at | DATETIME | 最后登录时间 |
+
+**评分配置表（`score_config`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| category | ENUM('settlement','development') | 评分类别（入驻/发展）|
+| dimension | VARCHAR(100) | 评分维度名称 |
+| weight | DECIMAL(5,2) | 权重（%）|
+| description | TEXT | 维度说明 |
+
+**项目评分表（`enterprise_score`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| enterprise_id | INT FK | 关联企业 |
+| config_id | INT FK | 评分维度 |
+| score | DECIMAL(5,2) | 得分 |
+| remark | TEXT | 备注 |
+| scored_by | INT FK | 评分管理员 |
+| scored_at | DATETIME | 评分时间 |
+| updated_at | DATETIME | 更新时间 |
+
+#### API 接口清单（后台）
+
+| 方法 | 路径 | 说明 | 优先级 |
+|------|------|------|-------|
+| GET | `/api/v1/admin/users` | 用户列表 | P0 |
+| PUT | `/api/v1/admin/users/{id}/role` | 修改用户角色 | P0 |
+| GET | `/api/v1/admin/applications` | 入驻申请列表 | P0 |
+| PUT | `/api/v1/admin/applications/{id}/review` | 审核入驻申请 | P0 |
+| GET | `/api/v1/admin/requirements` | 需求列表审核 | P0 |
+| PUT | `/api/v1/admin/requirements/{id}/review` | 审核需求发布 | P0 |
+| GET | `/api/v1/admin/feedback` | 工单列表 | P0 |
+| PUT | `/api/v1/admin/feedback/{id}/assign` | 分配工单 | P0 |
+| PUT | `/api/v1/admin/feedback/{id}/resolve` | 标记工单解决 | P0 |
+| GET | `/api/v1/admin/bookings` | 会场预约列表 | P0 |
+| PUT | `/api/v1/admin/bookings/{id}/review` | 审批会场预约 | P0 |
+| POST | `/api/v1/admin/banners` | 新增 Banner | P0 |
+| GET | `/api/v1/admin/banners` | 后台 Banner 列表（含未启用）| P0 |
+| PUT | `/api/v1/admin/banners/{id}` | 编辑 Banner | P0 |
+| DELETE | `/api/v1/admin/banners/{id}` | 删除 Banner | P0 |
+| POST | `/api/v1/admin/activities` | 新增活动 | P0 |
+| PUT | `/api/v1/admin/activities/{id}` | 编辑活动 | P0 |
+| GET | `/api/v1/admin/stats/overview` | 运营数据概览 | P1 |
+| GET | `/api/v1/admin/stats/venues` | 会场使用统计 | P1 |
+| GET | `/api/v1/admin/scores` | 企业评分列表 | P1 |
+| POST | `/api/v1/admin/scores` | 录入评分 | P1 |
+| GET | `/api/v1/admin/ai/insight-report` | AI 生成洞察报告 | P2 |
+| POST | `/api/v1/admin/applications/{id}/export-materials` | 一键生成企业完整申报材料（附件下载）| P1 |
+| POST | `/api/v1/admin/tech-managers` | 新增技术经理人 | P0 |
+| PUT | `/api/v1/admin/tech-managers/{id}` | 编辑技术经理人 | P0 |
+| DELETE | `/api/v1/admin/tech-managers/{id}` | 删除技术经理人 | P0 |
+| POST | `/api/v1/admin/spaces` | 新增场地 | P0 |
+| PUT | `/api/v1/admin/spaces/{id}` | 编辑场地 | P0 |
+| DELETE | `/api/v1/admin/spaces/{id}` | 删除场地 | P0 |
+| POST | `/api/v1/admin/venues` | 新增会场 | P0 |
+| PUT | `/api/v1/admin/venues/{id}` | 编辑会场 | P0 |
+| DELETE | `/api/v1/admin/venues/{id}` | 删除会场 | P0 |
+| PUT | `/api/v1/admin/activities/{id}/status` | 变更活动状态（发布/取消/结束）| P0 |
+| POST | `/api/v1/admin/achievements` | 新增科技成果 | P0 |
+| GET | `/api/v1/admin/achievements` | 后台科技成果列表（含待审核）| P0 |
+| PUT | `/api/v1/admin/achievements/{id}` | 编辑科技成果 | P0 |
+| DELETE | `/api/v1/admin/achievements/{id}` | 删除/下架科技成果 | P0 |
+
+---
+
+### 3.7 关于基地
+
+#### 数据模型
+
+**基地信息表（`base_info`）**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键（单行配置）|
+| name | VARCHAR(100) | 基地名称 |
+| intro | TEXT | 图文介绍（富文本）|
+| images | JSON | 图片列表 |
+| contact_phone | VARCHAR(20) | 客服电话 |
+| address | VARCHAR(200) | 地址 |
+| latitude | DECIMAL(10,7) | 纬度 |
+| longitude | DECIMAL(10,7) | 经度 |
+| updated_at | DATETIME | 最后更新时间 |
+
+#### API 接口清单
+
+| 方法 | 路径 | 说明 | 优先级 |
+|------|------|------|-------|
+| GET | `/api/v1/base-info` | 获取基地介绍 | P0 |
+| PUT | `/api/v1/admin/base-info` | 后台更新基地介绍 | P0 |
+
+---
+
+## 第四章 通用能力
+
+### 4.1 认证与授权
+
+#### 登录流程
+```
+用户点击微信授权登录
+  → 小程序调用 wx.login() 获取 code
+  → 后端用 code + AppID + AppSecret 换取 openid + session_key（+ union_id 如有）
+  → 后端生成 access_token（7天）和 refresh_token（30天）返回前端
+  → 前端将两个 token 存入 wx.setStorageSync
+  → 后续请求携带 Authorization: Bearer <access_token>
+  → access_token 过期 → 前端用 refresh_token 静默换取新 access_token
+  → refresh_token 过期 → 要求用户重新登录
+```
+
+#### JWT Token 设计
+
+**access_token**（有效期7天）：
+
+| 字段 | 说明 |
+|------|------|
+| sub | 用户 ID |
+| role | 用户角色 |
+| exp | 过期时间（7天）|
+| iat | 签发时间 |
+
+> 注意：`openid` 不写入 JWT payload（openid 是敏感的稳定标识符，JWT payload 仅 base64 编码非加密；后端通过 `sub` 查 user 表获取 openid）。
+
+**refresh_token**（有效期30天）：独立生成的不透明随机字符串，存储于后端 Redis，与 `user_id` 关联。
+
+**`POST /api/v1/auth/refresh` 请求体**：
+```json
+{ "refresh_token": "<refresh_token_value>" }
+```
+返回新的 `access_token`（不更新 refresh_token）。
+
+#### API 接口清单
+
+| 方法 | 路径 | 说明 | 优先级 |
+|------|------|------|-------|
+| POST | `/api/v1/auth/wx-login` | 微信登录，返回 JWT | P0 |
+| POST | `/api/v1/auth/refresh` | 刷新 Token | P0 |
+| GET | `/api/v1/auth/profile` | 获取当前用户信息 | P0 |
+| PUT | `/api/v1/auth/profile` | 更新个人/企业信息 | P0 |
+| POST | `/api/v1/auth/phone` | 绑定手机号（微信授权）| P0 |
+
+#### 权限中间件设计
+
+```python
+# 后端统一鉴权中间件
+# 装饰器 @require_role(roles=['admin', 'enterprise'])
+# → 解析 JWT → 校验 role → 通过/拒绝（403）
+```
+
+---
+
+### 4.2 消息通知
+
+#### 微信订阅消息模板
+
+| 消息模板 | 触发事件 | 关键字段 |
+|---------|---------|---------|
+| 审批结果通知 | 入驻申请/会场预约审批完成 | 申请类型、结果、时间、备注 |
+| 活动报名成功 | 用户报名后 | 活动名称、时间、地点 |
+| 活动提醒 | 活动开始前3天定时任务触发 | 活动名称、开始时间、地点 |
+| 工单状态变更 | 反馈工单处理进度更新 | 工单编号、状态、处理说明 |
+| 门禁密码通知 | 会场预约通过后 | 会场名称、使用时间、门禁密码 |
+
+**定时任务设计（APScheduler / Celery）**：
+
+| 任务 | 触发方式 | 频率 |
+|------|---------|------|
+| 活动开始前3天提醒 | Cron 每日上午9点 | 每天 |
+| AI 数据洞察报告生成 | Cron 每周一 | 每周 |
+| 会场使用率统计 | Cron 每日凌晨 | 每天 |
+
+---
+
+### 4.3 文件上传
+
+#### 上传策略
+
+```
+前端直传腾讯云 COS：
+  → 前端请求后端获取预签名 URL
+  → 前端直接上传文件到 COS
+  → 上传成功后将文件 URL 保存到业务字段
+
+支持的文件类型：
+  - 图片：JPG / PNG / WEBP（最大 10MB）
+  - 文档：PDF / DOC / DOCX（最大 20MB）
+  - 压缩包：ZIP（最大 50MB）
+```
+
+#### 文件记录表（`file_record`）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INT PK | 主键 |
+| user_id | INT FK | 上传用户 |
+| file_name | VARCHAR(200) | 原始文件名 |
+| file_url | VARCHAR(255) | COS 存储 URL |
+| file_size | INT | 文件大小（字节）|
+| file_type | VARCHAR(50) | 文件 MIME 类型 |
+| business_type | VARCHAR(50) | 业务用途标识 |
+| created_at | DATETIME | 上传时间 |
+
+#### API 接口清单
+
+| 方法 | 路径 | 说明 | 优先级 |
+|------|------|------|-------|
+| POST | `/api/v1/upload/presign` | 获取 COS 预签名上传 URL | P0 |
+
+---
+
+### 4.4 AI 能力集成
+
+#### 集成架构
+
+```
+业务逻辑层
+  → AI 服务层（统一封装）
+      ├── 调用大模型 API（GPT / 文心 / 通义，可配置切换）
+      ├── 超时控制（5秒 timeout，在 8秒端到端 SLA 预算内）
+      ├── 失败重试（最多2次）
+      └── 降级处理（返回空结果，前端展示默认态）
+```
+
+> **时间预算说明**：AI 接口端到端 SLA 为 ≤ 8s（Section 5.1）。其中大模型调用 timeout 设为 5s，加上重试和降级逻辑，总时间仍在 8s 以内。
+
+#### Prompt 模板
+
+| 功能 | Prompt 策略 |
+|------|------------|
+| 生成需求标题/描述 | System: 你是企业服务助手；User: 基于以下关键词生成{type}需求的标题和描述：{keywords} |
+| 工单自动分类 | System: 对问题反馈进行分类，输出 JSON；User: {feedback_content} |
+| 场地推荐 | System: 根据企业特��推荐合适场地；User: 企业规模{scale}，行业{industry}，预算{budget} |
+| 数据分析报告 | System: 你是数据分析师；User: 基于以下运营数据生成洞察报告：{stats_data} |
+
+---
+
+### 4.5 通用列表接口规范
+
+所有分页列表接口��一使用以下参数和响应格式：
+
+**请求查询参数**：
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|-------|------|
+| page | INT | 1 | 页码（从1开始）|
+| page_size | INT | 20 | 每页条数（最大50）|
+
+**标准响应格式**：
+```json
+{
+  "total": 100,
+  "page": 1,
+  "page_size": 20,
+  "items": [...]
+}
+```
+
+筛选参数各接口独立定义（如 `status`、`type`、`start_date` 等），在各模块 API 清单中标注。
+
+---
+
+## 第五章 非功能需求
+
+### 5.1 性能要求
+
+| 指标 | 要求 |
+|------|------|
+| 普通接口响应时间 | ≤ 500ms（P95）|
+| 列表接口响应时间 | ≤ 1s（P95）|
+| AI 接口响应时间 | ≤ 8s（含超时降级）|
+| OCR 接口响应时间 | ≤ 3s |
+| 并发用户支持 | 初期支持 200 并发 |
+| 小程序首屏加载 | ≤ 2s（4G 网络）|
+
+### 5.2 安全要求
+
+| 类别 | 要求 |
+|------|------|
+| 接口鉴权 | 所有非公开接口必须携带有效 JWT |
+| 权限校验 | 后端强制校验 role，不依赖前端隐藏 |
+| 敏感数据 | 飞书 Secret、数据库密码等通过环境变量注入，不写入代码 |
+| 文件安全 | 上传文件类型白名单校验，限制文件大小 |
+| SQL 注入 | 使用 ORM（SQLAlchemy）参数化查询，禁止拼接 SQL |
+| 手机号 | 数据库中加密存储，仅展示时脱敏（138****8888）|
+| HTTPS | 所有接口强制 HTTPS |
+| 频率限制 | AI 接口每用户每分钟最多10次 |
+
+### 5.3 兼容性要求
+
+| 类别 | 要求 |
+|------|------|
+| 微信基础库 | ≥ 2.20.0 |
+| 微信版本 | 支持近2年主流版本 |
+| 手机系统 | iOS 13+ / Android 8+ |
+| 屏幕适配 | 375px 基准，支持主流机型（iPhone SE ~ Pro Max）|
+
+### 5.4 数据备份
+
+| 类别 | 要求 |
+|------|------|
+| 数据库备份 | 每日自动备份，保留30天 |
+| 文件存储 | COS 开启跨区域复制 |
+| 备份恢复 | RTO ≤ 4小时，RPO ≤ 24小时 |
+
+### 5.5 部署要求
+
+| 组件 | 建议方案 |
+|------|---------|
+| 后端服务 | 腾讯云 CVM / 容器（Docker + Nginx）|
+| 数据库 | 腾讯云 MySQL（RDS）|
+| 文件存储 | 腾讯云 COS |
+| 缓存 | Redis（Session / 接口缓存）|
+| 任务队列 | Celery + Redis（异步任务 / 定时任务）|
+| 日志 | 结构化日志 + 腾讯云日志服务 |
+
+---
+
+## 附录：数据库表清单
+
+| 表名 | 说明 |
+|------|------|
+| `user` | 用户信息 |
+| `enterprise` | 企业信息 |
+| `settlement_application` | 入驻申请 |
+| `space` | 场地信息 |
+| `requirement_post` | 成果供需发布 |
+| `tech_achievement` | 科技成果 |
+| `tech_manager` | 技术经理人 |
+| `feedback_ticket` | 问题工单 |
+| `activity` | 活动信息 |
+| `activity_registration` | 活动报名 |
+| `venue` | 会场信息 |
+| `venue_booking` | 会场预约 |
+| `banner` | 首页 Banner |
+| `base_info` | 基地介绍 |
+| `score_config` | 评分维度配置 |
+| `enterprise_score` | 企业评分记录 |
+| `feishu_config` | 飞书运营配置（非敏感字段）|
+| `file_record` | 文件上传记录 |
+| `ai_call_log` | AI 调用日志 |
+| `user_favorite` | 用户收藏/关注 |
+| `partner_application` | 社区合伙人申请 |
+| `sms_verification` | 短信验证码记录 |