# chocolate

**Repository Path**: dataocean/chocolate

## Basic Information

- **Project Name**: chocolate
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-02
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cookie 项目

## 项目简介
Cookie 是一个多模块项目，旨在提供一套完整的工具链，包含核心功能、命令行接口、服务端和Web界面。该项目采用Monorepo结构管理，方便各模块协同开发和版本控制。

## 项目结构
```
babel-learn/
├── packages/
│   ├── cookie-core/     # 核心功能模块
│   ├── cookie-cli/      # 命令行接口模块
│   ├── cookie-server/   # 服务端模块
│   ├── cookie-web/      # Web界面模块
│   └── cookie-toolkit/  # 工具集模块，整合其他模块
├── package.json
└── README.md
```

## 模块介绍

### @cookie/core
- **功能**：提供核心功能，基于Babel实现代码解析和转换
- **主要依赖**：`@babel/core`, `@babel/parser`, `@babel/traverse`, `doctrine`
- **测试**：使用Jest进行单元测试

### @cookie/cli
- **功能**：提供命令行接口，方便用户通过终端使用Cookie的功能
- **主要依赖**：`@cookie/core`
- **使用方式**：通过`cookie`命令调用

### @cookie/server
- **功能**：提供服务端功能，处理API请求和数据逻辑
- **主要依赖**：`@cookie/core`
- **API文档**：使用OpenAPI规范定义，位于`openapi/openapi.yaml`

### @cookie/web
- **功能**：提供Web界面，基于React和Ant Design实现
- **主要依赖**：`@cookie/core`, `react`, `react-dom`, `antd`, `recharts`
- **开发工具**：Vite, Tailwind CSS, Less

### cookie-toolkit
- **功能**：整合各个模块，提供统一的入口点
- **主要依赖**：`@cookie/core`, `@cookie/server`, `@cookie/cli`

## 技术栈
- **核心技术**：Babel, React, Node.js
- **前端框架**：React 18, Ant Design 5
- **构建工具**：Vite
- **样式处理**：Tailwind CSS, Less
- **测试框架**：Jest
- **API规范**：OpenAPI 3.0

## 使用方法

### 安装依赖
```bash
npm install
```

### 开发模式
```bash
# 启动Web界面开发服务器
cd packages/cookie-web
npm run dev
```

### 构建项目
```bash
# 构建Web界面
cd packages/cookie-web
npm run build
```

### 运行命令行
```bash
# 安装项目后可直接使用
cookie [command] [options]
```

## 设计理念
1. **模块化设计**：将功能拆分为独立模块，降低耦合度
2. **可扩展性**：通过插件机制支持功能扩展
3. **用户体验**：提供友好的Web界面和命令行接口
4. **标准化**：使用OpenAPI规范定义API，提高文档质量和开发效率

## 未来规划
1. 完善插件系统
2. 增加更多代码转换功能
3. 优化Web界面交互体验
4. 提供更详细的文档和示例

## 开发文档

项目提供了详细的开发文档，位于`docs/`目录下：

### 架构设计
- [项目架构设计](docs/architecture.md) - 项目的整体架构设计
- [架构思维导图](docs/architecture-mindmap.md) - 项目架构的思维导图

### 模块文档
- [@cookie/core](docs/core/overview.md) - 核心功能模块文档
  - [插件系统设计](docs/core/plugin-system.md) - 插件系统的详细设计
  - [API文档](docs/core/api.md) - 核心模块的API文档
- [@cookie/cli](docs/cli/overview.md) - 命令行接口模块文档
  - [命令参考](docs/cli/commands.md) - CLI命令的详细参考
- [@cookie/server](docs/server/overview.md) - 服务端模块文档
  - [API文档](docs/server/api.md) - 服务端API的详细文档
- [@cookie/web](docs/web/overview.md) - Web界面模块文档
  - [组件设计](docs/web/components.md) - Web组件的详细设计
- [@cookie-toolkit](docs/toolkit/overview.md) - 工具集模块文档

### 开发指南
- [开发规范](docs/development-guide.md) - 项目的开发规范
- [部署文档](docs/deployment.md) - 项目的部署流程