{"action":"created","issue":{"url":"https://api.github.com/repos/jun-lu/lujun.github.com/issues/51","repository_url":"https://api.github.com/repos/jun-lu/lujun.github.com","labels_url":"https://api.github.com/repos/jun-lu/lujun.github.com/issues/51/labels{/name}","comments_url":"https://api.github.com/repos/jun-lu/lujun.github.com/issues/51/comments","events_url":"https://api.github.com/repos/jun-lu/lujun.github.com/issues/51/events","html_url":"https://github.com/jun-lu/lujun.github.com/issues/51","id":156898423,"number":51,"title":"使用React开发政府网站，还兼容了IE8的过程","user":{"login":"jun-lu","id":491651,"avatar_url":"https://avatars.githubusercontent.com/u/491651?v=3","gravatar_id":"","url":"https://api.github.com/users/jun-lu","html_url":"https://github.com/jun-lu","followers_url":"https://api.github.com/users/jun-lu/followers","following_url":"https://api.github.com/users/jun-lu/following{/other_user}","gists_url":"https://api.github.com/users/jun-lu/gists{/gist_id}","starred_url":"https://api.github.com/users/jun-lu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jun-lu/subscriptions","organizations_url":"https://api.github.com/users/jun-lu/orgs","repos_url":"https://api.github.com/users/jun-lu/repos","events_url":"https://api.github.com/users/jun-lu/events{/privacy}","received_events_url":"https://api.github.com/users/jun-lu/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":2,"created_at":"2016-05-26T03:55:29Z","updated_at":"2016-07-07T06:20:33Z","closed_at":null,"body":"## 使用React开发政府网站，还兼容了IE8的过程。\r\n\r\n围观地址： 青岛市居民健康信息服务平台（区域诊疗一号通) <http://guahao.jkqd.gov.cn/>\r\n\r\n大家看到政府网站使用React技术有惊讶！\r\n\r\n````\r\n政府网站用 React, 毫无 PS 痕迹啊.\r\n\r\n````\r\n\r\n````\r\n政府网站居然使用react，而不是asp, 真的挺惊讶的\r\n\r\n````\r\n\r\n这说明我们是一个有理想的创业公司，至少是一个有理想的创业团队，也肯定是一个有理想的前端团队吧。哈哈\r\n\r\n### 背景、准备\r\n\r\n在做这次改版的前一个月，我们就在思考使用什么技术，并在技术上制定了几个目标： `体验超过大部分同类网站`， `最好是单页面的（相应速度比较快）` ， `有技术挑战` ，`能够沉淀来应用到其他业务的`， `团队成员能自豪的在简历上添注一笔`\r\n\r\n首先派出团队成员A君（喜欢新技术犹如看到漂亮妹子），开始做技术选型、搭建基本的DEMO，这个过程比较漫长，选型也是逐步完成，每天的进度比较慢，需要考虑的点很多，特别是在熟悉 react 技术的过程中，半个月以后临近正式投入才决定使用 `React` + `Redux` + `webpack` + `ES6语法`，不过 `Redux`一直是我们选择过程中纠结地方, 最后在查看DEMO的时候发现 Redux 的思维太高级（看不懂）， 对于一个完全没有接触过 React 的团队，要同时接受 React 和  Redux 的思想很困难，可能会让项目进度无法把控，所以最后决定这个项目暂时先不使用 Redux 。\r\n\r\n\r\n\r\n### 开始\r\n\r\n##### 分工\r\n\r\n* DEMO \r\n\r\n\t`先DEMO, 后逻辑` 这是我们约定的一个基本原则，首先把设计稿PSD全部转换成HTML静态DEMO，并做好页面之间的链接，这有助于我们在前期就掌握网站的大多数模块，那些可复用，哪些是独立的。也可以提前让设计师和产品发现设计上的缺陷，及时改进。为此我们在本地在启动webpack的时候也会启动一个静态服务器`express`并做了一些特殊规则（使用ESSI，LESS插件等），预览DEMO。也会把demo部署到内部环境让所有人预览\r\n\r\n* 工作量按页面分工\r\n\r\n\t每个人分页面开发，但在开发自己页面之前需要协调好一些公共模块是不是其他页面已经有了，不做重复工作。这个过程具体的开发人员之间各自协调\r\n\r\n* 技术问题分工\r\n\r\n\t在正式大规模投入React模块逻辑开发之前，有2个问题需要提前解决 `低端浏览器兼容(IE8)` `整个项目的代码组织方式`，第一个问题交给A君（如何让React兼容IE8，敬请期待），后一个我自己来解决（[ReactPC网站整体代码继承结构](https://github.com/jun-lu/lujun.github.com/issues/45)）\r\n\r\n\r\n#####  GIT与代码部署\r\n\r\n* 本地测试环境\r\n\r\n\t不用多说，直接用webpack + express 来预览，在后端API还未完成的初期使用<http://rap.taobao.org/org/index.do>来模拟接口。\r\n\r\n* 内部环境和线上环境的部署\r\n\r\n\t代码部署完全交给 `git webhook` 来完成(之前的基础设施已具备)， 内部环境部署 `git push origin ${branch}` , 线上部署  `git push origin ${tag}`。所有部署动作都是自动化完成的，工程师只需要提交代码到gitlab仓库即可。\r\n\r\n\t\r\n* git分支管理\r\n\t\r\n\t并没有每个人独立分支开发，而是3个人在同一分支上同时开发，因为之前的分工明确、开发人员也只有3个，开发过程并没发生代码冲突导致合并困难, 反而直接合并(git pull)其他成员的提交，让协作变得很快，公共模块的更新能及时的反应本地环境来，所依赖的其他人的任务也可以第一时间合并进来。\r\n\r\n\r\n\r\n### 开发中\r\n\r\n在开发中我们反复纠结了代码组织方式，以及模块数据的来源。期间也经历了好几次观念上的升级，都会导致代码组织方式发生变化，不过这些变化都还算愉快，一直在思考问题更好的解决方案，从问题取得进步\r\n\r\n##### 代码结构\r\n\r\n<https://github.com/jun-lu/lujun.github.com/issues/45>\r\n\t\r\n依靠下面结构解决了以下问题\r\n\t\r\n* 所有模块的加载中状态\r\n* 所有模块的接口重试机制\r\n* 单个模块报错影响面积最小化\r\n* 合并不同模块对同一API的多次调用\r\n* 最大限度做到接口缓存，提高二次访问速度\r\n* 页面级事件的处理（比如登出，登入）\r\n\t\r\n![图](https://camo.githubusercontent.com/fd95acf36f0a85cd8c49eee38469d72eea35f6be/687474703a2f2f696d6167652e7975616e7475746563682e636f6d2f757365722f30393761373739356438616334386337653039646433333465663939633637612d3537342d3733352e706e67)\r\n\r\n* BaseModule 的 render\r\n\r\n````\r\n\r\n    renderLoading(){\r\n        return <div className=\"no-data\">\r\n            <img src=\"http://gtms04.alicdn.com/tps/i4/T1hPyYFD0kXXa679Pe-40-40.gif\" width=\"20\" />\r\n        </div>\r\n    }\r\n\r\n    renderIOError(){\r\n        return (<div onClick={this.componentDidMount.bind(this)}\r\n                         className=\"no-data\">{this.state.msg || \"请求失败\"}</div>)\r\n    }\r\n\r\n    renderError(){\r\n        return <div className=\"no-data\" onClick={this.componentDidMount.bind(this)}>数据格式不正确</div>\r\n    }\r\n\r\n    render() {\r\n\r\n        if (this.state.loading) {\r\n            return this.renderLoading()\r\n        }\r\n\r\n        if (this.state && this.state.success == false) {\r\n            return this.renderIOError()\r\n        } else {\r\n            try {\r\n                return this.toRender();\r\n            } catch (e) {\r\n                if (navigator.userAgent.indexOf(\"MSIE 8.0\") == -1){\r\n                    console.log(e, this);\r\n                }\r\n                return this.renderError()\r\n            }\r\n        }\r\n    }\r\n\r\n````\r\n\r\n* 【源码】科室列表模块的代码\r\n\r\n````\r\nimport React from 'react';\r\nimport ReactDOM from 'react-dom';\r\nimport BaseModule from '../../libs/BaseModule';\r\nimport {Link} from 'react-router'\r\n\r\n\r\n\r\nexport default class DepartmentList extends BaseModule {\r\n\r\n    constructor( props ){\r\n\r\n        super( props )\r\n        // 从 url 或者 父级获取参数\r\n        this.corpId = this.props.corpId || this.query.corpId;\r\n\r\n    }\r\n\r\n    componentDidMount(){\r\n        //请求数据，从缓存中\r\n        this.getCache(\"/user-web/ws/query/dept-list2\", {\r\n            corpId:this.corpId\r\n        })\r\n    }\r\n\r\n    renderLoading(){\r\n        //使用一个定制的加载状态\r\n        return <div>\r\n            <Placeholder />\r\n            <Placeholder />\r\n            <Placeholder />\r\n            <Placeholder />\r\n        </div>\r\n    }\r\n    toRender(){\r\n        //请求完成渲染\r\n        let corpId = this.corpId;\r\n\r\n        return (<div>\r\n                {   \r\n                    this.state.data.map((item, index) => {\r\n                        return (<div key={index} className=\"department-list\">\r\n                            <dl className=\"department-big-list\">\r\n                                <dt><span className=\"title\">{item.deptName}</span></dt>\r\n                                <dd>\r\n                                    <ul>\r\n                                        {\r\n                                            item.children.map((item, index) => {\r\n                                                return <li key={index}><Link to={\"/yuyue/department-index?deptCode=\"+item.deptCode+\"&corpId=\"+corpId}>{item.deptName}</Link></li>\r\n                                            })\r\n                                        }\r\n                                    </ul>\r\n                                </dd>\r\n                            </dl>\r\n                        </div>)})\r\n                }\r\n            </div>)\r\n    }\r\n\r\n}\r\n\r\n//给当前模块一个漂亮的加载中状态\r\nclass Placeholder extends React.Component {\r\n\r\n    render(){\r\n        return <div className=\"department-list placeholder\">\r\n            <dl className=\"department-big-list\">\r\n                <dt><span className=\"title\"></span></dt>\r\n                <dd>\r\n                    <ul>\r\n                        <li><a></a></li>\r\n                        <li><a></a></li>\r\n                        <li><a></a></li>\r\n                        <li><a></a></li>\r\n                        <li><a></a></li>\r\n                        <li><a></a></li>\r\n                        <li><a></a></li>\r\n                    </ul>\r\n                </dd>\r\n            </dl>\r\n        </div>\r\n    }\r\n}\r\n\r\n\r\n\r\n````\r\n\r\n##### 引入 `react-router`\r\n\r\n开发到中期我们惊讶的发现，整个网站的入口竟然被自然的统一到一个模块中(App), 只需要把这个模块渲染到页面就可以了，单页面的火种又重新燃起了，于是在项目中新建了一个分支（为什么和这个时候要开新分支？）来引入react-router, 为了兼容IE8，所以使用 hash 的方式。引入以后对已经开发好的模块还是有一定影响，因为状态被放在hash上了，以前代码中处理这部分的逻辑需要重构。比如需要保留状态的选项卡，就必须把状态放在路由中处理，而不用自己处理状态，选项卡主模块只简单render`this.props.childer`就好，像一个容器。\r\n \r\n* 为什么和这个时候要开新分支？\r\n\r\n\t评估到这个时候引入 react-router 可能存在风险，万一不成功还可以丢掉，故开新分支。 \r\n\r\n \r\n* App的render 和 依赖的 history\r\n\r\n````\r\n\r\nimport {Router,Route, IndexRoute, IndexRedirect, browserHistory,hashHistory,useRouterHistory } from 'react-router'\r\n\r\nimport {createHashHistory} from 'history'\r\n\r\nconst history = useRouterHistory(createHashHistory)({queryKey: false})\r\n\r\n\r\n````\r\n\r\n\r\n````\r\n    render() {\r\n        return (\r\n        \t<Router history={history}>\r\n\t\t\t    <Route path=\"/\" component={Page}>\r\n\t\t\t        <IndexRedirect to=\"index\"/>\r\n\t\t\t        <Route path=\"index\">\r\n\t\t\t            <IndexRoute component={IndexScreen}/>\r\n\t\t\t            <Route path=\"search\" component={SearchScreen}>\r\n\t\t\t                <IndexRoute component={All}/>\r\n\t\t\t                <Route path=\"jib\" component={Jib}/>\r\n\t\t\t                <Route path=\"zzk\" component={Zzk}/>\r\n\t\t\t            </Route>\r\n\t\t\t        </Route>\r\n\t\t\t        <Route path=\"yuyue\">\r\n\t\t\t            <IndexRoute component={CorpListPage}/>\r\n\t\t\t            <Route path=\"corp-list\" component={CorpListPage}/>\r\n\t\t\t            <Route path=\"corp-index\">\r\n\t\t\t                <IndexRedirect to=\"keshi\"/>\r\n\t\t\t                <Route path=\":activeKey\" component={CorpIndex}/>\r\n\t\t\t            </Route>\r\n\t\t\t            <Route path=\"department-index\" component={DepartIndexScreen}/>\r\n\t\t\t            <Route path=\"doctor-index\" component={DoctorIndexScreen}/>\r\n\t\t\t\t\t\t<Route path=\"doctor-list\" component={DoctorListScreen}/>\r\n\t\t\t            <Route path=\"schedule-confirm\" component={ScheduleConfirmScreen}/>\r\n\t\t\t            <Route path=\"schedule-success\" component={ScheduleSuccessScreen}/>\r\n\t\t\t        </Route>\r\n\t\t\t        <Route path=\"news\">\r\n\t\t\t        .......\r\n\r\n````\r\n\r\n\r\n##### 模块的数据来源\r\n\r\n什么样的模块自己发请求，什么样的模块使用父级传递的数据渲染。这也是 redux 说说的`智能模块`和`笨模块`的区分，当然最终没有什么好的定论，毕竟这确实是一个设计哲学的问题，每个人都有不一样的标准。下一次我们也会尝试 redux， 看看他的解决方案。\r\n\r\n\r\n\r\n##### 统计\r\n\r\n| 资源 | 数据 |\r\n| ------------ | ------------- | \r\n| 前端开发 | 3人（非全投入）  | \r\n| 开发周期 | 1个月  | \r\n| 模块数量 | 60+  | \r\n\r\n\r\n##### 最后广告时间\r\n\r\n团队招人，坐标杭州，待遇优厚，特别优秀的工程师可以谈期权。\r\n\r\n我们正在实践react, react-native，绝对能把最新的技术运用到生产环境。 \r\n给你最适合技术探索的环境，不信问A君。\r\n\r\n团队缺前端工程师，android工程师和ios工程师\r\n\r\n跪求简历 mail: lujun@yuantutech.com \r\n"},"comment":{"url":"https://api.github.com/repos/jun-lu/lujun.github.com/issues/comments/230988891","html_url":"https://github.com/jun-lu/lujun.github.com/issues/51#issuecomment-230988891","issue_url":"https://api.github.com/repos/jun-lu/lujun.github.com/issues/51","id":230988891,"user":{"login":"changero","id":17746517,"avatar_url":"https://avatars.githubusercontent.com/u/17746517?v=3","gravatar_id":"","url":"https://api.github.com/users/changero","html_url":"https://github.com/changero","followers_url":"https://api.github.com/users/changero/followers","following_url":"https://api.github.com/users/changero/following{/other_user}","gists_url":"https://api.github.com/users/changero/gists{/gist_id}","starred_url":"https://api.github.com/users/changero/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/changero/subscriptions","organizations_url":"https://api.github.com/users/changero/orgs","repos_url":"https://api.github.com/users/changero/repos","events_url":"https://api.github.com/users/changero/events{/privacy}","received_events_url":"https://api.github.com/users/changero/received_events","type":"User","site_admin":false},"created_at":"2016-07-07T06:20:33Z","updated_at":"2016-07-07T06:20:33Z","body":"为了兼容IE8，做了哪些工作"}}
{"actor":{"display_login":"changero"}}