# micro-carving-coder

**Repository Path**: OlinOnee/micro-carving-coder

## Basic Information

- **Project Name**: micro-carving-coder
- **Description**: 基于模板引擎微雕代码生成器（Micro-carving Code Generation via Template Engine）
- **Primary Language**: Java
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-11
- **Last Updated**: 2025-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# micro-carving-coder

## 介绍

基于模板引擎微雕代码生成器。是一款基于 **精细化模板雕刻**
的智能代码生成引擎。它将代码生成过程视为“微观雕刻艺术”，通过动态解析用户输入的元数据（如数据库表结构、业务规则），结合高度灵活的模板引擎（如
FreeMarker），精准生成可定制化的代码文件。核心目标是通过 **原子级代码雕刻** 取代重复劳动，让开发者聚焦业务逻辑创新，提升研发效能与代码质量。

## **核心价值**

- **精细化雕刻**：通过模板变量控制字段级代码细节，实现高度定制化生成
- **元数据驱动**：支持数据库结构、业务规则等元数据动态解析
- **零重复劳动**：自动生成 70%+ 基础代码（如 CRUD、API 层），释放创新精力
- **工业级质量**：标准化模板输出符合主流编码规范（如 Alibaba Java Guidelines）  

## 项目目录结构

```bash
micro-carving-coder
├── codegen-parent/              # Maven父项目
│   ├── pom.xml
│   ├── codegen-core/            # 核心模块(阶段一)
│   │   ├── pom.xml
│   │   └── src/
│   │       ├── main/
│   │       │   ├── java/com/olinonee/framework/codegen/
│   │       │   │   ├── core/
│   │       │   │   │   ├── generator/   # 生成器实现
│   │       │   │   │   ├── model/       # 配置模型
│   │       │   │   │   ├── template/    # 模板引擎
│   │       │   │   │   └── util/        # 工具类
│   │       │   │   ├── metadata/        # 元数据读取
│   │       │   │   └── exception/       # 异常处理
│   │       │   └── resources/
│   │       │       ├── templates/       # 模板文件
│   │       │       │   ├── backend/
│   │       │       │   │   ├── springboot2/
│   │       │       │   │   └── springboot3/
│   │       │       │   └── frontend/
│   │       │       │       ├── vue2/
│   │       │       │       └── vue3/
│   │       │       └── application.yml
│   │       └── test/                   # 单元测试
│   │
│   ├── codegen-web/             # 可视化前端模块(阶段二)
│   │   ├── pom.xml
│   │   └── src/
│   │       └── main/
│   │           ├── frontend/    # Vue3+TS前端代码
│   │           │   ├── public/
│   │           │   ├── src/
│   │           │   │   ├── api/
│   │           │   │   ├── assets/
│   │           │   │   ├── components/
│   │           │   │   ├── router/
│   │           │   │   ├── store/
│   │           │   │   ├── views/      # 页面
│   │           │   │   │   ├── ProjectConfig.vue
│   │           │   │   │   ├── DataSource.vue
│   │           │   │   │   ├── TableSelect.vue
│   │           │   │   │   └── CodePreview.vue
│   │           │   │   ├── App.vue
│   │           │   │   └── main.ts
│   │           │   ├── package.json
│   │           │   ├── tsconfig.json
│   │           │   └── vite.config.ts
│   │           └── resources/          # 可放置静态资源
│   │
│   ├── codegen-admin/             # 主应用模块(阶段二整合)
│   │   ├── pom.xml
│   │   └── src/
│   │       ├── main/
│   │       │   ├── java/com/olinonee/framework/codegen/admin/
│   │       │   │   ├── config/         # 配置类
│   │       │   │   ├── controller/     # 控制器
│   │       │   │   ├── service/        # 服务层
│   │       │   │   └── CodeGenAdminApplication.java
│   │       │   └── resources/
│   │       │       ├── application.yml
│   │       │       └── static/         # 前端构建产物
│   │       └── test/
│   │
│   └── codegen-cli/             # 命令行模块(阶段三)
│       ├── pom.xml
│       └── src/
│           └── main/
│               ├── java/com/olinonee/framework/codegen/cli/
│               │   ├── command/        # Shell命令
│               │   └── CodeGenCliApplication.java
│               └── resources/
│                   └── application.yml
│
├── generated-projects/          # 生成的示例项目(测试用)
│
├── scripts/                     # 部署脚本
├── docs/                        # 文档
└── README.md
```

## 开源协议

1. [GPL 3.0(GNU General Public License Version 3)](https://www.gnu.org/licenses/gpl-3.0.txt)，GNU通⽤公共许可协议。GNU官⽅的定义：GNU is
   Not Unix
2. GPL 3.0协议第4条、第5条的规定，只要后续版本中有使⽤先前开源版本中的源代码，并且先前版本使⽤了GPL 3.0协议，则后续版本也必然受GPL 3.0协议的约束。
3. GPL 3.0协议并未限制⽤户进⾏商⽤，只是必须遵守开源的规定。GPL的精髓就是开源，和是否商⽤，是否收费完全没有关系。
4. GPL 其实从字⾯上就可以理解为公共许可证，也就是说遵循GPL的软件是公共的，其实不存在什么版权问题，或者说公众都有版权，GPL提出了和版权 （copyright）完全相反的概念（copyleft）。