健行会综合活动管理平台（SoHike-Next）设计说明书 V4.1

更新日期：2026-06-28 版本：V4.3（热度序列等级命名、头像组件、账户设置页全面重构） 基于V3.2（2026-06-11）+ 6月12~24日全部讨论整合 每个条目标注完成阶段

一、品牌与VI

1.1 协会信息

• 全称：深圳市健行者户外运动协会
• 英文：SoHike
• 口号：乐山乐水·健心健行
• 文化要素：自由参与、互助分享、重在参与、安全出行

1.2 视觉规范

1.3 Logo使用

二、系统架构

2.1 技术栈

2.2 基础设施

三、前端组件规范

3.1 用户角色与会员体系

角色定义

菜单规则

• 设置（⚙️）：所有人可见，配色/通知等系统偏好，不含个人资料
• 注册资料（非会员入口）：游客/临时队员/预备会员/准会员 → 昵称/头像/手机/介绍人
• 会员信息（会员入口）：正式会员 → 完整个人资料+等级+健行分+活动记录

会员内部分级（1-10级）

会员级别体系以热度序列来冠名。拟以"温热阳"三温区、"将初仲至"四程度构建会员热度序列。

温：将温 → 初温 → 仲温 → 至温 热：将热 → 初热 → 仲热 → 至热 阳：将阳 → 骄阳

温→热→阳 将(欲)→初(始)→仲(中)→至(极)→骄阳(巅峰)

视觉颜色渐变

为配合等级递进感，使用VI三色渐变呈现热度变化：

配色逻辑：温区从蓝色起步（冷静），向绿色过渡（温暖）；热区从绿色转向橘红（热情）；阳区升至红橙（炽烈巅峰）。整体呈现「蓝→绿→橙→红」的自然升温曲线，在会员中心等级Modal中通过等级徽章的颜色即可一目了然。

显示方式：Lv.5 将热（等级号+名称同时显示）

健行分获取规则

3.2 组件库（Sprint 1a已实现）

3.2 组件库（待优化 Sprint 1b）

四、页面清单

4.1 已完成（Sprint 1a ✅）

4.2 待开发

五、活动模板设计

5.1 数据库字段（20个）

详见活动模板设计_v3文档（工具箱链接） - 长文本字段（内容/路线/行程/装备/注意事项/免责声明/费用明细）支持HTML - 系统自动字段不显示在表单中

5.2 模板类型

5.3 定制机制

• 管理员可调整每个模板的字段顺序/显示/必填（📅 Sprint 1c）
• 免责声明多版本管理（📅 Sprint 1c）

六、功能预研

七、公众号写作

八、工作模式

Step 1：设计文件迭代 ← 当前
  讨论 → 修改 → 确认

Step 2：按设计开发
  派单（统一模型）→ 验收 → 用户确认

Step 3：产品迭代
  测试 → 反馈 → 回到Step 1

确立时间：✅ Sprint 1a（2026-06-24）

九、Sprint规划总览

Sprint 1a（当前 — 已完成/进行中）

Sprint 1b（下一步）

Sprint 1c

本版本为最新设计规范，所有开发需以此为准。

十、IMA个人知识库 + ClawBot集成

通过ClawBot（OpenClaw）调用IMA OpenAPI，实现对知识库和笔记的智能管理

10.1 已就绪的能力

10.2 不能做的

10.3 SoHike中的应用场景

10.4 数据流

IMA知识库 ←→ IMA OpenAPI ←→ ClawBot ←→ SoHike用户
                           ↕
                     SoHike-Next后端
                   （查询/归档接口）

10.5 当前配置

• Client ID: 6c1397516f755178b5a666c78ddbf190
• API Key: 已配置（存于环境变量）
• 已连接知识库: LJYEF秘书处知识库等14个
• 状态: ✅ 技能已就绪

11.6 报名统计与导出

天气集成详细需求

后端API需要： - GET /api/v1/weather/now?location=xxx → 实时天气 - GET /api/v1/weather/forecast?location=xxx&date=xxx → 按日预报

会员入会申请相关

预备会员入会引导（备忘）

