Files
monkeycode-ai 80b4718568 docs: 生成完整项目文档
创建以下文档:
- INDEX.md - 项目索引和概览
- ARCHITECTURE.md - 系统架构设计文档
- INTERFACES.md - 接口和类型定义文档
- DEVELOPER_GUIDE.md - 开发者指南

文档覆盖内容:
- 项目结构和模块说明
- 技术栈和依赖
- 核心组件设计
- API 接口定义
- 数据模型
- 开发环境配置
- 代码规范
- 测试指南
- 调试技巧
- Git 工作流
Co-authored-by: monkeycode-ai <monkeycode-ai@chaitin.com>
2026-06-03 04:17:14 +00:00

2.7 KiB
Raw Permalink Blame History

CodePlay 项目文档索引

项目概述

CodePlay 是一个代码转换工具平台,支持 C#、Java、C++ 三种编程语言之间的双向转换。平台提供 Web 界面、CLI 工具和 API 接口三种使用方式。

文档结构

文档名称 说明
ARCHITECTURE.md 系统架构设计文档
INTERFACES.md 接口和类型定义文档
DEVELOPER_GUIDE.md 开发者指南

核心模块

1. CodePlay.Core - 核心转换引擎

查看 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 服务

查看 Web 模块文档

主要功能

  • REST API 端点
  • Swagger 文档
  • 依赖注入配置

命名空间

  • CodePlay.Web.Controllers - API 控制器

3. CodePlay.CLI - 命令行工具

查看 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 个测试用例,全部通过

相关链接