平安云｜公有云  

## 新建文件 config.js
`
module.exports = {
  api: {
    // 对应后台地址
    pay: 'http://portal-test.paic.com.cn:8080/api',
    sourceMap: true,
  },
  port: 8002, // 访问端口
  webpack: {
    bundleAnalyzer: true,
    sourceMap: true,
  },
`

----
>公有云项目的前端是基于 [payJs](http://10.20.23.152:8000) 构建的。

- 在技术选型上，我们考虑到整体项目的复杂和高迭代性，提出前后端分离的开发模式，这样可以让后端专注于开发高效的 API，前端专注于 UI 和用户体验。
- 我们采用 `webpack` 作为代码打包工具，实现模块化开发，可维护性增强。
- 我们采用 `react` 作为核心js库，利用 `react` 开发的 `component` 让我们整个项目组件化，搭建一套复杂的业务系统就像搭积木一样简单。
- 在设计上我们借鉴了 Google 的 Material Design 的设计风格，同时融合内部风格，推出 PayUI
- 以下是我们项目的技术栈：
  - 打包工具: webpack
  - 状态管理: redux
  - 模块化开发: react@15.3.2
  - UI 组件: payui + material-ui
  - 服务器: Node.Js
  - 部署工具: pm2 
  - 开发语言规范: pay_es6_style
  - 路由管理: react-router

## Gitlab

```bash
# 用户配置
$ git config --global "user.name" "域账号"
$ git config --global "user.email" "xxx"
$ git config --global "push.default" "simple"
$ git config --global "credential.helper" "store"
$ git config --global --list

# 从 gitlab 获取 ui 组件库
git submodule add http://git-ma.paic.com.cn/PayTeam/pacloud-ui.git  src/ui/

# 从 gitlab 库获取项目代码
$ git clone http://git-ma.paic.com.cn/PayTeam/pacloud.git

# git 基本操作
$ git branch           // 查看当前分支
$ git branch develop   //创建develop分支
$ git checkout develop //切换分支
$ git merge master    //合并某分支到当前分支
$ git branch -d develop  //删除分支
```

## 安装

```bash
$ npm install
```

1. 你得先在idesk上下载 nodejs@7.1.0 (注意：只能下载这个版本)
2. 拉取项目代码，并且配置代理地址，
```js
npm config set registry http://maven.paic.com.cn/repository/npmjs/
npm info underscore  //如果上面配置正确这个命令会有字符串response
```
3. 手动安装`node-sass`

Windows 下安装时, 由于引入了 node-sass 和 phantomjs, 需要先下载存放在 AWS 上的二进制 prebuild 文件, 可先运行:
```bash
$ set SASS_BINARY_SITE=https://npm.taobao.org/mirrors/node-sass/
$ set PHANTOMJS_CDNURL=https://npm.taobao.org/mirrors/phantomjs/
```
然后再运行 `npm install` 即可。

## window用户注意：


因为内网限制，所以在我们`npm install`之前，我们得配置一下npm的镜像源：
## npm镜像仓库
镜像使用这三种办法任意一种都能解决问题，建议使用第三种，将配置写死，下次用的时候配置还在）
`http://maven.paic.com.cn/repository/npmjs`是平安的npm镜像仓库
- 1.通过config命令
```bash
$ npm config set registry http://maven.paic.com.cn/repository/npmjs/
$ npm info underscore  //如果上面配置正确这个命令会有字符串response
```
- 2.命令行指定
```bash
$ npm --registry http://maven.paic.com.cn/repository/npmjs/ info underscore 
```
- 3.编辑 ~/.npmrc 加入下面内容
```bash
registry = http://maven.paic.com.cn/repository/npmjs/ 
```
建立或使用镜像,参考: https://github.com/cnpm/cnpmjs.org

配置完成后，启动程序即可
```bash
$ npm run start 
```

## 启动项目

- 项目的启动分为开发模式和生产模式，开发模式集成了 `webpack热模块加载` 功能, `redux-tools` 调试工具, 服务器为webpack-serve的 `source-map`。而生产模式则用于生产部署，依赖的版本库都是 `product` 版本, 代码也会被压缩混淆

### 开发模式
在终端命令行下输入, 用编辑器 VSCode 的同学可以直接用快捷键 ` ctrl + ~ ` 打开
```bash
$ npm start 
```
- 热模块加载
    - 写完代码 `ctrl+s` 保存，页面会自动刷新。打开 chrome `console` 发现有 ‘HRM’ 
- map source
    - 因为开发模式启动的是 webpack 服务器，所以在 `webpack.dev.js` 中配置
        `devtool: 'cheap-module-source-map'` 即可在 chrome/console/sources 中查看源代码，也可以直接加断点进行调试
        ![source_map](static/images/readme/source_map.png)
- redux-tools
    - 能够查看到当前页面的 state，便于利用 redux 去做状态管理。在页面按住 `ctrl+h` 即可打开，`ctrl+q` 即可切换
        ![redux_tools](static/images/readme/redux_tools.png)   


### 生产模式
```bash
$ npm run build //打包代码
$ node server.prd.js //启动服务器
$ npm run depoly //上传到测试环境 10.20.23.152
```

## 部署环境搭建
>请移步到 `/depoly/README.md` 了解详情

## 发布测试代码
```bash
$ npm run build
$ npm run depoly
```

我们也可以利用 webstorm 集成的 deployment 功能进行可视化部署
- 配置webstorm的deployment
  - 路径：`webstorm/tools/Deployment/configuration`
  - ![](static/images/readme/webstrom_depoly1.png)
  - ![](static/images/readme/webstrom_depoly2.png)
  - 然后单机右键出现`upload to ...`选择上传即可

## 项目地址
 - [mui](http://10.20.23.152:3005)
 - [pacloud](http://10.20.23.152:8080)
 - [payJs](http://10.20.23.152:8000)

## 浏览器支持
现代浏览器和 IE9 及其以上

## 开发规范
- payui 存放我们自己开发的组件
- mui 原则上不去修改源码
- 开发流程采用 git flow 工作流，可在 wiki 中查看

## 致谢
react | material-ui | payTeam 




