一、题目描述
题目：“福建赌王”之争
【题目背景】
话说，自称“赌王”的老周与同样自称“赌王”的老刘在福州展开“赌王”名号的争夺。两人商议决定使用福建当地的一套纸牌游戏规则进行博弈，即“福建十三水”。约定三周后展开决战。老刘修习代码多年，希望开发一套自动化的出牌系统，具体游戏规则请上网查询或找福大柯老板，本次作业要求提交一份完整的前端后端代码。
WARNING：珍惜钱财，远离赌博（含AI赌博）。
二、相关的链接
- 古力亚尔博客地址：https://github.com/ruinzly/031702506
- fork的同名仓库的GitHub项目：https://github.com/ruinzly/031702506
三、具体分工
此次团队编程作业前端和后端两人共同负责，前端先由一人进行开发，另一人负责优化改善（主要是怕这次作业完成不了，想想两个人一起学习前端比较现实！）前一周完成前端部分，后面时间都在忙后端，后端主要是思路问题，再由JAVA实现。
四、PSP表格
PSP
| ** PSP2.1** | ** Personal Software Process Stages ** | 预估耗时（分钟） | 实际耗时（分钟） |
| Planning | 计划 | 300 | 320 |
| Estimate | 估计这个任务需要多少时间 | 50 | 60 |
| Development | 开发 | 650 | 1050 |
| Analysis | 需求分析 (包括学习新技术) | 250 | 240 |
| Design Spec | 生成设计文档 | 30 | 30 |
| Design Review | 设计复审 | 30 | 40 |
| Coding Standard | 代码规范 (为目前的开发制定合适的规范) | 60 | 60 |
| Design | 具体设计 | 40 | 65 |
| Coding | 具体编码 | 200 | 380 |
| Code Review | 代码复审 | 60 | 60 |
| Test | 测试（自我测试，修改代码，提交修改） | 120 | 240 |
| Reporting | 报告 | 50 | 70 |
| Test Repor | 测试报告 | 50 | 60 |
| Size Measurement | 计算工作量 | 35 | 35 |
| Postmortem & Process Improvement Plan | 事后总结, 并提出过程改进计划 | 60 | 60 |
| 合计 | 1985 | 2770 |
五、解题思路与设计实践说明
网络接口的使用
登录注册和历史战局等接口，就是调用post或者get方法，然后进行数据的发送和获取数据并加以展示。开启战局和出牌部分的需要通过开启战局获取的card数据发送至自己的后端接口中，并返回排列好的前中后墩，然后通过出牌接口发送至助教的接口中。注册接口
登录接口
- 内部类图
算法的流程图
算法的关键就是对于牌型的判断，判断牌的花色->做整体判断是否有相同的牌(分情况讨论四张、三张、两张)->一组一组判断特殊牌型->分配权重->出牌 流程图如下：六、关键代码的解释
十三水算法中，我认为组牌判断是否为特殊牌型、同花顺、炸弹、对子等等牌型都是很重要的，那综合起来就是整个算法都是关键，所以一下只是评论解释其中的一小部分。判断每一个牌型是都会进行测试，在进行标记。
七、性能的分析与改进
前端的UI界面
起初因为刚开始学习前端，各个部分的知识都有所欠缺，只能用最基础的去实现其功能，就导致了在美观上有很大的不足。后来学习了CSS之后，就在原有基础上增加了透明度和圆角等知识，进行了页面美观改进。
修改前
修改后
后端的算法分析改进
在刚开始设计AI的实现方法时，我们想过使用贪心算法，先找到5张组合在一起最大的牌，放在底墩，再找5张第二大的牌，放在中墩，最后三张放在头墩。这样就符合规则了，但是这种情况下选出的牌，赢得概率不大，就放弃了这种思路，改用其他的方法，即拿到牌后，顺序判断各种牌型，在进行检验。
八、单元测试
该图是前端接口测试出来的结果：
服务器参数传到UI界面显示的牌型、玩家昵称、ID、以及得分情况：
我们通过改变传入的牌来测试输出是否正确，我所测试的测试数据，尽量测试特殊牌型，同花和顺子同时存在的时候如何取舍，还有某些偏僻的特殊牌型如何取舍。
九、Github的代码签入记录
十、遇到的代码模块异常或结对困难及解决方法
问题一： 根据原型制作前端的过程中都是html+js+css小白
解决方式： 百度相关菜鸟教程
问题二： 如何脱离本机进行服务器连接操作
解决方式： 写代码接口与之相连
* 问题三： 代码模块异常处理
代码模块的报错几乎都是因为其接口没有做好，报错最多的就是400、401、502；报这些错的原因有跨域问题，传参不到位，设置的参数与对应接口的参数不符合；解决以上的问题之后就可正常运行了。
十一、评价队友
值得学习的地方
1、学习前端语言时候很认真，心无旁骛；
2、意志力很强，不轻易放弃；
3、勤学好问，效率很高。
还需改进的地方
1、时间方面分配不太均衡。
十二、学习进度条
| ** 第N周 ** | 新增代码（行） | 累计代码（行） | 本周学习耗时（小时） | 重要成长 |
| 第一周 | 0 | 0 | 15 | 利用rp制作原型 |
| 第二周 | 1000 | 1000 | 48 | 制作学习前端基础知识以及后端基础知识 |
| 第三周 | 900 | 1900 | 60 | 后端开发以及github使用 |