# lemocoder

**Repository Path**: catmes/lemocoder

## Basic Information

- **Project Name**: lemocoder
- **Description**: go低代码工具。前端为React(umijs)，基于Ant Design框架。后端为golang的Gin框架。请先安装好go环境和前端环境(yarn)
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2022-09-26
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 简介

[![Go](https://badgen.net/badge/Go/v1.19)](https://go.dev/learn/)
[![TypeScript](https://badgen.net/badge/UI/antd)](https://ant.design/)
[![License](https://badgen.net/badge/License/MIT/green)](https://gitee.com/catmes/lemocoder)
[![Support](https://badgen.net/badge/Support/linux,win/purple?list=|)](https://gitee.com/catmes/lemocoder)

lemocoder 是一个前后端分离的中后台Web应用框架。集成开发工具, 自动生成Web项目CURD源码。
API鉴权使用 `JWT(JSON Web Tokens)` [标准规范](https://jwt.io/)。
前端使用 `Ant Design` UI，基于 `React(umijs)` 架构。后端使用Go语言 `Gin` 框架。


## 环境配置

1. 安装nodejs

前往 [https://nodejs.org/zh-cn/](https://nodejs.org/zh-cn/) 下载并安装 `node`

Linux系统可尝试命令安装: 

    sudo apt install nodejs

安装完毕后，运行 `node -v` 确认是否安装成功

2. 安装yarn

```
npm install -g yarn
yarn --version
```

设置yarn国内源: 
  
    yarn config set registry https://registry.npm.taobao.org -g

3. 安装Go语言开发环境

下载并安装Go: https://golang.google.cn/doc/install

设置GO国内代理:

```
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
```


## 快速开始

注：编译前端，可能需要清除浏览器缓存。如：`umi.js` 会直接从缓存读取，导致前端重新编译后无法生效。

```
# 加载依赖包
go mod tidy

# 初始化数据库(默认sqlite3), 生成 WebClient 客户端资源
# (cd webclient && yarn && yarn build && cd .. && mv webclient/dist/* resource/client/)
go run . init

# 编译并运行
go run .
```

服务端API接口默认地址: `http://127.0.0.1:8888`

客户端资源地址: `http://127.0.0.1:8888/client`


> 如执行 `go mod tidy` 命令出错，可能为GO版本过低或第三方包版本冲突。请升级 `Go` 或重置 `mod.go` 文件内容后再试。

`mod.go`:

```
module lemocoder

go 1.19
```


## 配置文件

复制 `env.default` 文件为 `.env`, 并更改新配置文件 `.env` 的配置项，以覆盖 `env.default` 配置文件的默认值


## 自动生成代码

程序自动生成代码文件后，无法实时生效。必须 `重新编译前后端，并同步数据表结构`

```
# 编译前端文件并拷贝至 resource/client 目录
go run . clientinit
# 同步数据表结构
go run . dbsync
# 编译后端主程序
go build .
```

重新执行主程序: `./lemocoder`(linux, mac) 或 `lemocoder.exe`(windows)


## WebServer 服务端

启动Web服务，为客户端运行提供API接口

运行参数:

- `stop`  停止web服务端
- `init`  创建 sqlite3 数据库文件，并编译Web客户端
- `dbinit`  创建数据表
- `dbsync`  同步数据表结构
- `clientinit`  编译前端文件(Web客户端)
- `-d`  启动Web服务并后台运行


编译成可执行文件后执行

```
go build .
./lemocoder init
./lemocoder
```


## WebClient 客户端

```
# 进入客户端源码目录
cd webclient
# 下载依赖包
yarn
# 开发模式启动
yarn start
# 编译前端资源包
yarn build
```

-----------------------------------------------

> antd pro组件总览: https://procomponents.ant.design/components

> antd 组件总览: https://ant.design/components/overview-cn/