fix swagger
This commit is contained in:
@@ -1,140 +1,5 @@
|
||||
# 三角洲机构 - TRPG跑团在线工具
|
||||
# Vue 3 + Vite
|
||||
|
||||
基于Vue3 + Ant Design Vue构建的TRPG跑团在线工具网站，遵循TRTC三角洲机构规则。
|
||||
|
||||
## 功能特性
|
||||
|
||||
### 用户系统
|
||||
- 用户注册/登录（账号、密码、姓名）
|
||||
- 用户信息管理
|
||||
|
||||
### 房间系统
|
||||
- 创建房间，房间号可分享
|
||||
- 加入房间（通过房间号）
|
||||
- 房间内角色：主持人（Host）和玩家（PL）
|
||||
- 房间信息展示
|
||||
|
||||
### 骰子系统
|
||||
- 支持常见骰子：D3、D4、D6、D12、D20
|
||||
- 玩家初始投掷：4个D4
|
||||
- **混沌值机制**：
|
||||
- 每个不是3的D4给主持人加1点混沌值
|
||||
- 玩家投出3个3（可通过消耗属性值达到）不会产生混沌值
|
||||
- 每个不是3的骰子都会变成混沌值
|
||||
- 混沌值所有人可见
|
||||
- 主持人可以消耗混沌值
|
||||
- 投掷历史记录
|
||||
|
||||
### 总部/分部管理系统
|
||||
- 创建分部
|
||||
- 解散分部
|
||||
- 发布招聘信息（经理权限）
|
||||
- 查看招聘信息（所有分部成员）
|
||||
- 分部信息管理（散一端、天气系统）
|
||||
|
||||
### 异常管理系统
|
||||
- 添加异常（名称、类型、特殊能力、焦点、领域）
|
||||
- 异常收容
|
||||
- 异常解决
|
||||
- 异常分类：未收容、已收容、已解决
|
||||
- 天气系统设置
|
||||
- 散一端管理
|
||||
|
||||
## 技术栈
|
||||
|
||||
- Vue 3 (Composition API)
|
||||
- Ant Design Vue 4.x
|
||||
- Vue Router 4
|
||||
- Pinia (状态管理)
|
||||
- Vite (构建工具)
|
||||
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
src/
|
||||
├── views/ # 页面组件
|
||||
│ ├── Login.vue # 登录页
|
||||
│ ├── Register.vue # 注册页
|
||||
│ ├── Home.vue # 主页
|
||||
│ ├── Room.vue # 房间页
|
||||
│ ├── Organization.vue # 总部/分部管理
|
||||
│ └── Anomaly.vue # 异常管理
|
||||
├── stores/ # Pinia状态管理
|
||||
│ ├── user.js # 用户状态
|
||||
│ ├── room.js # 房间状态
|
||||
│ ├── organization.js # 组织状态
|
||||
│ └── anomaly.js # 异常状态
|
||||
├── router/ # 路由配置
|
||||
├── utils/ # 工具函数
|
||||
└── main.js # 入口文件
|
||||
```
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 安装依赖
|
||||
|
||||
```bash
|
||||
npm install
|
||||
```
|
||||
|
||||
### 开发运行
|
||||
|
||||
```bash
|
||||
npm run dev
|
||||
```
|
||||
|
||||
访问 http://localhost:3000
|
||||
|
||||
### 构建生产版本
|
||||
|
||||
```bash
|
||||
npm run build
|
||||
```
|
||||
|
||||
## 使用说明
|
||||
|
||||
### 1. 注册/登录
|
||||
- 首次使用需要注册账号（账号、密码、姓名）
|
||||
- 注册成功后自动登录
|
||||
|
||||
### 2. 创建/加入房间
|
||||
- 在主页可以创建新房间或通过房间号加入现有房间
|
||||
- 创建房间后自动成为主持人
|
||||
- 房间号可以分享给其他玩家
|
||||
|
||||
### 3. 使用骰子系统
|
||||
- **玩家初始投掷**：进入房间后，玩家可以投掷4个D4
|
||||
- **混沌值规则**：
|
||||
- 如果投出的4个D4中，3的数量少于3个，会产生混沌值
|
||||
- 玩家可以通过消耗属性值来增加3的数量
|
||||
- 如果最终达到3个3，则不会产生混沌值
|
||||
- 每个不是3的D4会产生1点混沌值
|
||||
- **普通投掷**：可以选择D3/D4/D6/D12/D20进行投掷
|
||||
- **消耗混沌值**：只有主持人可以消耗混沌值
|
||||
|
||||
### 4. 总部/分部管理
|
||||
- 经理可以创建分部、发布招聘信息
|
||||
- 所有成员可以查看招聘信息
|
||||
- 每个分部可以设置天气和散一端
|
||||
|
||||
### 5. 异常管理
|
||||
- 添加异常时需要填写：名称、类型、特殊能力、焦点、领域
|
||||
- 异常类型：实体、概念、地点、现象
|
||||
- 异常领域：现实、记忆、时间、空间、生命、死亡、知识、情感
|
||||
- 异常状态流转：未收容 → 已收容 → 已解决
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 当前版本使用localStorage进行数据存储（纯前端）
|
||||
- 刷新页面后数据会保留
|
||||
- 如需后端支持，需要对接相应的API接口
|
||||
|
||||
## 开发计划
|
||||
|
||||
- [ ] WebSocket实时通信
|
||||
- [ ] 后端API集成
|
||||
- [ ] 数据持久化
|
||||
- [ ] 更多骰子类型和规则
|
||||
- [ ] 角色属性管理
|
||||
- [ ] 跑团记录导出
|
||||
This template should help get you started developing with Vue 3 in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.
|
||||
|
||||
Learn more about IDE Support for Vue in the [Vue Docs Scaling up Guide](https://vuejs.org/guide/scaling-up/tooling.html#ide-support).
|
||||
|
||||
Reference in New Issue
Block a user