80b4718568
创建以下文档: - INDEX.md - 项目索引和概览 - ARCHITECTURE.md - 系统架构设计文档 - INTERFACES.md - 接口和类型定义文档 - DEVELOPER_GUIDE.md - 开发者指南 文档覆盖内容: - 项目结构和模块说明 - 技术栈和依赖 - 核心组件设计 - API 接口定义 - 数据模型 - 开发环境配置 - 代码规范 - 测试指南 - 调试技巧 - Git 工作流 Co-authored-by: monkeycode-ai <monkeycode-ai@chaitin.com>
2.7 KiB
2.7 KiB
CodePlay 项目文档索引
项目概述
CodePlay 是一个代码转换工具平台,支持 C#、Java、C++ 三种编程语言之间的双向转换。平台提供 Web 界面、CLI 工具和 API 接口三种使用方式。
文档结构
| 文档名称 | 说明 |
|---|---|
| ARCHITECTURE.md | 系统架构设计文档 |
| INTERFACES.md | 接口和类型定义文档 |
| DEVELOPER_GUIDE.md | 开发者指南 |
核心模块
1. CodePlay.Core - 核心转换引擎
主要功能:
- 代码解析(Parser)
- 代码转换(Converter)
- 代码生成(Generator)
- 编译验证(Validator)
命名空间:
CodePlay.Core.Common- 公共类型和枚举CodePlay.Core.Models- 数据模型CodePlay.Core.Interfaces- 核心接口定义CodePlay.Core.Parsers- 语言解析器CodePlay.Core.Converters- 代码转换器CodePlay.Core.Generators- 代码生成器CodePlay.Core.Services- 服务层CodePlay.Core.Validators- 验证器
2. CodePlay.Web - Web API 服务
主要功能:
- REST API 端点
- Swagger 文档
- 依赖注入配置
命名空间:
CodePlay.Web.Controllers- API 控制器
3. CodePlay.CLI - 命令行工具
主要功能:
- 命令行参数解析
- 批量文件转换
- 配置管理
命名空间:
CodePlay.CLI.Commands- 命令定义CodePlay.CLI.Services- CLI 服务
4. CodePlay.Tests - 测试项目
主要功能:
- 单元测试(xUnit)
- 集成测试
- 测试用例库
命名空间:
CodePlay.Tests.Parsers- 解析器测试CodePlay.Tests.Converters- 转换器测试
快速开始
构建项目
dotnet build CodePlay.sln
运行测试
dotnet test CodePlay.Tests/CodePlay.Tests.csproj
启动 Web API
dotnet run --project CodePlay.Web/CodePlay.Web.csproj
支持的转换
| 源语言 | 目标语言 | 状态 |
|---|---|---|
| C# | Java | ✅ 已实现 |
| Java | C# | 🔄 计划中 |
| C# | C++ | 🔄 计划中 |
| C++ | C# | 🔄 计划中 |
| Java | C++ | 🔄 计划中 |
| C++ | Java | 🔄 计划中 |
项目状态
- 当前版本: 0.1.0-alpha
- 开发阶段: MVP 开发中
- 测试覆盖率: 13 个测试用例,全部通过