# gocha

**Repository Path**: ooooinfo/gocha

## Basic Information

- **Project Name**: gocha
- **Description**: go　开发的ＣＭＳ　ＳＨＯＰ
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-12
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gocha — GoFrame 重写的 cha 全套服务

用 GoFrame v2 重写 cha（茶文化平台）的 FastAPI 功能，包含 6 个独立子项目。

## 目录结构

```
gocha/
├── goframe-api/       # GoFrame 后端 API（对应 kinit-api）端口 9300
├── goframe-web/       # GoFrame 门户 SSR（对应 kinit-web）端口 8300
├── goframe-task/      # Go 定时任务守护进程（对应 kinit-task）
├── goframe-admin/     # Vue3 管理后台前端（复制自 kinit-admin）
├── goframe-flutter/   # Flutter 移动端（复制自 kinit-flutter）
└── goframe-uni/       # uni-app 小程序端（复制自 kinit-uni）
```

## 兼容性

- **直连 chayeweb 数据库**，不改表结构（35 张 `vadmin_*` 表 + 2 张 `tools_gen_*` 代码生成表）
- **密码兼容**：Go bcrypt 验证 passlib 生成的 `$2b$` 哈希
- **JWT 兼容**：HS256，相同 SECRET_KEY，token 可互验
  - payload: `{sub: telephone, exp, is_refresh, password}`
- **Redis 共用** DB 3
- **端口隔离**：api=9300, web=8300（cha/che/mei 用 9000/8000）

## 快速启动

### goframe-api（端口 9300）
```bash
cd goframe-api
go run main.go
# 或
go build -o goframe-api && ./goframe-api
```

### goframe-web（端口 8300）
```bash
cd goframe-web
go run main.go
```

### goframe-task（守护进程）
```bash
cd goframe-task
go run main.go
```

### goframe-admin（Vue3 前端）
```bash
cd goframe-admin
npm install
npm run dev   # 开发
npm run build # 生产构建
```

## 代码生成功能

### goframe-api 中
```
GET  /vadmin/gencode/tables          # 列出数据库表（未导入的）
GET  /vadmin/gencode/table/{name}    # 获取表字段结构
GET  /vadmin/gencode/imported        # 已导入的表
POST /vadmin/gencode/import          # 导入表结构
POST /vadmin/gencode/preview/go      # 预览 Go 代码
POST /vadmin/gencode/preview/vue     # 预览 Vue 代码
POST /vadmin/gencode/preview/menu    # 预览菜单 SQL
POST /vadmin/gencode/generate/menu   # 生成菜单（写入 vadmin_auth_menu）
POST /vadmin/gencode/generate/all    # 一键生成 Go + Vue + 菜单
```

### cha/kinit-api 中
```
GET  /vadmin/gencode/tables
POST /vadmin/gencode/import
GET  /vadmin/gencode/imported
POST /vadmin/gencode/preview/{table_id}
POST /vadmin/gencode/generate/{table_id}
```

模板位于 `goframe-api/resource/template/vm/` 和 `cha/kinit-api/apps/vadmin/gencode/templates/vm/`，共 20 个模板文件。

## 数据库表

代码生成功能使用 2 张表（已在 chayeweb 创建）：
- `tools_gen_table` — 代码生成业务表
- `tools_gen_table_column` — 代码生成业务表字段

SQL 文件：`goframe-api/manifest/sql/tools_gen_table.sql`

## 技术栈

| 组件 | 技术 |
|------|------|
| Web 框架 | GoFrame v2.10.2 |
| ORM | GoFrame gdb (MySQL) |
| JWT | golang-jwt/jwt/v5 |
| 密码 | golang.org/x/crypto/bcrypt |
| 定时任务 | robfig/cron/v3 |
| Redis | go-redis/v9 |
| 前端 | Vue3 + Element Plus (goframe-admin) |