# Coder-AI-Ops **Repository Path**: open_source_base/Coder-AI-Ops ## Basic Information - **Project Name**: Coder-AI-Ops - **Description**: Coder AI Ops 是一个结构化的 AI 辅助开发管理系统，旨在解决 Codex CLI 和 Claude Code 在开发流程管理上的不足。系统参考云效等项目管理平台的理念，为 AI 驱动的软件开发提供规范化、可追溯的工作流程。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: 001-core-api-system - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-10-29 - **Last Updated**: 2025-12-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Coder AI Ops ## 项目简介 Coder AI Ops 是一个结构化的 AI 辅助开发管理系统，旨在解决 Codex CLI 和 Claude Code 在开发流程管理上的不足。系统参考云效等项目管理平台的理念，为 AI 驱动的软件开发提供规范化、可追溯的工作流程。 ## 核心功能 ### 1. 开发流程编排 - 标准化的开发工作流：需求分析 → 技术设计 → 任务分解 → 实现跟踪 → 质量验证 - 支持自定义流程模板和检查点 - 流程状态可视化和进度追踪 ### 2. 任务管理与追踪 - AI 任务的创建、分配、执行和追踪 - 任务与用户故事的完整追溯链 - 支持任务优先级和依赖关系管理 - 实时任务执行状态监控 ## 技术选型 ### 后端技术栈 - **框架**: Python 3.11+ with FastAPI - **数据库**: PostgreSQL（核心业务数据） - **文件存储**: 本地文件系统（规格文档、设计文档、代码文件） - **任务队列**: Celery + Redis（异步任务处理） - **ORM**: SQLAlchemy 2.x - **数据库迁移**: Alembic（自动生成迁移脚本，版本管理） - **API文档**: OpenAPI/Swagger (FastAPI 自带) - **国际化**: Babel + gettext（i18n/l10n 支持，代码中禁止硬编码字符串） - **配置管理**: Pydantic Settings（类型安全的配置） - **日志**: structlog（结构化日志） ### 前端技术栈 - **框架**: React 18+ with TypeScript - **UI组件库**: Ant Design / Material-UI - **状态管理**: Redux Toolkit / Zustand - **构建工具**: Vite - **HTTP客户端**: Axios ### 开发工具 - **版本控制**: Git - **代码规范**: Black (Python), ESLint + Prettier (TypeScript) - **测试框架**: pytest (后端), Jest + React Testing Library (前端) - **容器化**: Docker + Docker Compose ## 项目结构 ``` coder_ai_os/ ├── backend/ # 后端服务 │ ├── src/ │ │ ├── api/ # API路由和端点 │ │ ├── models/ # 数据模型 │ │ ├── services/ # 业务逻辑 │ │ ├── core/ # 核心配置和工具 │ │ └── tasks/ # 异步任务 │ └── tests/ # 后端测试 │ ├── frontend/ # 前端应用 │ ├── src/ │ │ ├── components/ # React组件 │ │ ├── pages/ # 页面组件 │ │ ├── services/ # API调用服务 │ │ ├── store/ # 状态管理 │ │ └── types/ # TypeScript类型定义 │ └── tests/ # 前端测试 │ ├── .specify/ # Specify Kit 框架配置 │ ├── memory/ │ │ └── constitution.md # 项目宪章 │ └── templates/ # 文档模板 │ ├── specs/ # 功能规格文档 ├── docs/ # 项目文档 └── docker-compose.yml # 开发环境配置 ``` ## 核心实体 ### 项目 (Project) - 顶层组织单位，包含多个功能特性 ### 功能特性 (Feature) - 独立的功能模块，对应一个完整的开发周期 - 关联：规格文档、设计文档、任务列表 ### 用户故事 (User Story) - 功能的最小可交付单元 - 具有独立的优先级和验收标准 ### 任务 (Task) - 具体的实现步骤 - 可追溯到用户故事 - 包含执行状态、负责人（AI/人工）、依赖关系 ### 工作流 (Workflow) - 定义开发流程的各个阶段和质量门禁 - 可配置的检查点和审批规则 ## 开发流程 遵循 Specify Kit 规范化流程： 1. **需求阶段**: `/speckit.specify` - 创建功能规格 2. **设计阶段**: `/speckit.plan` - 制定实施计划 3. **任务阶段**: `/speckit.tasks` - 生成任务列表 4. **实现阶段**: `/speckit.implement` - 执行任务 5. **验证阶段**: `/speckit.analyze` - 质量检查 ## 快速开始 - docker ``` cd .\backend\ pip install -r requirements.txt # 1. 确保 Docker 运行 docker-compose up -d # 2. 运行数据库迁移 cd backend alembic upgrade head # 3. 启动 API uvicorn src.main:app --reload ``` ## 🐧 在 WSL 中运行（推荐） ### 快速启动 ```bash # 在 Windows PowerShell 中进入 WSL wsl # 进入项目目录 cd /mnt/d/Users/viaco/PycharmProjects/coder_ai_ops chmod +x scripts/*.sh # 运行无虚拟环境版本 ./scripts/start-wsl-no-venv.sh # 启动 API ./scripts/run-api-no-venv.sh # sudo apt install python3.12-venv # 一键启动（自动安装依赖、启动 Docker、运行迁移） #./scripts/start-wsl.sh # 启动 API 服务 #./scripts/run-api-wsl.sh ``` 方案 2: 移动项目到 WSL 文件系统（推荐）⭐ 这样虚拟环境就能正常工作了： 优点: 性能更好，虚拟环境正常工作，更接近标准开发环境 ```bash # 1. 运行设置脚本 chmod +x scripts/setup-in-wsl-home.sh ./scripts/setup-in-wsl-home.sh # 2. 进入新位置 cd ~/coder_ai_ops # 3. 运行原始启动脚本（支持虚拟环境） ./scripts/start-wsl.sh # 4. 启动 API ./scripts/run-api-wsl.sh ```bash ### 手动步骤 ```bash # 1. 进入 WSL wsl # 2. 进入项目 cd /mnt/d/Users/viaco/PycharmProjects/coder_ai_ops # 3. 安装依赖 cd backend python3 -m venv venv source venv/bin/activate pip install -r requirements.txt # 4. 启动 Docker 服务 cd .. docker-compose up -d # 5. 运行数据库迁移 cd backend alembic upgrade head # 6. 启动 API uvicorn src.main:app --reload --host 0.0.0.0 ``` 访问: http://localhost:8000/docs **详细文档**: [WSL 配置指南](docs/setup-wsl.md) ```bash # 克隆项目 git clone cd coder_ai_os # 启动开发环境（Docker） docker-compose up -d # 后端开发 cd backend pip install -r requirements.txt uvicorn src.main:app --reload # 前端开发 cd frontend npm install npm run dev ``` ## 设计原则 参考 `.specify/memory/constitution.md` 项目宪章： 1. **规范驱动开发**: 所有功能遵循文档→设计→实现流程 2. **独立可测试的用户故事**: 每个用户故事可独立交付 3. **文档先行**: 设计文档必须在代码实现前完成 4. **任务可追溯性**: 每个任务可追溯到用户故事和业务价值 5. **渐进式交付**: MVP优先，增量发布 ## 许可证 MIT License ## 参考资料 - 云效 DevOps 平台 - Specify Kit 开发框架 - FastAPI 官方文档 - React 官方文档