# ai项目基座

**Repository Path**: cooljun/ai_project_base

## Basic Information

- **Project Name**: ai项目基座
- **Description**: ai_project_base
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-03-25
- **Last Updated**: 2026-03-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目基座 (Project Base)

通用项目基座，包含完整的多端架构和开箱即用的通用功能，可供后续项目 fork 使用。

## 技术栈

| 端 | 技术 | 目录 |
|---|------|------|
| PHP 后端 | ThinkPHP 6.1 + PHP 7.4 | [03-backend](./03-backend) |
| Vue 管理端 | Vue 3.5 + Ant Design Vue 4.2 + Vite | [04-admin](./04-admin) |
| 微信小程序 | uni-app 3.0 + Vue 3.4 | [05-wx-miniapp](./05-wx-miniapp) |
| 抖音小程序 | uni-app 3.0 + Vue 3.4 | [06-dy-miniapp](./06-dy-miniapp) |
| Go 微服务 | Go 1.24 + net/http | [07-go-backend](./07-go-backend) |
| API 测试 | Node.js + axios | [08-api-tests](./08-api-tests) |
| API 文档 | OpenAPI 3.0 | [09-apidoc](./09-apidoc) |

## 目录结构

```
ai_project_base/
├── CLAUDE.md                    # 项目编码规范
├── AGENTS.md                    # AI 编码指南
├── 01-tasks/                    # 任务文档
├── 02-models/                   # 数据库模型设计
│   ├── full.sql                 # 全量建表脚本
│   └── tables/                  # 表结构说明
├── 03-backend/                  # PHP 后端
├── 04-admin/                    # Vue 管理端
├── 05-wx-miniapp/               # 微信小程序
├── 06-dy-miniapp/               # 抖音小程序
├── 07-go-backend/               # Go 微服务
├── 08-api-tests/                # API 测试套件
└── 09-apidoc/                   # API 文档
```

## 功能模块

- **用户权限管理** - 基于 RBAC 模型（管理员 → 角色 → 权限）
- **文件上传与存储** - 阿里云 OSS 支持
- **字典与配置管理** - 系统参数配置、字典数据管理
- **日志审计** - 操作日志、登录日志

## 快速开始

### 1. 克隆项目

```bash
git clone <your-repo-url>
cd ai_project_base
```

### 2. 数据库初始化

```sql
-- 导入数据库
mysql -u root -p your_database < 02-models/full.sql
```

默认管理员：`admin` / `admin123`

### 3. PHP 后端

```bash
cd 03-backend
cp .env.example .env
composer install
php think run
# 访问 http://localhost:8000
```

### 4. Vue 管理端

```bash
cd 04-admin
pnpm install
pnpm dev
# 访问 http://localhost:5173
```

### 5. 微信小程序

```bash
cd 05-wx-miniapp
pnpm install
# 修改 src/manifest.json 中的 appid
pnpm dev:mp-weixin
# 使用微信开发者工具打开 dist/dev/mp-weixin
```

### 6. Go 微服务

```bash
cd 07-go-backend
go mod tidy
go run .
# 服务运行在 :9090
```

## 环境配置

各端环境配置文件：

| 端 | 开发环境 | 生产环境 |
|---|---------|---------|
| PHP 后端 | `.env` | `.env` |
| Vue 管理端 | `.env.development` | `.env.production` |
| 微信小程序 | `.env.development` | `.env.production` |
| 抖音小程序 | `.env.development` | `.env.production` |

## API 测试

```bash
cd 08-api-tests
pnpm install
pnpm test           # 运行所有测试
pnpm test:php       # 只测试 PHP 接口
pnpm test:go        # 只测试 Go 接口
pnpm report         # 生成测试报告
```

## 数据库表

| 表名 | 说明 |
|------|------|
| `base_admin` | 管理员 |
| `base_role` | 角色 |
| `base_permission` | 权限/菜单 |
| `base_role_permission` | 角色权限关联 |
| `base_admin_role` | 管理员角色关联 |
| `base_dict_type` | 字典类型 |
| `base_dict_data` | 字典数据 |
| `base_config` | 系统配置 |
| `base_operation_log` | 操作日志 |
| `base_login_log` | 登录日志 |
| `base_file` | 文件记录 |

## 开发规范

详见 [CLAUDE.md](./CLAUDE.md)

- **命名规范**：PHP/Vue/Go 各有约定
- **API 规范**：响应格式 `{ code: 200, message: '', data: {} }`
- **Git 规范**：`type(scope): message` 格式

## License

MIT