Touch WinLoop

WinLoop AI（赛帮帮）当前是一套面向竞赛团队的项目工作台，核心链路是：

选赛 -> 建项 -> 沉淀项目资源 -> 协作梳理 -> 提交与答辩准备

当前仓库已经不再只是早期骨架，而是围绕 Workspace / Project / Resource / Collab 这套模型持续演进。

当前产品模型

1. Workspace

• 个人或 Team 维度的项目空间。
• 负责成员、邀请、席位、配额与权限边界。

2. Project

• 工作推进的主对象。
• 挂载项目设置、竞赛绑定、资料池、协作资源、AI 改动提案与问题清单。

3. Resource

• 项目内唯一一等资料对象。
• 所有文件、协作文档、画布都统一作为 project resource 存储与展示。

当前资源形态：

resourceKind	collabPurpose	用户侧名称	说明
binary	-	资料预览	上传文件或系统资料库引用
markdown	notes	协作文档	面向结构化文字协作
draw	workflow	流程画布	项目唯一主流程画布
draw	freeform	自由画布	非主流程用途的自由画布

4. Outline

• ProjectOutline 是派生视图，不是独立编辑对象。
• 由项目设置和资料内容自动聚合，用于导航、浏览和结构梳理。

当前协作约定

• 左侧“流程”入口始终打开项目唯一的 workflow 画布。
• 左侧资源菜单只保留：
  • 新建协作文档
  • 新建自由画布
  • 从系统资源库导入
  • 从本地设备中上传
• 固定 flow tab 的用户可见名称统一为 流程画布。
• 流程画布 与资源列表中的同一条 workflow 资源指向同一个底层对象。

当前页面入口

• /team/:teamId/project/:projectId：项目工作区主界面
• /workspace/:workspaceId/project/:projectId：工作区项目页别名入口
• /admin/integrations/feishu：飞书集成中心

开发启动

pnpm install
pnpm dev

默认开发地址：

• http://localhost:3510

基础环境变量

至少需要显式配置以下运行时依赖：

WINLOOP_PG_URL=postgresql://user:password@127.0.0.1:5432/winloop
WINLOOP_REDIS_URL=redis://:password@127.0.0.1:6379/0
WINLOOP_CONFIG_MASTER_KEY=your-strong-master-key
WINLOOP_CONTEST_AUTO_SEED=false

补充说明：

• PostgreSQL 是当前运行时强依赖。
• Redis 主要用于运行时配置信息与预留能力。
• AI / 飞书等敏感配置支持加密存储。
• 资源回收 worker 参数改为后台 UI 管理，不再从 Env 读取。

相关文档

• 工作台信息架构
• 协作资源模型
• 当前重构计划
• Jenkins 部署说明
• 在线编辑选型 ADR（未来能力）
• 飞书多维同步教程

关于在线 Office 编辑

当前产品现状是：

• binary 资源支持上传、转换、预览。
• markdown/draw 资源支持实时协作。

ONLYOFFICE / Office 在线编辑属于后续能力规划，不属于当前已经落地的产品能力。相关背景和选型结论已整理为 ADR，而不是现状说明文档。