交叉评测：智研星河 InvestEd Lab (MuskZhou/Stock-Simulator) #7
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
一、项目概述
智研星河 InvestEd Lab 是一个 AI × 教师协同的多租户仿真投资者教育平台。面向中学、大学通识课、财经素养社团与机构投教场景，把实时行情仿真、AI 市场叙事、教师运营管理、学生交易实践和复盘评价放在同一个闭环里。
技术栈：React 18 + TypeScript + Vite（双前端）+ Node/Express + Socket.IO + MySQL + 共享仿真引擎
代码规模：262 文件，209 commits
server: 79 files（后端 + 路由 + 中间件）
client: 54 files（租户/学生前端 React）
saas-admin: 21 files（SaaS 运营控制台）
packages/engine: 19 files（核心仿真引擎）
109 个 .ts 文件 + 40 个 .tsx 文件
二、六维度评测
评测一：项目定位与赛道契合度
评分：9/10
优点：
定位极其精准：投资者教育 + SaaS 多租户，不是单纯的模拟炒股小游戏，而是"可部署、可运营、可调参、可复盘"的教育实验室
教学闭环完整：观察市场 → 做出决策 → 承担结果 → 记录反思 → 教师讲评
政策契合度高：2026年金融素养教育纳入通识课，投教需求旺盛
差异化清晰：AI生成市场叙事 + 教师人工干预 + 学生仿真交易，三者协同
延展性强：支持嵌入现有校园平台、学习平台，B端变现路径清晰
问题：
"投资者教育"赛道天花板相对有限，规模化取决于学校/机构的采购意愿
与同花顺、东方财富等成熟投教产品相比，品牌认知度需要建立
评测二：技术架构与工程实现
评分：8/10
优点：
仿真引擎极其扎实：
几何布朗运动 + GARCH波动率聚类 + 肥尾分布 + 均值回归
四阶段经济周期（扩张/过热/衰退/萧条），利率自动调控
日内U型波动、隔夜跳空、板块轮动
24家虚拟公司，4大板块，供应链传导
多租户隔离设计到位：
TenantEngineBundle 封装每个租户的完整引擎实例
License Key + API Key + JWT 三层认证
租户命名空间 /t/ 实现Socket.IO隔离
域名白名单、用户上限、凭证轮换
交易机制真实：
9种交易类型（市价/限价/止损/止盈/做空/撤销）
阶梯手续费 + 持有期递减资本利得税
T+1、涨跌停、融券保证金、流动性三级
滑点按成交量/日均量二次方计算
安全加固专业：
Helmet CSP策略（移除unsafe-inline script-src）
CORS白名单校验（非反射式）
分级限流（auth 20次/5min, trading 30次/min）
bcrypt密码哈希 + JWT双密钥（用户/SaaS分离）
SSO短码一次性消费 + 120秒过期
AI引擎多角色：
新闻生成、行情分析、机构行为、参数建议、难度调节、玩家分析
7种市场风格预设（牛市/熊市/震荡/反弹/泡沫/危机/算法驱动）
队列管理 + 超时兜底 + 未配置AI时规则兜底
问题：
setDeps() 全局依赖注入模式有隐患：虽然注释说"Node.js单线程保证安全"，但如果未来引入Worker或异步续体跨租户，容易串号
mysql.ts 5449行，是巨型单体文件，维护成本高
App.tsx 1944行，React单组件承载路由+认证+16个页面，应拆分
无可见的测试文件（除1个catalog-restoration.test.ts）
明确说明"暂未提供Docker Compose"，部署门槛偏高
outputs/ 和 videos/ 目录37+20个文件，疑似构建产物入库
评测三：前端交互与用户体验
评分：8/10
优点：
16个功能页面：行情、持仓、问答、比赛、教师后台、盲盒、任务、日记、排行榜、预测、社交、成就、锦标赛等
实时Socket.IO推送价格、新闻、成就通知
教师控制面板功能完整：暂停行情、触发事件、调节参数、管理学生
双主题（深浅色）+ 国际化（中英文）
学生端体验设计周到：市场温度计（不直接暴露数值，培养分析能力）、新闻中性标签（需自行判断利好利空）
投资日记功能，沉淀交易理由和复盘素材
问题：
App.tsx 1944行过于庞大，页面组件应完全拆分
仅2个hooks文件（useSocket, useStore），复杂状态管理可能不足
没有看到响应式设计的明确实现，移动端适配存疑
盲盒/社交/排行榜等功能在教学核心路径之外，可能造成认知负担
评测四：商业模式与商业化潜力
评分：9/10
优点：
SaaS多租户模式天然适合B2B：学校/机构/培训机构付费使用
双交付模式：SaaS托管 + 完整自部署，满足不同客户需求
License Key + API Key 商业化基础设施完善
创业计划书已准备（附件1、创业计划书.docx）
目标市场明确：中学金融素养课、大学通识课、社团活动、机构投教
可选iframe嵌入，降低客户集成成本
租户运营控制台独立（saas-admin），运营方可管理多租户生命周期
问题：
定价策略未在README中体现
竞品分析缺失（同花顺投教、东方财富模拟炒股等）
用户增长策略不明确
虚拟公司设计（奶茶の星、汉堡王国等）偏低龄化，大学/机构场景可能需要更专业的标的
评测五：代码质量与可维护性
评分：7/10
优点：
TypeScript 全覆盖，类型注解完善
模块化清晰：engine包可独立复用
安全实践专业：Helmet、CORS、限流、JWT、bcrypt
中间件分层合理：requireTenant → requireAuth → requirePasswordChanged
异步处理规范：asyncHandler统一包装
交易归因系统（tradeAttribution）可追溯每笔交易的决策链
问题：
mysql.ts 5449行是最大隐患——所有数据访问逻辑集中在一处
market.ts 2395行也偏大
App.tsx 1944行（React组件不应这么长）
仅1个测试文件可见，测试覆盖严重不足
outputs/（37文件）和 videos/（20文件）目录占用仓库空间，应在.gitignore中排除
无CHANGELOG
全局 setDeps() 模式不利于测试和多租户安全
评测六：文档与社区建设
评分：7/10
优点：
README信息密度极高，功能矩阵、架构图、API速览、部署摘要一应俱全
features.md 功能清单极其详细（交易规则、市场机制、教学功能全覆盖）
guide.md 参赛指南面向中学生，语言通俗，教学导向清晰
TENANT-HANDOVER-SAAS.md 和 TENANT-HANDOVER-DELIVERY.md 交接文档完备
SSO-EMBED-INTEGRATION-SAAS.md iframe免登接入文档专业
DEPLOYMENT.md 部署指南
README.html 独立交互式产品文档
动态股票与新闻配置手册（中文）
问题：
CONTRIBUTING.md 未见（可能缺失）
无CHANGELOG
API文档依赖FastAPI自动生成？（实际是Express，可能需要手动维护）
仓库内5个Issues（可能是交叉评测产生）
社区互动为零
三、综合评分
表格
维度 评分 说明
项目方向 9/10 定位精准，教育赛道+政策红利，差异化明显
技术实现 8/10 仿真引擎极其扎实，多租户隔离到位，安全加固专业
用户体验 8/10 16个功能页面，实时推送，教师控制面板完整
商业潜力 9/10 SaaS多租户+B2B变现+双交付模式+创业计划书
代码质量 7/10 TypeScript全覆盖，但巨型文件+缺测试+全局依赖注入
文档建设 7/10 README+交接文档+指南齐全，但无CHANGELOG和API文档
综合：8.0/10