📖Quick start in local server/在本地搭建服务器使用
❌ Do not modify the master branch directly! Committing directly to the master branch will not trigger automatic deployment of code for CI/CD.
⭕️ Please create a new branch first and develop on the new branch. When development is complete, initiate a Pull Request to merge that branch onto the master branch.
❌ 请勿直接修改主分支！直接向主分支提交(commit)将不会触发持续集成自动部署代码。
⭕️ 请先新建一个分支，并在新建的分支上进行开发。开发完成后，发起 Pull Request 将该分支合并到主分支上。
cbdb-online-query-app/
├── README.md
├── dataProcessing #Save codes and output of data processing. This directory is just for archive and has nothing to do with other parts.
│ ├── Office_type_tree.xlsx
│ ├── office.json
│ ├── officeData.json
│ └── position_json.py
└── src #Core source code of this project.
├── cbdbweb #Backend
├── db.sqlite3
├── dockerfile
├── frontend # Frontend
├── manage.py #django dev-server entrance. See Backend > Running the server
└── requirements.txt
3.6.x
Django ==3.0.8
djangorestframework ==3.11.0
mysqlclient ==2.0.1
gunicorn==20.0.4
Please install above packages before running the server.
cbdbweb/
├── __init__.py
├── asgi.py
├── settings.py
├── urls.py
└── wsgi.py
cd src
py manage.py runserver
cd src
python manage.py runserver
frontend/
├── build #Settings for using webpack to bundle the project
│ ├── build.js
│ ├── check-versions.js
│ ├── logo.png
│ ├── utils.js
│ ├── vue-loader.conf.js
│ ├── webpack.base.conf.js
│ ├── webpack.dev.conf.js
│ └── webpack.prod.conf.js
├── config
│ ├── dev.env.js
│ ├── index.js
│ └── prod.env.js
├── index.html
├── package-lock.json
├── package.json
├── postcss.config.js
├── src #Vue Project
│ ├── App.vue
│ ├── assets #Save resources like images, etc.
│ ├── components #Save Vue components
│ ├── main.js
│ ├── router #Vue router
│ └── store #Vuex
└── static
# go to the directory of FE first
cd src/frontend
# install dependencies
npm install
# equivalent to: npm run dev
npm start
# go to the directory of FE first
cd src/frontend
# install dependencies
npm install
# install vue client globally. If it has already installed, skip this step.
npm install -g @vue/cli
# Formatting code
npm run lint
#install dependencies
npm install
#server with hot reload at localhost:8080
npm run dev
#build for production with minification
npm run build
#build for production and view the bundle analyzer report
npm run build --report
For a detailed explain on how things work, check out the guide and docs for vue-loader.
用于展示各种查询的结果
currentPage:Number当前展示的页面，默认1startIdx:Number从第几条记录开始向API请求结果，默认0offset:Number每页展示多少条记录，默认100isLoading:Bool是否正在加载，默认falseselected:Array<Object>选中的记录
onRowSelected(item,index,event)当一条记录被点击时触发，将被选中的记录加入selected中selectAllRows()选中所有的记录clearSelected()清除选中的所有记录exportData()对于选中的记录，生成导出文件，并下载到本地
用于查询入仕途径，并将其传递到父组件中
result:Object用于维护查询结果。有下列成员：query:String查询式的主体部分，用于向API发送请求start:结果开始笔数，用于向API发送请求end:结果结束笔数，用于向API发送请求total:总共有多少笔结果，，用于向API发送请求
formData:Object用于记录检索参数，生成查询式。有下列成员：eName:String入仕途径名accurate:Number是否采用精确匹配，是=1，否=0。
- 📝关于上述两个成员，请参考 API文档 以获得更多资讯。
treeDataSource:Object可折叠树状UI的数据，以json格式保存。（未来计划改成异步加载，提高页面渲染效率）fields:Array<Object>用于维护表格中的列名及是否可选等属性items:Array<Object>用于维护表格中API返回的结果记录selectedEntry:Array<Object>用于维护选中的记录- 📝关于上述两个成员，请参考 BootstrapVue文档 以获得更多资讯。
close()点选关闭按钮时执行，清空selectedEntry关闭当前组件selectAllRows()🔗参见此处clearSelected()🔗参见此处onRowSelected(items)当一条记录被点击时触发，将被选中的记录加入selectedEntry中onClearTable()清空结果记录haveSelected()当点击“选择”按钮时执行，将选中的结果同步到父组件，清空selectedEntry关闭当前组件handlerExpand(m:{Id:String, isExpand:Bool})当树状UI点击时触发，切换类目的展开/收起。m为被点击的类目。m.Id为类目的Id，用于 API 查询等。handleTableScroll()处理滚动加载，划到底层时向 API 继续请求结果find()用于按关键词查询入仕途径。
show 当变量 show:Bool 的值为 true 时，监听键鼠滚动。
WIP
Thanks goes to these wonderful people (emoji key):
 Łøçꝁë Tân 🎨 💻 📖 🤔 |
 CasewardBen 💻 🔣 |
 IceCodeNew 💻 🚇 🚧 |
 zhangliyuan2013 💻 |
 yuetieqi-meow 💻 |
This project follows the all-contributors specification. Contributions of any kind welcome!