触发条件： 预备会员（已参加3次活动）登录后 交互： 弹出提示 → "您已符合入会条件，是否申请入会？" 选项： [立即申请] [稍后再说] [不再提示] 技术方案： 登录接口返回用户状态 → 前端判断 → 弹出Modal 阶段： 📅 Sprint 1b（与登录系统同时实现）

六、数据库结构（会员模块）

6.1 完整数据库结构

6.1 完整数据库结构

表1：members（会员主表）

表2：member_consents（同意记录）

表3：member_activity_log（活动参与记录）

表4：activity_templates（活动模板配置）

表5：disclaimer_versions（免责声明版本管理）

表6：site_settings（站点配置）

预置配置项： - register_welcome — 注册页欢迎文字（HTML） - register_privacy — 注册页隐私告知（HTML） - member_fee — 会费标准 - insurance_info — 保险说明

SQL建表语句

-- 会员主表
CREATE TABLE members (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    member_no VARCHAR(32) UNIQUE NOT NULL,
    name VARCHAR(64) NOT NULL,
    nickname VARCHAR(64),
    call_sign VARCHAR(32),
    phone VARCHAR(16) UNIQUE NOT NULL,
    email VARCHAR(128),
    qq VARCHAR(32),
    work_unit VARCHAR(128),
    district VARCHAR(64),
    id_number VARCHAR(32) NOT NULL,  -- AES-256加密存储
    emergency_contact VARCHAR(64) NOT NULL,
    emergency_relation VARCHAR(32) NOT NULL,
    emergency_phone VARCHAR(16) NOT NULL,
    medical_history TEXT,  -- AES-256加密存储
    photo VARCHAR(256),
    introducer VARCHAR(64) NOT NULL,
    status VARCHAR(16) NOT NULL DEFAULT 'pending',
    level INT DEFAULT 1,
    hiking_score DECIMAL(5,1) DEFAULT 0,
    join_date DATE,
    expire_date DATE,
    created_at TIMESTAMP DEFAULT NOW(),
    updated_at TIMESTAMP DEFAULT NOW()
);

-- 同意记录表
CREATE TABLE member_consents (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    member_id UUID NOT NULL REFERENCES members(id),
    consent_type VARCHAR(32) NOT NULL,
    consent_text TEXT NOT NULL,
    ip_address VARCHAR(45),
    consented_at TIMESTAMP DEFAULT NOW(),
    revoked_at TIMESTAMP
);

-- 活动参与记录
CREATE TABLE member_activity_log (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    member_id UUID NOT NULL REFERENCES members(id),
    activity_id UUID NOT NULL REFERENCES activities(id),
    status VARCHAR(16) NOT NULL,
    dinner BOOLEAN DEFAULT TRUE,
    participant_count INT DEFAULT 1,
    vehicle VARCHAR(64),
    note TEXT,
    registered_at TIMESTAMP DEFAULT NOW(),
    checked_in_at TIMESTAMP
);

-- 活动模板配置
CREATE TABLE activity_templates (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    template_key VARCHAR(32) UNIQUE NOT NULL,
    template_name VARCHAR(64) NOT NULL,
    field_config JSONB NOT NULL,
    is_active BOOLEAN DEFAULT TRUE,
    created_at TIMESTAMP DEFAULT NOW()
);

-- 免责声明版本
CREATE TABLE disclaimer_versions (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    version VARCHAR(16) NOT NULL,
    content TEXT NOT NULL,
    is_default BOOLEAN DEFAULT FALSE,
    created_at TIMESTAMP DEFAULT NOW()
);

-- 站点配置
CREATE TABLE site_settings (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    key VARCHAR(64) UNIQUE NOT NULL,
    value TEXT NOT NULL,
    description VARCHAR(256),
    updated_at TIMESTAMP DEFAULT NOW()
);

字段加密说明

QWeather API地点颗粒度测试结论

支持的最小级别：区/县级（district）

深圳各区ID

惠州各区ID

天气地点精度选择（待研究）

问题： 规划师创建活动时，如何选择天气预报的精度级别？

方案探讨： 1. 自动匹配 — 根据活动地点文本自动匹配区级ID（如"博罗"→101280302） 2. 下拉选择 — 创建活动时增加"天气区域"下拉，列出附近区/县 3. GPS自动 — 根据活动集合点GPS坐标自动匹配辖区

下一步： Sprint 1b功能预研时测试自动匹配方案的可行性