Skip to content

feat(workbench): migrate the local workspace to FastAPI and React #131

Description

@tiammomo

问题概述

将现有只读工作台迁移为 FastAPI + TypeScript / React / Vite,在同一安装包中提供有类型契约、可扩展路由与完整既有读取功能的本地应用。

实际结果

工作台当前使用 ThreadingHTTPServer 与单个原生 JavaScript 文件;已有项目、代码导览、任务、审阅与诊断读取,但缺少类型契约、组件边界和标准前端构建分发。

期望结果

默认安装后继续用 reposteward web 启动 FastAPI 同源服务,React 页面完整提供现有读取流程;OpenAPI 生成 TypeScript 类型,安装 wheel 无需源码目录或 Node,公开写入仍使用既有原生门禁。

复现步骤

检查当前web_server.py、workbench.py、web/app.js和独立安装的网页功能,对照用户接受的FastAPI+React工作台设计。

环境信息

2026-09-06 fresh main e9ca1cb; Python 3.12+; local read-only workbench baseline.

验收条件

  • FastAPI / Pydantic / Uvicorn 接管本地 HTTP;保留127.0.0.1、精确Host/Origin、短期会话、并发/输入/输出限制、配置变化检测与无凭据前端。
  • 项目、导览/代码证据、任务接续、审阅与设置在 React / TypeScript / Vite 页面可用,支持深链接、项目切换、加载/空/失败/过期状态和窄屏。
  • HTTP DTO 与 OpenAPI 可在无账号、无网络、无日常DB下导出并生成 TypeScript 契约;读取继续复用现有 Workbench 服务,不隐式同步、扫描、初始化数据库或执行发布任务。
  • 前端静态资源与资源清单进入wheel和sdist,构建检查依赖锁与产物一致性;默认安装后的web命令不增加日用Node要求。
  • 在加固验证环境运行ASGI/真实HTTP边界、前端类型与交互、独立wheel浏览器验收以及完整Python回归/ruff/CLI/build;现有CLI/MCP和发布门禁保持有效。

补充信息

用户已确认技术选型与实施授权。本Issue范围是新框架工作台的完整迁移与分发,后续GitHub同步/终态分类、已有项目三路径导入、持久操作及任务聚合分别进入聚焦Issue。本次保留现有只读业务语义,新增/api/v1类型契约与兼容读取适配;前端采用项目导航与组件结构,保留既有读取和复制能力。新操作只在后续能力真实实现后出现。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions