质量管理平台前后端分离架构 v0.1

前端(MVC)

• MVC:angular v4 angular cn
• UI:Material, Bootstrap
• 前端打包:Node.js, 推荐nvm, 文档
• 包管理:推荐yarn, 文档

后端(Restful)

• 开发语言:Python v3.6.3 下载 文档
• Restful框架:flask 文档1 文档2
• 代理服务器:nginx,推荐phpstudy 下载 文档
• 接口测试:Postman,开发完成的接口使用Postman进行功能测试 下载 文档

数据库

• MariaDB 下载 文档

API Requirements

• flask-jwt-extended:Flask JWT 扩展
• PyMySQL:MariaDB Python Client
• marshmallow:数据字段验证
• passlib:密码哈希算法库

开发部署

Windows开发环境搭建

0. 安装 git, Python, nvm& yarn, Nginx, MariaDB, Postman
1. 数据库配置
   • 创建pms用户
   • 初始化pms数据库
2. 克隆仓库

   git clone https://github.com/DXCChina/pms.git
   cd pms

3. 启动
   • 添加环境变量:

   # example
   PY_ENV:dev
   PY_DB_NAME:pms
   PY_DB_HOST:localhost
   PY_DB_USERNAME:pms
   PY_DB_PASSWORD:pms
   JWT_SECRET_KEY:pms
   

   • 一键启动:run
   • 启动前端:app\run
   • 启动后端:api\run
4. nginx配置

   #负载均衡服务器列表
   upstream backend {
       #权值越高被分配到的机率越大
       server 127.0.0.1:5000  weight=1;
   }
   server {
       listen       81;
       server_name  localhost;
       proxy_connect_timeout 10;
       proxy_read_timeout 150;
       proxy_send_timeout 15;
       location /api {
           proxy_pass http://backend;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       }
       location / {
           proxy_pass http://localhost:4200;
       }
   }
   

5. 测试地址
   • 代理:http://localhost:81, http://localhost:81/api
   • APP:http://localhost:4200
   • API:http://localhost:5000/api
6. 问题解决
   • pip install报编码错误:
     • 修改字符编码为utf-8:chcp 65001
     • 修改字符编码为gbk:chcp 936
   • 安装依赖:
     • 前端:cd app&&yarn&&cd ..||cd ..
     • 后端:pip install -r api/requirements.txt

发布前端

cd app
yarn build:prod:aot # 生成的 dist 目录上传到生产环境 nginx 静态资源路径

CentOS7生产环境部署

测试

• python 单元测试
• flask 接口测试
• angular 单元测试
• angular E2E测试