Initial commit: 3D Viewer application

Features:
- Vue 3 frontend with Three.js/Online3DViewer
- Node.js API with PostgreSQL and Redis
- Python worker for model conversion
- Docker Compose for deployment
- ViewCube navigation with drag rotation and 90° snap
- Cross-section, exploded view, and render settings
- Parts tree with visibility controls

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
likegears
2025-12-12 14:00:17 +08:00
commit 7af9c323f6
86 changed files with 20343 additions and 0 deletions

27
project-management.csv Normal file
View File

@@ -0,0 +1,27 @@
任务ID,任务名称,负责人,阶段,优先级,状态,预计工时(天),开始日期,截止日期,依赖项,备注
1.1,Docker 环境搭建,后端,第一周,P0,已完成,1,2024-12-02,2024-12-02,-,PostgreSQL/Redis/MinIO
1.2,数据库 Schema 设计,后端,第一周,P0,已完成,0.5,2024-12-02,2024-12-02,1.1,models/model_parts表
1.3,API 服务框架,后端,第一周,P0,已完成,1.5,2024-12-02,2024-12-03,1.1,Express + TypeScript
1.4,MinIO 存储服务,后端,第一周,P0,已完成,1,2024-12-03,2024-12-04,1.1,预签名URL上传
1.5,BullMQ 队列服务,后端,第一周,P0,已完成,0.5,2024-12-04,2024-12-04,1.1,任务队列
1.6,Python Worker 框架,后端,第一周,P0,已完成,1,2024-12-04,2024-12-05,1.5,模型转换基础
1.7,Vue 前端框架,前端,第一周,P0,已完成,1,2024-12-02,2024-12-03,-,Vue3 + Vite + Pinia
1.8,3D Viewer 组件,前端,第一周,P0,已完成,1.5,2024-12-03,2024-12-05,1.7,Online3DViewer集成
1.9,爆炸图服务,前端,第一周,P1,已完成,1,2024-12-05,2024-12-06,1.8,ExplodeService
1.10,剖面服务,前端,第一周,P1,已完成,1,2024-12-05,2024-12-06,1.8,ClippingService
2.1,STEP 文件转换,后端,第二周,P0,进行中,2,2024-12-09,2024-12-10,1.6,cascadio → GLB
2.2,STL/OBJ 转换,后端,第二周,P0,待开始,1,2024-12-10,2024-12-11,1.6,trimesh → GLB
2.3,缩略图生成,后端,第二周,P1,待开始,1.5,2024-12-11,2024-12-12,2.1,pyrender + OSMesa
2.4,模型上传流程,前端,第二周,P0,待开始,1,2024-12-09,2024-12-10,1.4,拖拽上传 + 进度条
2.5,模型列表页,前端,第二周,P0,待开始,1.5,2024-12-10,2024-12-11,2.4,缩略图 + 搜索 + 筛选
2.6,模型详情页,前端,第二周,P0,待开始,1,2024-12-11,2024-12-12,2.5,查看 + 编辑 + 删除
2.7,爆炸图 UI 完善,前端,第二周,P1,待开始,1,2024-12-12,2024-12-13,1.9,滑块 + 动画效果
2.8,剖面 UI 完善,前端,第二周,P1,待开始,1,2024-12-12,2024-12-13,1.10,三轴控制 + 翻转
3.1,错误处理完善,全栈,第三周,P0,待开始,1,2024-12-16,2024-12-16,2.*,统一错误格式
3.2,加载状态优化,前端,第三周,P1,待开始,0.5,2024-12-16,2024-12-16,2.5,Skeleton + Loading
3.3,大模型性能优化,前端,第三周,P1,待开始,1.5,2024-12-17,2024-12-18,1.8,LOD + 懒加载
3.4,Worker 并发优化,后端,第三周,P2,待开始,1,2024-12-17,2024-12-18,1.6,资源限制
3.5,UI 样式美化,前端,第三周,P2,待开始,1,2024-12-18,2024-12-19,2.*,响应式 + 动效
3.6,E2E 测试,QA,第三周,P1,待开始,1,2024-12-19,2024-12-20,3.*,Playwright
3.7,文档编写,全栈,第三周,P2,待开始,0.5,2024-12-20,2024-12-20,全部,README + API文档
3.8,部署脚本,DevOps,第三周,P1,待开始,0.5,2024-12-20,2024-12-20,全部,CI/CD配置
1 任务ID 任务名称 负责人 阶段 优先级 状态 预计工时(天) 开始日期 截止日期 依赖项 备注
2 1.1 Docker 环境搭建 后端 第一周 P0 已完成 1 2024-12-02 2024-12-02 - PostgreSQL/Redis/MinIO
3 1.2 数据库 Schema 设计 后端 第一周 P0 已完成 0.5 2024-12-02 2024-12-02 1.1 models/model_parts表
4 1.3 API 服务框架 后端 第一周 P0 已完成 1.5 2024-12-02 2024-12-03 1.1 Express + TypeScript
5 1.4 MinIO 存储服务 后端 第一周 P0 已完成 1 2024-12-03 2024-12-04 1.1 预签名URL上传
6 1.5 BullMQ 队列服务 后端 第一周 P0 已完成 0.5 2024-12-04 2024-12-04 1.1 任务队列
7 1.6 Python Worker 框架 后端 第一周 P0 已完成 1 2024-12-04 2024-12-05 1.5 模型转换基础
8 1.7 Vue 前端框架 前端 第一周 P0 已完成 1 2024-12-02 2024-12-03 - Vue3 + Vite + Pinia
9 1.8 3D Viewer 组件 前端 第一周 P0 已完成 1.5 2024-12-03 2024-12-05 1.7 Online3DViewer集成
10 1.9 爆炸图服务 前端 第一周 P1 已完成 1 2024-12-05 2024-12-06 1.8 ExplodeService
11 1.10 剖面服务 前端 第一周 P1 已完成 1 2024-12-05 2024-12-06 1.8 ClippingService
12 2.1 STEP 文件转换 后端 第二周 P0 进行中 2 2024-12-09 2024-12-10 1.6 cascadio → GLB
13 2.2 STL/OBJ 转换 后端 第二周 P0 待开始 1 2024-12-10 2024-12-11 1.6 trimesh → GLB
14 2.3 缩略图生成 后端 第二周 P1 待开始 1.5 2024-12-11 2024-12-12 2.1 pyrender + OSMesa
15 2.4 模型上传流程 前端 第二周 P0 待开始 1 2024-12-09 2024-12-10 1.4 拖拽上传 + 进度条
16 2.5 模型列表页 前端 第二周 P0 待开始 1.5 2024-12-10 2024-12-11 2.4 缩略图 + 搜索 + 筛选
17 2.6 模型详情页 前端 第二周 P0 待开始 1 2024-12-11 2024-12-12 2.5 查看 + 编辑 + 删除
18 2.7 爆炸图 UI 完善 前端 第二周 P1 待开始 1 2024-12-12 2024-12-13 1.9 滑块 + 动画效果
19 2.8 剖面 UI 完善 前端 第二周 P1 待开始 1 2024-12-12 2024-12-13 1.10 三轴控制 + 翻转
20 3.1 错误处理完善 全栈 第三周 P0 待开始 1 2024-12-16 2024-12-16 2.* 统一错误格式
21 3.2 加载状态优化 前端 第三周 P1 待开始 0.5 2024-12-16 2024-12-16 2.5 Skeleton + Loading
22 3.3 大模型性能优化 前端 第三周 P1 待开始 1.5 2024-12-17 2024-12-18 1.8 LOD + 懒加载
23 3.4 Worker 并发优化 后端 第三周 P2 待开始 1 2024-12-17 2024-12-18 1.6 资源限制
24 3.5 UI 样式美化 前端 第三周 P2 待开始 1 2024-12-18 2024-12-19 2.* 响应式 + 动效
25 3.6 E2E 测试 QA 第三周 P1 待开始 1 2024-12-19 2024-12-20 3.* Playwright
26 3.7 文档编写 全栈 第三周 P2 待开始 0.5 2024-12-20 2024-12-20 全部 README + API文档
27 3.8 部署脚本 DevOps 第三周 P1 待开始 0.5 2024-12-20 2024-12-20 全部 CI/CD配置