简单 web 服务与客户端开发实战

1、概述

利用 web 客户端调用远端服务是服务开发本实验的重要内容。其中，要点建立 API First 的开发理念，实现前后端分离，使得团队协作变得更有效率。

任务目标

1. 选择合适的 API 风格，实现从接口或资源（领域）建模，到 API 设计的过程
2. 使用 API 工具，编制 API 描述文件，编译生成服务器、客户端原型
3. 使用 Github 建立一个组织，通过 API 文档，实现 客户端项目 与 RESTful 服务项目同步开发
4. 使用 API 设计工具提供 Mock 服务，两个团队独立测试 API
5. 使用 travis 测试相关模块

2、xx 开发项目

1. 这个是一个团队项目，团队规模建议 6 人以内
   • 必须使用github 组织管理你的项目仓库
   • 一个仓库是客户端项目，必须 使用富客户端js框架。建议框架包括（VUE.js,Angular,React）
   • 一个仓库是服务端项目，你可以选择 RPC 风格、REST 风格、 GraphQL 构建服务
   • 一个仓库是项目文档，用户可以获得项目简介和 API 说明
2. 你可以自由选择项目，以下是一些建议：
   • 自己选择一个项目，如“XX博客”
     • 资源类型不能少于 4 个。 如 “极简博客” 包括， users，acticles, reviews, tags …
     • 数据来源必须真实（请选择自己喜欢的网站抓取），每类资源不能少于 4 个数据
     • 页面参考主流博客结构，但仅需包含主页（https://xxx/:user），博客内容页面，按tag列表
   • 复制 https://swapi.co/ 网站
     • 你需要想办法获取该网站所有资源与数据
     • 给出 UI 帮助客户根据明星查看相关内容
3. 项目的要求
   • 开发周期
     • 2 周
   • 每个项目仓库必须要有的文档
     • README.md
     • LICENSE
   • 客户界面与美术
     • 没要求，能用就好
   • API 设计
     • API 必须规范，请在项目文档部分给出一个简洁的说明，参考 github v3 或 v4 overview
     • 选择 1-2 个 API 作为实例写在项目文档，文档格式标准，参考 github v3 或 v4
   • 资源来源
     • 必须是真实数据，可以从公共网站获取
     • 在项目文档中，务必注明资源来源
   • 服务器端数据库支持
     • 数据库 只能使用 boltDB，请 不要使用 mysql 或 postgre 或 其他
   • 页面数与 API 数限制
     • 界面不能少于 3 个界面
     • 服务 API 不能少于 6 个
   • API 要求
     • API root 能获取简单 API 服务列表
     • 支持分页
   • 加分项
     • 部分 API 支持 Token 认证
4. 提交物要求
   • 每个团队需要提供项目文档首页的 URL。在文档中包含前后端安装指南。
     • 前端一般使用 npm 安装
     • 后端使用 go get 安装
   • 每个队员必须提交一个相关的博客，或项目小结（请用markdown编写，存放在文档仓库中）
5. 认证技术提示
   • 为了方便实现用户认证，建议采用 JWT 产生 token 实现用户认证。
   • 什么是 jwt？ 官网：https://jwt.io/ 中文支持：http://jwtio.com/
   • 如何使用 jwt 签发用户 token ，用户验证 http://jwtio.com/introduction.html
   • 各种语言工具 http://jwtio.com/index.html#debugger-io
   • 案例研究：基于 Token 的身份验证：JSON Web Token