全部文章
共 100 篇
自由泳打腿技术分解与训练方法
关于自由泳打腿技术分解与训练方法的训练方法与实操指南，适用于青少年体育培训。
协调性训练动作库：3-6岁适用
关于协调性训练动作库：3-6岁适用的训练方法与实操指南，适用于青少年体育培训。
运动后放松拉伸标准流程（全身12动作）
关于运动后放松拉伸标准流程（全身12动作）的训练方法与实操指南，适用于青少年体育培训。
U10传球精度训练：四人围圈抢控
关于U10传球精度训练：四人围圈抢控的训练方法与实操指南，适用于青少年体育培训。
足球停球技术详解：脚内侧/脚背/大腿停球
关于足球停球技术详解：脚内侧/脚背/大腿停球的训练方法与实操指南，适用于青少年体育培训。
足球带球过人：变速突破与方向改变
关于足球带球过人：变速突破与方向改变的训练方法与实操指南，适用于青少年体育培训。
足球传球：短传/长传/直塞的时机选择
关于足球传球：短传/长传/直塞的时机选择的训练方法与实操指南，适用于青少年体育培训。
羽毛球高远球发力机制分析
关于羽毛球高远球发力机制分析的训练方法与实操指南，适用于青少年体育培训。
羽毛球反手发球技术要点
关于羽毛球反手发球技术要点的训练方法与实操指南，适用于青少年体育培训。
绳梯脚步训练：提升协调性与启动速度
关于绳梯脚步训练：提升协调性与启动速度的训练方法与实操指南，适用于青少年体育培训。
游泳换气节奏训练：避免缺氧
关于游泳换气节奏训练：避免缺氧的训练方法与实操指南，适用于青少年体育培训。
角球进攻战术：前点掩护与后点头球
关于角球进攻战术：前点掩护与后点头球的训练方法与实操指南，适用于青少年体育培训。
角球防守站位：区域与盯人混合策略
关于角球防守站位：区域与盯人混合策略的训练方法与实操指南，适用于青少年体育培训。
足球进攻3-2-5阵型边路配合
关于足球进攻3-2-5阵型边路配合的训练方法与实操指南，适用于青少年体育培训。
中路渗透：撞墙配合与反向跑位
关于中路渗透：撞墙配合与反向跑位的训练方法与实操指南，适用于青少年体育培训。
低位防守：防线深度与中路密度
关于低位防守：防线深度与中路密度的训练方法与实操指南，适用于青少年体育培训。
高位压迫：时机判断与跑动路线
关于高位压迫：时机判断与跑动路线的训练方法与实操指南，适用于青少年体育培训。
U8年龄段运球绕杆训练教案
关于U8年龄段运球绕杆训练教案的训练方法与实操指南，适用于青少年体育培训。
雷暴天气训练取消SOP与场地检查清单
关于雷暴天气训练取消SOP与场地检查清单的训练方法与实操指南，适用于青少年体育培训。
球员签约合同模板与家长知情同意书
关于球员签约合同模板与家长知情同意书的训练方法与实操指南，适用于青少年体育培训。
FIFA11+热身程序：减少运动损伤
关于FIFA11+热身程序：减少运动损伤的训练方法与实操指南，适用于青少年体育培训。
对抗训练设计：3v3和5v5的回合制
关于对抗训练设计：3v3和5v5的回合制的训练方法与实操指南，适用于青少年体育培训。
青少年教练开场白与训练氛围营造
关于青少年教练开场白与训练氛围营造的训练方法与实操指南，适用于青少年体育培训。
如何设计一堂90分钟训练课的结构
关于如何设计一堂90分钟训练课的结构的训练方法与实操指南，适用于青少年体育培训。
教练口令与示范：清晰沟通的技巧
关于教练口令与示范：清晰沟通的技巧的训练方法与实操指南，适用于青少年体育培训。
家长沟通：反馈孩子进步的正确方式
关于家长沟通：反馈孩子进步的正确方式的训练方法与实操指南，适用于青少年体育培训。
4-3-3 vs 4-4-2：青训阶段阵型选择
关于4-3-3 vs 4-4-2：青训阶段阵型选择的训练方法与实操指南，适用于青少年体育培训。
青少年周期性体能训练计划（8-12周）
关于青少年周期性体能训练计划（8-12周）的训练方法与实操指南，适用于青少年体育培训。
守门员扑救：接地滚球与空中球
关于守门员扑救：接地滚球与空中球的训练方法与实操指南，适用于青少年体育培训。
灵敏素质训练：T drill与伊利诺斯测试
关于灵敏素质训练：T drill与伊利诺斯测试的训练方法与实操指南，适用于青少年体育培训。
比赛前心理建设：可视化与自我暗示
关于比赛前心理建设：可视化与自我暗示的训练方法与实操指南，适用于青少年体育培训。
失利后球员情绪管理：教练应对话术
关于失利后球员情绪管理：教练应对话术的训练方法与实操指南，适用于青少年体育培训。
家长会沟通模板：赛季评估与下阶段目标
关于家长会沟通模板：赛季评估与下阶段目标的训练方法与实操指南，适用于青少年体育培训。
训练场急救：扭伤/拉伤/脱臼应急处理
关于训练场急救：扭伤/拉伤/脱臼应急处理的训练方法与实操指南，适用于青少年体育培训。
防守反击：各位置职责与转换时机
关于防守反击：各位置职责与转换时机的训练方法与实操指南，适用于青少年体育培训。
修改测试
[保持英文] 约定：区分「放哪里」与「给谁用」，避免把 VPS / 生产用的整包变量复制进子项目。 --- 1. 配置文件分层 层级 路径 用途 ------------------ 统一栈（与线上一致） 仓库根 .env 由 deploy/env-compose.dev.example 复制；驱动 docker-compose.prod.yml（COMPOSEPROJECTNAME、MYSQLDATABASE、HOSTPORT 等）。 轻量联调栈 无独立 env 文件 使用根目录 docker-compose.yml（MySQL/API 端口写死在 compose 内，
硬件物联网 & 考勤系统
文档日期：2026-04-17 状态：✅ 已完成（后端接口 + 前端页面） --- 1. 业务流程 学员/家长录入人脸 ↓ 场馆端人脸识别摄像头 → 设备调用 /face/recognize ↓ ↓ 匹配用户身份 自动拉取云康宝体脂数据 ↓ ↓ 写入考勤记录 写入 qxbodycomposition ↓ ↓ 返回前端展示
TRAE 知识库对接全量核查 + 执行清单（2026-04-08）
验收口径（唯一事实来源）：后端 fuse-api/app/api/qx/knowledge.py 的字段与参数名。 必须遵守：docs/KNOWLEDGEAPICONTRACTFORFRONTENDS.md 本文件是“把所有不对的点列出来，让你照着改”的执行清单：每条都包含 文件路径 → 当前错误 → 正确做法 → 验收标准。 --- 0. 后端契约速记（供对照） - 分类列表：GET /api/v1/qx/knowledge/categories → data 是 数组 Category[]，不是 { items: [] } - 文章列表：GET /api/v1/qx/knowle
CBA 迭代启动说明（执行顺序：C → B → A）
[保持英文] 约定：你方确认的推进顺序为 先 C、再 B、最后 A。本文定义每一波的范围、退出标准、与现有文档的对应关系；具体工单仍以 DEVELOPMENTPLAN.md、docs/GAPAUDIT2026Q2.md、TRAENEXTTASKS.md、CURSORTASKS.md 为权威拆解来源。 --- 总原则 - 竖切交付：每一波内再按「可演示 / 可上线」拆 PR，避免全仓大爆炸式重构。 - 不测赛事不等于不做赛事：联赛相关可整体 冻结在 Phase 6，待 C/B 主线稳定后再开。 - 单一事实来源：路由以 fuse-platform/src/router/index.ts、
网站管理功能迁移说明
1. 迁移背景 为了更好地管理网站相关功能，我们将原有的网站管理功能从 fuse-platform 迁移到 fuse-ops 运营总栈中。这样可以将网站管理、知识库管理等运营相关功能集中在一个平台中，提高管理效率。 2. 迁移内容 2.1 前端页面 在 fuse-ops/ruoyi-fastapi-app/src/pages/website/ 目录下创建了以下页面： - index.vue - 网站管理首页，作为新闻和日历管理的入口 - news.vue - 新闻资讯管理页面，用于管理网站的新闻内容 - calendar.vue - 赛事日历管理页面，用于管理网站的赛事日历 2.2 后端 AP
租户中台 + 运营总后台 改进执行手册
目标读者：前后端开发同学（按本文档逐条落地）。 配套代码：标注 [已落地] 表示已实现；历史 [需完善] 中已在代码库闭环的项见下文 「本轮闭环」；仍依赖外部服务或策略决策的项保留为待办。 --- 本轮闭环（与仓库当前实现对齐） - P0：http.ts 支持 accessToken Bearer；可选 VITEUSELEGACYHEADERS 仅走 X-Qx-；登录页可选 VITEWECHATOAUTHURL 外链微信授权。 - P1：router/index.ts 租户角色壳层使用 TemplateShellRouter；App.vue 按 tenantShell manifest 动态主
仓库目录命名与「文体旅」域划分
[保持英文] 目的：顶层目录短、可扫读；语义上对齐 文体旅融合 与 运营总栈，不与 URL 里的 qx / tour / qianye 耦合。 更新：2026-04-13（方案 D：fuse- 短名） --- 一、业务域 ↔ 目录 域 含义 目录 ---------------- 体 + 旅 + 平台 智体一体化业务（青训 / 场馆 / 赛事 / 文旅 / vision 等） fuse-api/、fuse-platform/、fuse-mini/ 运营 / SaaS 若依总后台、千夜平台代理、租户运营 fuse-ops/ 文 / 品牌公网 千夜官网与知识库
智慧文体旅平台 — 团队项目完整说明
项目路径：/Users/qykj/projects/demo/sct/ 最后更新：2026-04-16 维护团队：沈阳英泰数字科技部 --- 一、项目总览 1.1 项目定位 智慧文体旅平台（代号 zhihui-sports-ai，磁盘目录 sct = Sports Culture Tourism）是一款面向体育教育+文旅融合的 SaaS 平台，支持多租户、多角色，覆盖体育培训（青训、俱乐部、场馆）和文旅景区（智游讲解、研学）场景。 1.2 技术架构图 ┌─────────────────────────────────────────────────────────────────┐ │
自建小程序 · 个性化模版套餐 · 跨角色数据 — 开发计划（TRAE 执行版）
[保持英文] 目标：支持租户自有小程序与公众号；在既定 UI 规范内提供主办 / 俱乐部·培训 / 场地等角色模版；通过 BFF 与参赛关系模型安全暴露跨租户数据（如主办方展示参赛俱乐部列表）。 执行原则：单代码库多租户配置；先配置与单租户闭环，再跨租户聚合；字段分级 L1/L2/L3，禁止内部表直出小程序。 〇、执行策略：先统一壳（当前阶段强制） 含义（TRAE 按此执行，勿并行拆多仓）： 1. 唯一小程序工程：以 fuse-mini 为唯一壳代码库；不为主办 / 俱乐部 / 场地各建独立小程序仓库。 2. 首期固定「统一模版」：templateid 首阶段仅使用 unified（或
知识库网站 — 极简交互与信息架构（改版方向）
定位：公网或半公网「千夜网」类知识库（L0/L1 边界见 知识库功能规划方案.md）。 原则：与现有铁律一致 — 意图优先、一步能完成不拆两步、AI 辅助不替人决策、视觉静默（参见 docs/FRONTENDUISPEC.md 若有）。 --- 1. 为什么要改「交互方式」而不只改栏目 栏目改版解决的是找内容的分类法；用户真实任务是「我现在要问什么 / 要解决什么」。极简改版的核心是： - 把首屏从「目录树」改为「意图入口」；目录退居次要（一行标签或侧栏抽屉）。 - 把注册/订阅/反馈压成单路径，减少账号心智负担。 - 把阅读做成无干扰阅读态；把行动（收藏、问 AI、联系）收束为 1～2 个主
模板使用指南 (A3)
1. 模板概述 1.1 什么是模板 - 模板：预配置的应用界面和功能集合，可快速部署和定制 - 优势：减少开发时间，降低开发成本，确保功能完整性 - 适用场景：体育俱乐部、培训机构、赛事主办方、体育场馆 1.2 模板类型 - 基础模板：包含核心功能的标准模板 - 足球俱乐部模板：针对足球俱乐部的专用模板 - 篮球俱乐部模板：针对篮球俱乐部的专用模板 - 赛事管理模板：针对赛事组织和管理的专用模板 - 培训中心模板：针对体育培训机构的专用模板 2. 模板部署 2.1 部署流程 1. 注册账号：在平台注册租户账号 2. 选择模板：从模板库选择适合的模板 3. 配置模板：根据需求配置模板参数 4.
数据库同步与迁移机制 — 设计说明
[保持英文] 目标：把「谁改库、怎么迁、怎么对齐测试/预发/生产、和 Docker 首次建库的关系」说清楚，减少重复执行、漏执行、双脚本打架。 库模型（当前约定）：单逻辑库 — fuse-api 与 fuse-ops（RuoYi）共用同一 MYSQLDATABASE（如 zhihuiprod / zhihuitest / zhihuistaging）。RuoYi 的 sys 表与智体业务表在同一 schema 中；表名前缀不同（sys vs qx / tour / platform 等），无冲突。 运行时连接（与迁移无关但易踩坑）：VPS 上 fuse-api 容器应由 docker-comp
青训市场推广 UI 优化方案
定位：面向 B 端（青训俱乐部、场馆、教练）的自助入驻 + 渠道方推广管理 业务假设：渠道方以个人/小公司为主（一人多角色：老板+销售+客服），不设内部子账号 基于：现有 fuse-platform（B 端）+ fuse-ops/ruoyi-fastapi-（运营后台）+ fuse-mini（C 端小程序） 更新：2026-04-17 --- 一、现状问题 问题 说明 ------------ 入驻路径断 无统一引导，客户不知道找谁、填什么 渠道归属缺失 俱乐部/场馆/教练不知道自己是被谁推广的 去重未落地 DUPLICATEENTRY 规范已定，但 UI 层未实现
赛事 / 场地方 / 俱乐部 — 与《MENU_DESIGN》对齐 & 未完成标记
[保持英文] 基准文档：fuse-api/MENUDESIGN.md（§3 俱乐部、§4 场馆、§5 赛事中台） 对账日期：以仓库当前代码为准（fuse-platform 路由 + fuse-mini 页面与登录） --- 图例 标记 含义 ---------- --------------------------------------------------------------------------
前台 & 后台 UI 设计规范（意图驱动 · 极简操作 · AI 辅助）
[保持英文] 更新时间：2026-04-13（§2.6 增补：重复录入与去重；§2.5：删除/危险操作风险分级） 适用范围： - B 端 / 中台（fuse-platform，Vue3 + Ant Design Vue + Tailwind） - 小程序（fuse-mini，UniApp + Vue3） 执行指南：docs/INTENTDRIVENREFACTOR.md（逐页改造清单：小程序 56 页 + 中台 89 页 + AI 辅助场景 + 分期 Sprint） 设计气质：极简操作、逻辑清晰、界面友好；能一步绝不两步；视觉参考 Linear.app、iOS 原生设置—
意图驱动全局重构方案（小程序 + 中台 + 知识库）
[保持英文] 版本: v1.0 日期: 2026-04-08 范围: fuse-mini（56 页）+ fuse-platform（89 页）+ 知识库交互 不含: 后端 API（不动）、千夜科技官网、千夜网公网 设计宪法: FRONTENDUISPEC.md 知识库专项: 知识库功能规划方案.md 本文目的：把 FRONTENDUISPEC.md 的抽象原则，落实到每个具体页面「改什么、怎么改」。 执行时逐页对照，改完一页勾一页。 --- 第一部分：四条铁律速查（从 FRONTENDUISPEC.md 提炼） 每个页面改造前，先过这四条。 铁律 一句话 违反的
微信公众号服务号菜单 — 制作计划（意图驱动 · 对齐项目 UI 宪法）
[保持英文] 版本：v1.0 日期：2026-04-09 范围：服务号自定义菜单所涉 H5 落地页、小程序深链、中台登录分流；不改变后端业务域划分，只做入口与体验层规划。 --- 1. 原则与单一事实来源 1.1 项目既定 UI（强制） 文档 用途 ------------ docs/FRONTENDUISPEC.md 设计宪法：意图驱动、一步法则、AI 辅助、极简视觉、危险操作 L1/L2/L3、小程序/中台专项 docs/INTENTDRIVENREFACTOR.md 落地模式：首屏意图入口、输入即搜、空态主操作、表单智能默认 验收口径：任何新 H5/菜单落地页，
千夜网核查20260408
TRAE 完成情况核查（2026-04-08） 依据：docs/TRAEQIANYENETREMAININGPLAN.md 的 Phase 2-5 验收条目。 结论："文件已创建/路由已接入"基本完成，但关键对接存在多处字段与接口不匹配，当前状态不可视为完成。 --- 1) 已完成（可判定 Done） 1.1 中台路由与菜单 - ✅ fuse-platform/src/router/index.ts 已注册： - /admin/knowledge、/admin/knowledge/:id - /club-owner/knowledge、/club-owner/knowledge/:
千夜网（1001n.net）— 站点信息架构与栏目规划
[保持英文] 站点：千夜网 · 公网功能知识库 工程目录：qianye-knowledge-web/ 更新时间：2026-04-08 本文只描述 L0 公网千夜网 的导航、栏目、路由与分期。租户内知识库（俱乐部/家长等） 不在本站呈现，其能力见 KNOWLEDGEPLATFORMDESIGN.md 的 L1～L3。 --- 1. 和官网怎么分工 问题 1001n.cn 千夜科技官网 1001n.net 千夜网 --------------------------------------------------------- 回答什么 我们是谁、方案价值、案例、新闻、一张
服务器环境修复记录
日期: 2026-04-17 操作人: 编码小能手 服务器: 82.157.0.88 (生产) / 49.232.59.144 (测试) --- 问题描述 生产服务器 zhihui-prod-api 持续崩溃重启，日志： ModuleNotFoundError: No module named 'app.models.messagetemplate' 根因 镜像 registry.1001n.cn/zhihui/fuse-api:latest 过期（基于旧代码构建），本地和 VPS 代码已更新但镜像未同步。 --- 修复步骤 第一步：重新构建镜像（在 VPS 本地 build 绕过证书问题）
体育域角色与功能说明
角色列表 角色 英文标识 功能描述 核心功能 ------------------------------------ 家长 PARENT 管理孩子的训练、健康和赛事信息 签到、报名、健康管理、训练计划、赛事报名、缴费 教练 COACH 管理学员、课程和训练计划 课次签到、学员管理、训练反馈、课程管理、表现分析、训练日记 队员 PLAYER 管理个人训练、比赛和成长记录 个人档案、统计数据、比赛记录、训练记录、视频分析、荣誉成就 赛事主办方 ORGANIZER 管理赛事、赛程和参赛队伍 赛事列表、创建赛事、参赛管理、赛程管理、数据统计、营销推广
已合并至《代码托管规范》
[保持英文] 本文件标题为历史命名。当前规范以 代码托管规范（单一大仓） 为准，包含： - 阿里云 Codeup 唯一 SSH 地址 - 子目录与服务对照 - CI/CD 与分支约定 旧版「七个独立 Gitee 仓库」表已废止，请勿按旧表新建远程或 Drone 多仓激活。
Q2全局计划
全局主计划（2026 Q2）— 智慧体育 × 千夜网 × 租户知识库 日期：2026-04-08 目标：用一份“总控计划”把所有子计划串起来，后续以本文为唯一排期依据（SSOT）。 方法论：四铁律（意图驱动 / 一步法则 / AI 辅助 / 极简 UI）+ docs/FRONTENDUISPEC.md（危险操作分级）。 --- 0. 现状与已完成 0.1 已完成（可用的基础能力） - 千夜网公网知识站骨架（Nuxt）：已有栏目/占位页 - 知识库后端（Phase 0-1）：已完成并验证 - DB：qxknowledge 5 表 - API：/api/v1/qx/know
知识库官网增强功能文档
1. 功能新增 1.1 问答中心 - 路径：/qa - 功能： - 提问功能：用户可以提交问题，包含标题、详细描述和标签 - 回答功能：用户可以回答问题，支持查看已有回答 - 问题列表：展示最新问题，包含浏览量、回答数等信息 - 记录留存：所有问答内容都会被保存，用户可以在个人中心查看历史记录 1.2 用户系统 - 登录页面：/auth/login - 邮箱登录 - 密码输入 - 记住我功能 - 忘记密码链接 - 注册页面：/auth/register - 邮箱注册 - 密码设置（至少6位） - 个人信息填写（姓名、手机号码） - 服务条款和隐私
TRAE 最短执行清单（复制粘贴版）
[保持英文] 生成依据：TRAENEXTTASKS.md §三（T6–T10）+ TRAETASKS.md 完结标准；以本仓库磁盘为准，缺文件先补再勾。 --- 0. 环境（先做） bash cd fuse-api pip install -r requirements.txt DATABASEURL 指向 MySQL（非 sqlite，否则 qx 路由可能不完整） python3 -c "from main import app; print('OK: app import')" --- 1. T6 — MySQL 迁移 + 冒烟（P0） 动作（在目标库执行，已做过则跳过对应语句）： 1.
============================================================
[保持英文] CI/CD 自动化部署 — 落地指南 根目录 .drone.yml 使用 Drone 内置 clone 当前绑定仓库（Codeup monorepo），按子路径构建； 各子目录 .drone.yml 为历史「单仓 clone」形态，默认不启用。托管规范见 CODEREPOSITORY.md。 分支与三环境域名（1001n.cn / 1001n.net）速查：CODEUPDRONETHREEENV.md。 架构: 代码 Push（Codeup） ↓ Webhook Drone Server（drone.1001n.cn） ↓ 调度 Drone R
智慧文体旅平台 — 项目完成度报告
更新时间：2026-04-16 项目路径：/Users/qykj/projects/demo/sct/ --- 一、项目总览 子系统 技术栈 完成度 说明 ------------------------------ fuse-api FastAPI 95% 后端 API（租户域 + 千夜 CMS） fuse-platform Vue3 + Ant Design 72% B 端管理台（8 角色） fuse-mini UniApp 45% C 端小程序 st-mini Vue + Vite 40% 旅游 H5 fuse-ops RuoYi-V
运营入口与渠道说明（推广 / 入驻 / 绩效）
[保持英文] 读者：运营、市场、交付、管理；维护：产品与工程在变更登录域、租户策略时同步更新本文。 更新：2026-04-13（增补 §10 公众号 vs 小程序、§12 防重复录入） 本文约定：智体核心业务（B 端管理台、小程序、平台域）的入口与数据归属；邀请、注册须可追溯，供未来绩效考核；千夜知识库站与千夜官网来的流量与转化单独计量，不与核心业务邀请/注册混在同一套默认指标里。 文档性质：本文是说明与口径（话术、数据归属、对数据落库的要求），不是开发任务清单。落地排期与表结构见根目录 CURSORTASKS.md。为减少运营与交付「不知道写在哪」的摩擦，智体 B 端在 登录、邀
规划缺口审查报告（2026-Q2）
[保持英文] 审查时间：2026-04-08 审查范围：DEVELOPMENTPLAN.md、KNOWLEDGEPLATFORMDESIGN.md、PLATFORMGAP.md、FRONTENDUISPEC.md、MINIAPPPLAN.md、后端模型与 API 层、小程序代码 结论：发现 20 项结构性缺口，其中 3 项致命（卡住商业闭环）、4 项严重、6 项重要、7 项远期。已按优先级写入 DEVELOPMENTPLAN.md 对应 Phase。 --- A. 致命缺口（不补会卡住商业闭环） A1. 支付网关完全空白 现状：Orders / Bookings 模型有金额字段，但无微
架构设计：IoT 硬件签到 + AI 智能体融合
版本：2026-04-18 覆盖范围：体脂秤/场馆门禁 IoT 数据管道、运动档案、七类 AI 智能体设计方案 --- 1. 现状与新增场景 现有硬件链路（已在代码库中） fuse-api /qx/hardware/face/ 人脸绑定与识别 fuse-api /qx/hardware/attendance/ 考勤场次 CRUD + 批量登记 fuse-api /qx/hardware/iot/ 待补全：设备主动推送入口 QxUserFaces 人脸库 QxFaceCheckin
智游讲解（文旅 SaaS）+ 文旅总后台（RuoYi）整合开发计划（TRAE 执行版）
定位：千夜科技为文体旅行业智能化解决方案提供商；千夜网为行业知识库；本项目在「智慧体育」基础上扩展「文化旅游」。 目标：新增一套文旅域能力，并配套一个更成熟的总后台（基于 RuoYi 思路/tuoyi）给运营公司与景区管理员使用；前端上线多端应用 「智游讲解」（先 H5，后小程序/APP）。 --- 0. 总原则（TRAE 必须遵守） 1. 域隔离：智体融合业务域（现有 fuse- 主栈）与文旅域接口分路径演进；文旅域独立迭代。 2. RuoYi 只做“后台通用能力 + 文旅运营管理”：租户/账号/菜单/字典/审计/任务/内容管理；不要把 AI 生成、识别流水线等核心业务硬塞进 RuoY
本地一键联调（小白测试）
[保持英文] 目标：用 Docker 在本机拉起仓库里能容器化运行的主要服务，并给出 URL + 测试账号。 一键脚本：仓库根目录执行 ./scripts/local-stack.sh（或 bash scripts/local-stack.sh）。 前置：已安装 Docker（含 docker compose v2）。Windows 可用 WSL2 或 Git Bash 跑脚本。 端口占用：确保本机 3308、3000–3003、8010、12580、19099、13306、16379 未被其它程序占用。若你本机已有名为 sports-booking-mysql 或 zhihui-spor
项目与数据库边界 — RuoYi 总后台 + 业务域发挥
结论（先读） - 不必为「对齐菜单脑图」而整体搬迁目录或大拆仓库；当前 按服务/子模块边界 已够用。 - 必须坚持：RuoYi 自有库 ≠ 业务域库；RuoYi 只经 HTTP + 内网 token 调 fuse-api，与 fuse-ops/INTEGRATION.md 一致。 - 数据库：推荐 同一 MySQL 实例可并存、逻辑上分库/分前缀，或 两实例（RuoYi 一套、业务一套）；禁止 RuoYi 直连读写 qx / tour 业务表。 --- 1. 角色分工（你定的「RuoYi = 总后台」） 层 工程
B 端合并与架构边界 — 决策表
目的：把「是否合并、何时合并、合并前提」写成可评审的一页纸，避免口头方案在落地时走样。 范围：fuse-platform（租户中台）与 fuse-ops（RuoYi 运营）前端统一、fuse-ops → fuse-api 代理收缩、RuoYi 后端与 fuse-mini 边界。 不讨论：C 端小程序业务细节（默认 fuse-mini 保持独立）。 修订说明：§2「试点」白名单、§3 P2 路径、P0 前置清单、§6 /system/ 归属、§7 RuoYi 后端策略，采纳外部评审意见补全（可随评审继续改）。 --- 1. 总览决策矩阵 决策项
知识库跨域复用
版本: v1.0 日期: 2026-05-07 状态: 规划中 --- 1. 概述 本文档定义知识库的跨域复用设计，实现体育域与文旅域的内容复用和统一管理。 核心目标： 1. 体育域 + 文旅域 共用同一套知识库架构 2. 内容一次创建，多域复用 3. 域间隔离，数据安全 4. AI能力统一，模型共享 --- 2. 域定义 2.1 域的类型 域 说明 典型场景 ---------------------- 体育域 体育培训、赛事、俱乐部 篮球培训、足球赛事 文旅域 研学旅行、景区游览、文化体验 研学营、景区讲解 2.2 域与内容的关系 ┌────────────────
菜单与知识库 — 总后台 / 体育 / 旅游 分级说明
目的：把与知识库相关的入口放在清晰的域划分里；列出当前系统已有菜单/路由；标明缺口与未来方向，便于排期（含 TRAE）。 三个平面 平面 含义 典型工程 ----------------- -------------------- ---------------------------------------------------------- A. 总后台（平台） 跨租户、合同级、套餐与审计
智游讲解 API 契约文档
1. 景区管理 API 1.1 获取景区列表 - 路径: /api/tour/scenic-areas - 方法: GET - 参数: - page: 页码，默认 1 - pagesize: 每页数量，默认 20 - name: 景区名称（可选） - status: 状态（可选） - 响应: json { "code": 200, "data": { "items": [ { "id": 1, "name": "故宫博物院", "description": "中国明清
智游讲解 H5 用户流程文档
1. 首页流程 1.1 页面结构 - 顶部导航：logo、搜索按钮 - 地图区域：显示景区地图，标记 POI 点位 - 快捷入口：讲解、识别、任务 - 推荐列表：推荐景点/展品 1.2 交互流程 1. 用户进入首页 → 加载地图和推荐列表 2. 点击地图上的 POI 点位 → 显示点位详情弹窗 3. 点击弹窗中的「查看详情」→ 进入点位/展品详情页 4. 点击快捷入口 → 进入对应功能页面 5. 点击搜索按钮 → 进入搜索页面 2. 识别流程 2.1 页面结构 - 相机预览：实时相机画面 - 拍照按钮：触发拍照识别 - 相册按钮：选择相册图片 - 识别历史：最近识别记录 2.2 交互流程 1.
智游讲解数据模型文档
1. 数据库表结构 1.1 景区表（tourscenicarea） 字段名 数据类型 约束 描述 :--- :--- :--- :--- id INT PRIMARY KEY, AUTOINCREMENT 景区 ID tenantid INT INDEX 租户 ID name VARCHAR(255) NOT NULL 景区名称 description TEXT 景区描述 centerlat VARCHAR(32) 中心点纬度 centerlng VARCHAR(32) 中心点经度 boundary TEXT
服务号自定义菜单配置表
[保持英文] 运营填写 菜单类型、目标链接 后，研发在公众号后台同步配置。 状态：draft ready live deprecated 一级菜单 二级菜单 菜单类型 目标（URL 或 小程序） AppId（若小程序） Path（若小程序） 负责人 状态 上线日 --------------------------------------------------------------------------------------------------------------- 球局 约球 小程序 小程序 wx1234567890123456
微信公众号服务号菜单 — 文件索引
[保持英文] 总计划：../WECHATSERVICEACCOUNTMENUPRODUCTIONPLAN.md UI 宪法：../FRONTENDUISPEC.md 配置表（运营填链） 文件 说明 ------------ MENUCONFIG.md 菜单文案、载体、目标 URL / 小程序 path、负责人、状态 各入口规格（产品 / 研发共用） 一级 二级 规格文件 ---------------------- 球局 约球 specs/MENUball-pickup.md 球局 订场 specs/MENUbook-venue.md 球局 比赛接龙
菜单规格：赛事全管（服务）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 服务 二级菜单 赛事全管 载体 建议：H5 介绍 + 登录赛事中台；重度编排 PC 关联配置行 MENUCONFIG.md — 服务 / 赛事全管 版本 v0.1 draft 2. 用户意图 - Who：赛事主办方、执行公司。 - 要完成的事（一句话）：一站式管理报名、抽签、赛程、成绩与展示（以产品范围为准）。 - 成功标准：从菜单进入后能在 1 分钟内理解价值并完成登录或留资。 3. 首屏结构（意图驱动） - 主意图区：「创建赛事」或「进入控制台」唯一主路径（产品定）。 -
菜单规格：约球（球局）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 球局 二级菜单 约球 载体 建议：小程序（定位/即时沟通）；备选 H5 关联配置行 MENUCONFIG.md — 球局 / 约球 版本 v0.1 draft 2. 用户意图 - Who：想找人一起打球或组局的 C 端用户。 - 要完成的事（一句话）：快速发布或加入一场球局。 - 成功标准：用户能在 3 步内完成「发布局」或「加入局」并看到确认态。 3. 首屏结构（意图驱动） - 主意图区：「发布球局」主按钮 + 次要「附近可加入」列表入口；或统一搜索/筛选「运动项目 + 时间 +
菜单规格：订场（球局）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 球局 二级菜单 订场 载体 建议：H5 或小程序（以支付与场馆系统对接为准） 关联配置行 MENUCONFIG.md — 球局 / 订场 版本 v0.1 draft 2. 用户意图 - Who：需要预订场地的个人或队长。 - 要完成的事（一句话）：按时间/场地类型完成预订并支付（若需）。 - 成功标准：选场 → 选时段 → 下单/支付 → 订单详情可复查。 3. 首屏结构（意图驱动） - 主意图区：场地搜索（区域/场馆名）+ 日期选择；或「常用场馆」快捷入口。 - 次要入口：我
菜单规格：赛事运营（机构）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 机构 二级菜单 赛事运营 载体 建议：H5（案例与方案）；深度工具走 B 端登录后 H5/PC 关联配置行 MENUCONFIG.md — 机构 / 赛事运营 版本 v0.1 draft 2. 用户意图 - Who：赛事主办方、俱乐部了解托管/承办服务。 - 要完成的事（一句话）：了解服务能力并留下合作需求或预约顾问。 - 成功标准：留资表单提交成功 + 预期回访时间说明。 3. 首屏结构（意图驱动） - 主意图区：「获取方案」或「预约顾问」单一主按钮 + 服务模块摘要（可折叠）。
Codeup + Drone 三环境（标准路径：不直连 VPS）
[保持英文] 标准约定：Codeup 不向业务 VPS 暴露部署 Webhook。代码推送阿里云 Codeup 后，由 Drone（绑定 Codeup、自动注册仓库 Webhook）拉取构建，再通过根目录 scripts/deploy.sh SSH + rsync + docker pull 更新各环境；与 1001n.cn 主栈 + 1001n.net 仅生产知识库 的域名规范一致（详见 ENVDOMAINMATRIX.md、DEPLOYMENT1001NENVPLAN.md）。 落地步骤与 Secrets：CICDGUIDE.md。 --- 1. 权威仓库与分支 项 约定 -----
知识库B端页面设计
版本: v1.0 日期: 2026-05-07 状态: 规划中 --- 1. 概述 本文档定义知识库B端管理页面的交互设计，包括中台（fuse-platform）内的知识库管理模块。 设计原则： - 意图驱动：首屏给意图入口，不是分类树 - 一步法则：能一步完成的绝不拆成两步 - 极简视觉：黑白灰为底，单一主色用于关键操作 --- 2. 入口设计 2.1 侧边栏入口 角色 入口位置 入口名称 -------------------------- admin 内容与家长服务 → 知识库管理 知识库 club-owner 内容与家长服务 → 知识库管理 知识库 coach
知识库AI能力矩阵
版本: v1.0 日期: 2026-05-07 状态: 规划中 --- 1. 概述 本文档定义知识库的AI能力矩阵，涵盖内容处理流水线、问答引擎、复利引擎等核心AI能力。 设计原则： - AI做初稿，人做审核（Co-pilot, Not Auto-pilot） - 不把用户隐私数据塞进Prompt - 可解释可追溯，引用必须标注来源 --- 2. 能力总览 ┌─────────────────────────────────────────────────────────────────┐ │ AI能力矩阵
知识库数据模型
版本: v1.0 日期: 2026-05-07 状态: 规划中 --- 1. 概述 本文档定义知识库核心数据表结构，覆盖分类体系、文章管理、阅读跟踪、AI处理记录等实体。 设计原则： - 所有表前缀 qxkb 或 qxknowledge - 所有查询必须带 tenantid 条件 - isdeleted 软删除，不物理删除 - AI字段由系统自动填充，人工可编辑 --- 2. ER关系图 ┌─────────────────────┐ ┌──────────────────────────┐ │ qxkbcategories │──1:N─│ qxkbarticles
知识库文档体系 — 本索引
版本: v1.0 日期: 2026-05-07 状态: 规划中 --- 0. 概述 本文档是知识库专题文档的总入口，按分层架构组织，涵盖从底层数据到上层应用的完整设计。 文档路径: docs/knowledge/ --- 1. 知识库文档层级 docs/knowledge/ ├── README.md ← 本索引 ├── 知识库规划总览.md ← 整体定位、分层、设计原则（✅已有） ├── 知识库数据模型.md ← 表结构、ER图、字段说明 ├── 知识库API契约.md ← 接口设计
多模态模型架构方案
项目路径：/Users/qykj/projects/demo/sct/ 最后更新：2026-04-18 维护团队：沈阳英泰数字科技部 一、多模态模型应用场景 场景 输入模态 输出模态 典型应用 ------------------------------------ 视频分析 视频/图像 文本/结构化数据 赛事视频分析、动作识别 硬件IoT 图像/传感器数据 文本/告警 人脸识别、体脂数据异常检测 教练助手 文本/图像 文本/计划 训练计划生成、课后小结 场馆管理 图像/传感器数据 文本/建议 场地利用率分析、调度建议 学员档案 文本/图像
客服体系设计 — 小程序为主入口
版本: v1.0 日期: 2026-05-07 状态: 规划中 --- 0. 定位 小程序是核心客服入口（C端用户主战场），企微客服 + 在线咨询 + 工单闭环。 - 企微客服：小程序调起 → 企微客服会话 → 群转化 - 在线咨询：小程序内提交 → B端处理 → 闭环 - 工单系统：复杂问题 → 工单 → 处理 → 评价 --- 1. 客服场景 1.1 咨询入口（小程序） 位置 形式 说明 ------------------ 全局浮窗 客服图标（右下角） 随时可触达，最便捷 赛事详情页 「咨询」按钮 报名咨询、赛事问题 课程详情页 「咨询」按钮 课程咨询、研学
知识库文档体系 — 索引目录
版本: v1.0 日期: 2026-05-07 状态: 规划中 --- 0. 知识库文档层级总览 docs/ ├── 📂 knowledge/ ← 【新建】知识库专题文档 │ ├── README.md ← 本索引 │ ├── 知识库规划总览.md ← 整体定位、分层、设计原则 │ ├── 知识库数据模型.md ← 表结构、ER图、字段说明 │ ├── 知识库API契约.md ← 接口设计 │ ├── 知识库B端页面设计.md
菜单规格：家长（主入口）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 主入口（与公众号首屏菜单结构对齐；若一级无「主入口」则本项为一级直开） 二级菜单 家长 载体 建议：小程序（孩子多角色）；H5 兜底 关联配置行 MENUCONFIG.md — 家长 版本 v0.1 draft 2. 用户意图 - Who：家长用户。 - 要完成的事（一句话）：查看孩子相关活动、课时、报名与消息。 - 成功标准：登录后默认落到「我的孩子/日程」主视图，主操作明确（如「去报名」「查看课表」）。 3. 首屏结构（意图驱动） - 主意图区：孩子切换 + 今日/近期关键一条
菜单规格：比赛接龙（球局）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 球局 二级菜单 比赛接龙 载体 建议：小程序（分享卡片、群场景）；H5 作兜底 关联配置行 MENUCONFIG.md — 球局 / 比赛接龙 版本 v0.1 draft 2. 用户意图 - Who：组织者发接龙、队员报名占位。 - 要完成的事（一句话）：创建接龙或一键报名并看到自己在名单中。 - 成功标准：分享链接/卡片后，他人可打开并完成报名闭环。 3. 首屏结构（意图驱动） - 主意图区：「创建接龙」或「输入接龙码/扫二维码进入」二选一主路径。 - 次要入口：我参与的、模
菜单规格：教练或裁判入驻（主入口）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 主入口 二级菜单 教练或裁判入驻 载体 建议：H5 表单 + 资质上传；审核状态可小程序消息 关联配置行 MENUCONFIG.md — 教练或裁判入驻 版本 v0.1 draft 2. 用户意图 - Who：教练、裁判申请平台认证。 - 要完成的事（一句话）：选择角色、提交资料与证件、查看审核进度。 - 成功标准：提交成功页含预计审核时间与补充材料入口。 3. 首屏结构（意图驱动） - 主意图区：角色选择（教练 / 裁判）→ 对应最短必要表单；首屏仅「开始入驻」一个主色主按钮。
菜单规格：场地服务（服务）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 服务 二级菜单 场地服务 载体 建议：H5；场馆主理人高频操作可小程序 关联配置行 MENUCONFIG.md — 服务 / 场地服务 版本 v0.1 draft 2. 用户意图 - Who：场馆运营方。 - 要完成的事（一句话）：了解场地数字化/营销/托管服务并联系销售或自助开通。 - 成功标准：明确下一步（留资、预约演示或登录 SaaS）。 3. 首屏结构（意图驱动） - 主意图区：「预约演示」或「登录管理后台」二选一为主（产品定唯一主色按钮）；服务列表为次。 - 次要入口
菜单规格：`MENU_<slug>`
复制本文件为 MENU<slug.md 后删除本行说明。 1. 元信息 项 内容 ---------- 一级菜单 二级菜单 载体 H5 / 小程序 / H5→小程序分流 关联配置行 MENUCONFIG.md 第 N 行 版本 v0.1 draft 2. 用户意图 - Who： - 要完成的事（一句话）： - 成功标准： 3. 首屏结构（意图驱动） 对齐 FRONTENDUISPEC.md §1、§2.1：INTENTDRIVENREFACTOR G2。 - 主意图区（搜索框 / 单一主按钮，全页仅一个主色主操作）： - 次要入口（文字链
菜单规格：赛事报名（主入口）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 主入口 二级菜单 赛事报名 载体 建议：H5（外链分享）+ 小程序（支付与登录体验） 关联配置行 MENUCONFIG.md — 赛事报名 版本 v0.1 draft 2. 用户意图 - Who：参赛个人或队伍联系人。 - 要完成的事（一句话）：找到目标赛事、填写报名表、完成支付（若需）。 - 成功标准：订单/报名成功页含赛事名、时间、退款规则入口。 3. 首屏结构（意图驱动） - 主意图区：赛事搜索（名称/城市/时间）或「进行中赛事」列表。 - 次要入口：我的报名、规则总览。
菜单规格：特色学校（机构）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 机构 二级菜单 特色学校 载体 建议：H5（内容展示+外链咨询）；深度能力可小程序 关联配置行 MENUCONFIG.md — 机构 / 特色学校 版本 v0.1 draft 2. 用户意图 - Who：家长或校方了解特色体育项目与入校方式。 - 要完成的事（一句话）：浏览学校列表/详情并发起咨询或报名意向。 - 成功标准：详情页信息完整，主 CTA（咨询/报名）一键可达。 3. 首屏结构（意图驱动） - 主意图区：搜索/筛选（区域、项目）或「推荐学校」列表。 - 次要入口：合
菜单规格：机构职管（服务）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 服务 二级菜单 机构职管 载体 建议：H5 → 中台/HR 模块（PC 适配可提示） 关联配置行 MENUCONFIG.md — 服务 / 机构职管 版本 v0.1 draft 2. 用户意图 - Who：俱乐部/培训机构管理员。 - 要完成的事（一句话）：进入职员管理（排班、考勤、合同等以产品为准）或了解产品后留资。 - 成功标准：登录后落到机构职管首页；未登录则完成留资或下载资料。 3. 首屏结构（意图驱动） - 主意图区：已签约客户「登录」为主；潜客「预约介绍」为主（分人群勿
菜单规格：青训机构（机构）
[保持英文] 1. 元信息 项 内容 ---------- 一级菜单 机构 二级菜单 青训机构 载体 建议：H5；试听课预约可小程序 关联配置行 MENUCONFIG.md — 机构 / 青训机构 版本 v0.1 draft 2. 用户意图 - Who：家长为孩子找青训班。 - 要完成的事（一句话）：按区域/年龄/项目找到机构并预约体验或报名。 - 成功标准：预约成功页含时间地点与取消说明。 3. 首屏结构（意图驱动） - 主意图区：项目 + 年龄 + 区域筛选；或地图找附近机构。 - 次要入口：我的预约、常见问题。 - 禁止：首屏多 com
企业微信整合方案 — 服务号为主心骨
版本: v4.0 日期: 2026-05-07 状态: 规划中 --- 0. 整体架构 服务号 = 对外入口中枢，企微 = 内部协同 + 客户群管理。 ┌─────────────────────────┐ │ 服务号 │ │ （对外入口中枢） │ │ │ │ · 登录（OAuth扫码）
角色导航菜单规划
1. 家长 (PARENT) 底部导航 - 首页 - 名册 - 消息 - 我的 快捷操作 - 签到 - 报名 - 健康管理 - 训练计划 - 赛事报名 - 缴费 侧边导航 - 我的孩子 - 课程报名 - 签到记录 - 赛事报名 - 提交反馈 - 青训目标 - 训练计划 - 训练日记 - 成长记录 - 技能成长 - 健康管理 - 荣誉成就 - 个人设置 - 免责声明 - 知识库 2. 教练 (COACH) 底部导航 - 首页 - 学员 - 消息 - 我的 快捷操作 - 课次签到 - 学员管理 - 训练反馈 - 课程管理 - 表现分析 - 训练日记 侧边导航 - 学员管理 - 课次签到 - 训练反
模板商品化文档 (A2)
1. 模板概述 1.1 模板定义 - 模板：预配置的应用界面和功能集合，可快速部署和定制 - 租户：使用模板的组织或个人 - 配置：租户对模板的个性化设置 1.2 模板类型 - 基础模板：包含核心功能的标准模板 - 行业模板：针对特定体育行业的专用模板 - 定制模板：根据租户需求定制的专属模板 2. 商业模式 2.1 定价策略 - 基础版：免费，包含核心功能 - 专业版：月付/年付，包含高级功能 - 企业版：定制化报价，包含专属服务 2.2 收费模式 - 订阅制：按月/年收取使用费 - 永久授权：一次性收取授权费 - 混合模式：基础功能免费，高级功能订阅 2.3 增值服务 - 模板定制：根据租