ADD api document

This commit is contained in:
Jasder 2020-11-26 15:16:23 +08:00
parent 0f81caefdf
commit 21169b4523
2 changed files with 3682 additions and 0 deletions

3601
api_document.md Normal file

File diff suppressed because it is too large Load Diff

81
deploy.md Normal file
View File

@ -0,0 +1,81 @@
# 本地开发部署步骤
### 1. 安装依赖包
```bash
bundle install
```
### 2. 配置初始化文件
进入项目根目录执行一下命令:
```bash
cp config/configuration.yml.example config/configuration.yml
cp config/database.yml.example config/database.yml
touch config/redis.yml
touch config/elasticsearch.yml
```
### 3. 配置gitea服务(可选)
**如需要部署自己的gitea平台请参考gitea官方平台https://docs.gitea.io/zh-cn/install-from-binary/**
**因目前gitea平台api受限暂时推荐从forge平台获取gitea部署文件进行部署https://forgeplus.trustie.net/projects/6070/coders**
#### 配置gitea服务步骤
1. 部署gitea服务并注册root账户
2. 修改forge平台的 config/configuration.yml中的gitea服务指向地址
```ruby
gitea:
access_key_id: 'root'
access_key_secret: 'password'
domain: 'http://www.gitea.example.com'
base_url: '/api/v1'
```
### 4. 安装redis环境
**请自行搜索各平台如何安装部署redis环境**
### 5. 创建数据库
```bash
rails db:create
```
### 6. 导入数据表结构
```bash
bundle exec rake sync_table_structure:import_csv
```
### 7. 执行migrate迁移文件
**开发环境为development 生成环境为production**
```bash
rails db:migrate RAILS_ENV=development
```
### 8. 启动redis(此处已mac系统为例)
```bash
redis-server&
```
### 9. 启动sidekiq
**开发环境为development 生成环境为production**
```bash
bundle exec sidekiq -C config/sidekiq.yml -e production -d
```
### 10. 启动rails服务
```bash
rails s
```
### 11. 浏览器访问
在浏览器中输入如下地址访问:
```bash
http://localhost:3000/
```
---