# jasmine

**Repository Path**: ABCDRD/jasmine

## Basic Information

- **Project Name**: jasmine
- **Description**: 基于AI Coding（Go+React+SQLite）的系统快速构建实践
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2026-03-13
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: AI, Go语言, React, aicoding

## README

# 茉莉

茉莉・清雅致远，简而不凡。

本项目使用 SQLite 技术栈，前端采用 Ant Design Pro 框架，后端采用 Gin + GORM 框架，实现了一个简单的用户管理系统。

## 版本记录

- **版本 0.0.4** (2026-03-15)
  - 2小时修复前端登陆问题的大坑
  - 优化日志系统，添加时间戳和文件行号
  - 修复登录状态检查逻辑
  - 移除前端alert阻塞
- **版本 0.0.3** (2026-03-15)
  - 新增 Docker Compose 部署方式
  - 优化部署脚本
  - 更新 SERVER_IP 获取逻辑
- **版本 0.0.2** (2026-03-15)
  - 新增巴巴塔单页界面
  - 添加Git分支规范文档
  - 优化项目结构
- **版本 0.0.1** (2026-03-15)
  - 技术架构造型
  - 初始化权限管理模块
  - 支持 Docker 部署

## 目录结构

```
├── backend/                # 后端 Go 代码
│   ├── app/                # 应用代码
│   │   ├── api/            # API 路由和处理器
│   │   │   ├── handlers/   # 请求处理器
│   │   │   │   └── auth/    # 权限管理相关处理器
│   │   │   ├── middleware/ # 中间件
│   │   │   └── routes.go   # 路由配置
│   │   ├── models/         # 数据模型
│   │   │   └── auth/        # 权限管理相关模型
│   │   ├── schemas/        # 请求/响应结构
│   │   └── services/       # 业务逻辑
│   │       └── auth/        # 权限管理相关服务
│   ├── config/             # 配置文件
│   ├── go.mod              # Go 模块依赖
│   ├── jasmine.db          # SQLite 数据库文件
│   └── main.go             # 后端入口文件
├── frontend/               # 前端 React 代码
│   ├── public/             # 静态资源
│   ├── src/                # 源代码
│   │   ├── api/            # API 服务
│   │   ├── components/     # 组件
│   │   ├── pages/          # 页面
│   │   │   └── auth/        # 权限管理相关页面
│   │   ├── types/          # TypeScript 类型定义
│   │   ├── utils/          # 工具函数
│   │   ├── App.tsx         # 应用主组件
│   │   ├── main.tsx        # 入口文件
│   │   └── index.css       # 全局样式
│   ├── index.html          # HTML 入口
│   ├── package.json        # 前端依赖
│   ├── tsconfig.json       # TypeScript 配置
│   ├── tsconfig.node.json  # Vite TypeScript 配置
│   └── vite.config.ts      # Vite 配置
├── README.md               # 项目说明
└── README.en.md            # 英文项目说明
```

## 技术栈

- **后端**：Go 1.23, Gin, GORM, SQLite
- **前端**：React 18, Ant Design Pro, TypeScript, Vite

## 本地环境版本

- **Go**：1.23.0
- **Node.js**：24.14.0
- **npm**：11.11.1

## 快速开始

### 后端启动

1. 进入后端目录
   ```bash
   cd backend
   ```
2. 安装依赖
   ```bash
   go mod tidy
   ```
3. 启动后端服务器
   ```bash
   go run main.go
   ```
   后端服务将在 `http://localhost:8001` 启动

### 前端启动

1. 进入前端目录
   ```bash
   cd frontend
   ```
2. 安装依赖
   ```bash
   npm install
   ```
3. 启动前端开发服务器
   ```bash
   npm run dev
   ```
   前端服务将在 `http://localhost:3000` 启动

## 功能说明

- **用户管理**：支持用户的增删改查操作
- **数据存储**：使用 SQLite 数据库存储用户数据
- **API 接口**：提供 RESTful API 接口
- **前端界面**：使用 Ant Design Pro 构建现代化的管理界面
- **巴巴塔单页**：游戏科技感风格的AI助手界面，融入《吞噬星空》元素

## Git分支规范

本项目采用以下Git分支规范：

- **master/main**：生产稳定版
- **develop**：开发集成分支
- **feature/**\*：新功能开发
- **hotfix/**\*：紧急修复
- **release/**\*：发布准备（暂不启用）
- **tag/**\*：可发布的版本

详细分支结构和操作规范请参考 [Git分支规范文档](docs/Git分支规范.md)。

## 文档导航

### 权限模块

- [权限模块概要设计](docs/权限模块/权限模块概要设计.md)
- [权限模块详细设计](docs/权限模块/权限模块详细设计.md)
- [权限模块数据库设计](docs/权限模块/权限模块数据库设计.md)
- [权限模块接口设计](docs/权限模块/权限模块接口设计.md)
- [提示词-初始化](docs/权限模块/提示词-初始化.md)

### 部署相关

- [提示词-部署-docker.md](docs/提示词-部署-docker.md)

### 其他文档

- [总体设计规划](docs/总体设计规划.md)
- [AI生成经验](docs/AI生成经验.md)
- [SQLite配置问题处理记录](docs/SQLite配置问题处理记录.md)
- [权限设计](docs/权限设计.md)
- [Git分支规范](docs/Git分支规范.md)
- [提示词-巴巴塔站点](docs/提示词-巴巴塔站点.md)

## 开发工具

- **VS Code**：代码编辑器
- **TraeCn**：AI 代码生成和理解工具

## 注意事项

- 本项目使用 SQLite 数据库，数据文件将自动生成在 `backend/db/development.db`
- 前端通过代理配置将 API 请求转发到后端服务器
- 项目采用模块化设计，便于扩展和维护