# AutoDevBotApp

**Repository Path**: cctv2/auto-dev-bot-app

## Basic Information

- **Project Name**: AutoDevBotApp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-14
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AutoDevBotApp

> 面向企业内部团队的可配置 Agent 工作流平台

[![.NET](https://img.shields.io/badge/.NET-10.0-512BD4?logo=dotnet)](https://dotnet.microsoft.com/)
[![Vue](https://img.shields.io/badge/Vue-3.5-4FC08D?logo=vue.js)](https://vuejs.org/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

---

## 📖 项目简介

AutoDevBotApp 是一个通用的 Agent 工作流平台，支持"需求分析、人工审核、执行跟踪、结果反馈、过程审计"的完整闭环。

**核心特性：**
- 🔄 可配置的工作流引擎
- 👤 人工审核节点（Human-in-the-loop）
- 📡 多渠道接入（飞书、Telegram）
- 🤖 多执行器支持（Codex、Qoder）
- 📊 完整的运行记录和审计日志

**第一场景：** 研发流程自动化
- 从 TAPD 拉取需求 → 自动拆解 → 人工审核 → 驱动执行器 → 回传结果

**未来扩展：** 标书撰写、方案编写等知识工作流

---

## 🏗️ 技术架构

### 后端技术栈
- **框架：** ASP.NET Core Web API (.NET 10.0)
- **架构：** Clean Architecture 多项目分层
- **ORM：** SqlSugar 5.1.4.169
- **数据库：** SQLite (开发) / MySQL (生产)
- **日志：** Serilog 4.2.0

**项目结构：**
```
AutoDevBotApp/
├── AutoDevBotApp.Web.Entry      # API 入口（端口 7001）
├── AutoDevBotApp.Application    # 用例与编排
├── AutoDevBotApp.Core           # 领域实体与业务规则
├── AutoDevBotApp.Infrastructure # 持久化、连接器、执行器
└── AutoDevBotApp.Contracts      # DTO 与契约
```

### 前端技术栈
- **框架：** Vue 3.5 + TypeScript
- **构建：** Vite 6.0
- **状态：** Pinia 2.3
- **路由：** Vue Router 4.5
- **数据：** TanStack Vue Query 5.62
- **样式：** Tailwind CSS 4.0
- **表单：** VeeValidate 4.15 + Zod 3.24

---

## 🚀 快速开始

### 环境要求
- Node.js 18+
- .NET 10.0 SDK
- Git

### 安装依赖

**前端：**
```bash
cd web
npm install
```

**后端：**
```bash
cd AutoDevBotApp
dotnet restore
```

### 开发运行

**前端开发服务器（端口 5173）：**
```bash
cd web
npm run dev
```

**后端 API 服务（端口 7001）：**
```bash
cd AutoDevBotApp
dotnet run --project AutoDevBotApp.Web.Entry
```

**或使用 watch 模式：**
```bash
dotnet watch run --project AutoDevBotApp.Web.Entry
```

### 构建

**前端构建：**
```bash
cd web
npm run build        # 类型检查 + 生产构建
npm run preview      # 预览生产构建
```

**后端构建：**
```bash
cd AutoDevBotApp
dotnet build AutoDevBotApp.slnx -m:1 -v minimal
```

> ⚠️ **重要：** 构建后端时必须使用 `.slnx` 解决方案文件。如果构建失败，确保 Visual Studio 或其他 IDE 已关闭。

### 验证

**前端类型检查：**
```bash
cd web
npm run type-check
```

**工作区完整验证：**
```bash
pwsh -File .\scripts\check-workspace.ps1
```

---

## 📚 文档导航

**📖 快速入口：** [doc/README.md](doc/README.md) 或 [doc/00-索引/文档索引.md](doc/00-索引/文档索引.md)

### 文档分类

| 分类 | 说明 | 链接 |
|------|------|------|
| 📏 **规范** | 代码规范、Git 工作流、API 设计 | [doc/01-规范/](doc/01-规范/) |
| 🏗️ **架构** | 后端分层、前端组织、架构设计 | [doc/02-架构/](doc/02-架构/) |
| 🤝 **协作** | AI 协作、任务执行、沟通机制 | [doc/03-协作/](doc/03-协作/) |
| 💻 **开发** | 开发指南、质量基线、参考项目 | [doc/04-开发/](doc/04-开发/) |
| 🎯 **决策** | 架构决策记录（ADR） | [doc/05-决策/ADR/](doc/05-决策/ADR/) |

### 新人入门路径

1. 📖 本文档 - 了解项目定位和技术栈
2. 🎯 [项目开发文档](doc/04-开发/项目开发文档.md) - 了解当前阶段目标
3. 🤝 [AI协作开发约定](doc/03-协作/AI协作开发约定.md) - 了解协作方式
4. 根据角色选择：
   - **后端** → [后端守则](doc/02-架构/后端守则.md)
   - **前端** → [前端注意事项](doc/02-架构/前端注意事项.md)

---

## 🎯 当前阶段

**阶段定位：** 0→1 骨架搭建阶段

**核心目标：**
- ✅ 定义平台结构和对象模型
- ✅ 建立前后端分层架构
- ✅ 完善文档和规范体系
- 🚧 实现核心工作流功能
- 🚧 打通审批和运行记录

**当前范围：**
- 平台核心骨架
- 配置域、运行域、治理域基础边界
- 支撑前端页面的核心 API

**明确不包含（暂时）：**
- 登录/注册功能
- 完整权限系统
- 多租户体系
- 复杂可视化拖拽编排

详见：[项目开发文档](doc/04-开发/项目开发文档.md)

---

## 🏛️ 核心概念

### 工作流模型
平台围绕以下核心对象展开：

**配置域：**
- WorkflowTemplate - 工作流模板
- Agent - Agent 配置
- Prompt - Prompt 模板
- Connector - 连接器定义
- Credential - 凭证配置

**执行域：**
- WorkflowRun - 工作流运行实例
- StepRun - 步骤运行记录

**治理域：**
- ApprovalTask - 审批任务
- AuditLog - 审计日志

### 典型流程

```
触发来源（飞书/TAPD）
    ↓
需求拆解与分析
    ↓
提取不确定项
    ↓
人工审核 ✋
    ↓
Agent 执行（Codex/Qoder）
    ↓
结果回传与归档
```

---

## 🛠️ 开发规范

### 后端开发
- 采用 Clean Architecture 多项目分层
- 按业务域组织（配置域、运行域、治理域）
- 严格维护层边界和依赖方向
- 新增 NuGet 包使用最新稳定版本

**必读文档：**
- [后端守则](doc/02-架构/后端守则.md)
- [后端分层蓝图](doc/02-架构/后端分层蓝图.md)
- [后端实施规范](doc/02-架构/后端实施规范.md)

### 前端开发
- 源码根目录：`web/src/`
- 视觉关键词：温暖、克制、编辑感、轻纸感
- 避免传统后台模板感

**必读文档：**
- [前端注意事项](doc/02-架构/前端注意事项.md)
- [代码规范](doc/01-规范/代码规范.md)

### 通用规范
- [代码规范](doc/01-规范/代码规范.md) - 命名、组织、注释
- [Git工作流规范](doc/01-规范/Git工作流规范.md) - 分支、提交、PR
- [API设计规范](doc/01-规范/API设计规范.md) - RESTful、响应格式
- [错误处理与日志规范](doc/01-规范/错误处理与日志规范.md) - 异常、日志

---

## 🤝 协作方式

本项目采用 AI 驱动的协作开发模式：

- **用户：** 业务目标、优先级、最终决策
- **Claude (Codex)：** 架构设计、文档沉淀、规则维护
- **Qoder：** 具体功能代码实现

**核心原则：**
- 文档先行、模型先行
- 先对齐逻辑，再写代码
- 代码服从文档，不反向挟持

详见：[AI协作开发约定](doc/03-协作/AI协作开发约定.md)

---

## 📦 参考项目

本项目参考以下项目的优点，但不直接依赖：

| 项目 | 参考点 |
|------|--------|
| **Admin.NET** | 后台项目分层、工程组织 |
| **n8n** | 工作流平台、节点编排 |
| **DeerFlow** | 渠道接入、Agent Runtime |
| **AutoDevBot** | 研发执行链路、执行器设计 |
| **QwenPaw** | 产品视觉语言和气质 |

详见：[参考项目索引](doc/04-开发/参考项目索引.md)

---

## 📋 项目结构

```
AutoDevBotApp/
├── AutoDevBotApp/           # 后端项目
│   ├── AutoDevBotApp.Web.Entry/
│   ├── AutoDevBotApp.Application/
│   ├── AutoDevBotApp.Core/
│   ├── AutoDevBotApp.Infrastructure/
│   └── AutoDevBotApp.Contracts/
├── web/                     # 前端项目
│   ├── src/
│   │   ├── api/
│   │   ├── components/
│   │   ├── views/
│   │   ├── router/
│   │   ├── stores/
│   │   └── types/
│   └── public/
├── doc/                     # 文档中心
│   ├── 00-索引/
│   ├── 01-规范/
│   ├── 02-架构/
│   ├── 03-协作/
│   ├── 04-开发/
│   └── 05-决策/
├── scripts/                 # 构建和验证脚本
├── CLAUDE.md               # Claude Code 项目指令
└── README.md               # 本文档
```

---

## 🔗 相关链接

- **API 文档：** http://localhost:7001/swagger (开发环境)
- **前端开发：** http://localhost:5173
- **文档中心：** [doc/README.md](doc/README.md)

---

## 📄 许可证

MIT License

---

## 📮 联系方式

如有问题或建议，请查看：
- [文档索引](doc/00-索引/文档索引.md) - 查找相关文档
- [沟通记录](doc/03-协作/沟通记录.md) - 查看最新讨论

---

**最后更新：** 2026-04-14