# subtaskmgr2.0

**Repository Path**: cnmoon/subtaskmgr2.0

## Basic Information

- **Project Name**: subtaskmgr2.0
- **Description**: 子任务管理软件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-11
- **Last Updated**: 2026-07-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 卫星子任务管理框架 V2.0

**Satellite Subtask Management Framework V2.0**

一个可解释、可追溯、可扩展的卫星子任务管理系统，负责管理遥感卫星执行各种子任务的全生命周期。

## 核心特性

- ✅ **可解释性**：清晰展示子任务管理的每一个步骤和要素
- ✅ **可追溯性**：所有决策和状态变化可回溯，问题可定位
- ✅ **可扩展性**：支持不同需求类型、不同卫星、不同载荷
- ✅ **双重展示**：静态规则展示 + 动态运行监控
- ✅ **AI可测试**：通过Playwright自动化截图测试，AI可独立验证前端效果

## 技术栈

### 后端
- **Python 3.11+**
- **FastAPI** - 现代化Web框架
- **SQLite** - 轻量级数据库
- **WebSocket** - 实时状态推送

### 前端
- **React 18** + **TypeScript**
- **Vite** - 极速开发体验
- **Ant Design 5.x** - 企业级UI组件库
- **ReactFlow** - 状态机和流程图可视化
- **Recharts** - 时间线图表

### 测试
- **Playwright** - 前端自动化测试
- **Pytest** - 后端单元测试

## 快速开始

### 1. 克隆项目

```bash
git clone https://gitee.com/cnmoon/subtaskmgr2.0.git
cd subtaskmgr2.0
```

### 2. 启动后端服务

```bash
cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload
```

访问 API 文档：http://localhost:8000/docs

### 3. 启动前端服务

```bash
cd frontend
npm install
npm run dev
```

访问前端界面：http://localhost:5173

### 4. 运行测试

#### 后端测试
```bash
cd backend
pytest
```

#### 前端测试（Playwright）
```bash
cd tests
python test_frontend.py --component=state-machine
```

## 项目结构

```
subtaskmgr2.0/
├── backend/                    # 后端（Python + FastAPI）
│   ├── app/
│   │   ├── main.py            # FastAPI应用入口
│   │   ├── core/              # 核心数据模型
│   │   ├── engine/            # 管理引擎
│   │   ├── plugins/           # 插件系统
│   │   ├── api/               # API路由
│   │   └── examples/          # 示例子任务类型
│   ├── requirements.txt
│   └── README.md
├── frontend/                   # 前端（React + TypeScript）
│   ├── src/
│   │   ├── components/        # 可视化组件
│   │   ├── views/             # 页面视图
│   │   ├── api/               # API调用
│   │   └── types/             # TypeScript类型
│   ├── package.json
│   └── vite.config.ts
├── tests/                      # 自动化测试
│   ├── test_frontend.py       # Playwright测试
│   └── screenshots/           # UI截图
├── docs/                       # 文档
│   ├── 需求规格说明_V2.0.md
│   └── 技术方案与实施计划.md
└── README.md
```

## 核心概念

### 三类状态机
1. **OverallStatus**：子任务综合状态（PENDING → ACTIVE → COMPLETED）
2. **ImagingState**：成像作业状态（IDLE → PREPARING → IMAGING → IDLE）
3. **ProcessingState**：处理作业状态（WAITING ↔ PROCESSING）

### 五条时间线
1. **成像线**：载荷与卫星平台的反馈和状态
2. **处理线**：数据处理的反馈和状态
3. **判断线**：各类判断触发点
4. **决策线**：判断后的决策输出
5. **执行线**：指令下发点

### 子任务类型定义
子任务类型 = **需求类型** × **成像工作模式** × **载荷模态**

示例：`搜索 + 推扫 + 可见光` = 可见光推扫区域搜索子任务

## 开发指南

详见各模块的 README 文档：
- [后端开发指南](backend/README.md)
- [前端开发指南](frontend/README.md)

## 实施计划

项目采用**小步快跑**策略，分8个阶段实施：

- ✅ **阶段0**：项目初始化（已完成）
- 🔄 **阶段1**：核心数据模型
- 📅 **阶段2**：前端测试环境 + 状态机可视化
- 📅 **阶段2.5**：示例子任务详细设计沟通
- 📅 **阶段3**：示例子任务类型实现
- 📅 **阶段4**：静态规则展示
- 📅 **阶段4.5**：扩展性配置界面
- 📅 **阶段5-8**：时间线、动态展示、决策逻辑、优化

详细计划：[技术方案与实施计划](技术方案与实施计划.md)

## 文档

- [需求规格说明 V2.0](需求规格说明_V2.0.md)
- [技术方案与实施计划](技术方案与实施计划.md)

## 许可证

Copyright © 2026 卫星子任务管理框架项目组

## 贡献

欢迎提交 Issue 和 Pull Request！

---

**Generated by Claude Code** 🚀