# ai-move-app

**Repository Path**: ai-code_4/ai-move-app

## Basic Information

- **Project Name**: ai-move-app
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-02
- **Last Updated**: 2026-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Move App

AI Move App 是一个基于 Laravel 12 的双端应用，当前包含两个独立的产品面：

- `admin`：管理后台，负责用户、角色、菜单、字典、系统配置、AI Provider 配置等平台管理能力。
- `home`：前台工作台，当前重点是成员注册、登录、手机验证码验证、Workspace 页面骨架和一套可复用的 Home UI 组件系统。

当前仓库已经不再适用旧的“漫剧产品方案文档”描述，本文档以现有代码结构和可运行方式为准。

## 技术栈

### Backend

- PHP 8.2
- Laravel 12
- Laravel Sanctum 4
- MySQL
- PHPUnit 11
- Laravel Pint

### Home Frontend

- Vue 3
- Vite 7
- Tailwind CSS 4
- Headless UI Vue
- 入口：`resources/home/app.js`
- Blade 壳：`resources/views/home.blade.php`

### Admin Frontend

- Vue 3
- Vue CLI
- View UI Plus
- Vue Router 4
- Axios
- Less
- 入口：`resources/vue/src/`
- Blade 壳：`resources/views/admin.blade.php`

## 当前项目结构

```text
app/
├── Ai/                    # 共享 AI 运行时与驱动
├── Http/
│   ├── Controllers/
│   │   ├── Admin/        # Admin 控制器
│   │   └── Home/         # Home 控制器
│   └── Requests/
├── Models/               # 共享 Eloquent 模型
├── Repositories/         # 原子数据访问
├── Search/               # 查询过滤封装
└── Services/             # 业务编排服务

resources/
├── home/                 # Home 前端应用（Vite + Vue）
└── vue/                  # Admin 前端应用（Vue CLI）

routes/
├── web.php               # 浏览器入口页
├── api.php               # 当前 Home API
└── admin.php             # Admin API
```

## 访问入口

### Browser Shells

- `/admin/{any?}` -> `resources/views/admin.blade.php`
- `/login` -> `resources/views/home.blade.php`
- `/register` -> `resources/views/home.blade.php`
- `/phone/verify` -> `resources/views/home.blade.php`
- `/workspace/{any?}` -> `resources/views/home.blade.php`
- `/home` 会重定向到 `/workspace/demo/dashboard`

### Home Routes

Home 前端当前主要路由在 `resources/home/router/index.js`：

- `/`
- `/login`
- `/register`
- `/phone/verify`
- `/workspace/:workspaceId/dashboard`

当前 `Dashboard` 已被改造成 Home 组件展示示例页，用于演示 `resources/home/components` 下的可复用组件。

### API Routes

#### Admin API

挂载前缀：`/api/admin/*`

当前主要包括：

- 登录、验证码、重置密码
- 用户 / 角色 / 菜单 / 权限管理
- 字典管理
- 系统配置管理
- AI Provider 管理
- 个人资料与操作日志

#### Home API

当前实际定义在 `routes/api.php`，前缀为 `/api/home/*`：

- `POST /api/home/login`
- `POST /api/home/register`
- `POST /api/home/phone/verify-code`
- `POST /api/home/phone/resend-code`
- `GET /api/home/me`
- `POST /api/home/logout`

当前 Home 注册流程为单页流程：

1. 先发送手机验证码
2. 用户填写注册信息和验证码
3. 注册请求一次性提交到后端

## 安装

### 1. Backend + Home Frontend

```bash
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm install
```

如果只开发 Home，以上步骤已经足够。

### 2. Admin Frontend 依赖

Admin 使用独立的前端工程目录，需要单独安装依赖：

```bash
cd resources/vue
npm install
```

## 开发

### 一键启动主开发环境

```bash
composer run dev
```

该命令会并行启动：

- Laravel 开发服务器
- `queue:listen`
- `pail`
- 根目录 Vite（Home 前端）

### 单独启动 Home 前端

```bash
npm run dev
```

### 构建 Home 前端

```bash
npm run build
```

### 启动 / 构建 Admin 前端

```bash
cd resources/vue
npm run serve
```

```bash
cd resources/vue
npm run build
```

## 测试与代码质量

### 运行测试

```bash
composer test
```

或：

```bash
php artisan test --compact
```

当前仓库里已经有针对以下能力的测试：

- Home 成员认证
- Home 已移除的短剧相关路由可用性检查
- AI Manager
- Model Provider 管理

### 代码格式化

如果修改了 PHP 文件，运行：

```bash
vendor/bin/pint --dirty --format agent
```

## Home 前端现状

`resources/home/` 当前已经包含一套可复用组件体系，主要包括：

- 基础布局：`UiContent`、`UiCard`、`UiDetail`
- 表单输入：`UiForm`、`UiFormItem`、`UiTextInput`、`UiTextarea`、`UiListbox`
- 弹层与交互：`UiDialog`、`UiDrawer`、`UiMenu`、`UiTooltip`
- 数据展示：`UiTable`、`UiBadge`、`UiDescriptionList`、`UiEllipsis`
- 反馈：`Notice`
- Markdown 编辑：`UiMarkdownEditor`

组件列表文档位于：

```text
resources/home/components/components.md
```

根据当前项目约定：

- 修改 `resources/home/views` 页面前，先查这个组件列表文档
- 新增 `resources/home/components` 下的组件后，必须同步更新该文档

## 相关约定

- 顶层协作规则见 `AGENTS.md`
- `resources/home/AGENTS.md` 约束 Home 页面与组件开发方式
- `admin` 与 `home` 需要保持清晰边界，不应直接互相引用前端实现
- 当前 Home API 虽然目标上应独立拆到 `routes/home.php`，但现状仍定义在 `routes/api.php`

## 常用命令

```bash
# 安装后端依赖
composer install

# 安装 Home 前端依赖
npm install

# 安装 Admin 前端依赖
cd resources/vue && npm install

# 启动主开发环境
composer run dev

# 构建 Home
npm run build

# 运行测试
php artisan test --compact

# 格式化 PHP
vendor/bin/pint --dirty --format agent
```