提交 7e882679 编写于 作者: Lyu-'s avatar Lyu-

[Updated]更新README文档

上级 0c7846f8
为了不遗漏作业内容,这里有一份checklist方便同学们快速检阅。
- fork仓库,和伙伴商讨如何通过git协作/代码规范等
- 编程实现
- 基础功能实现
- 附加功能实现
- 部署
- 发布release版本,发起pull request
- 撰写博客,在截止之前提交一份博客
- 包含作业描述和目录
- 核对评分标准
------
上一次结对作业中,大家都和小伙伴完成了原型的设计,那么现在再联合小伙伴动手实现原型中的部分功能吧。因为了解到大家基本都有一定的web基础,本次作业便要求大家采用web技术来实现原型中的功能。
# 截止时间
本次作业截止时间2022年3月26日 **23:00** 注:为防止0点提交造成卡顿、提交失败的现象,已将ddl修改至**晚上11点**
# 一、作业内容
### 1、基础功能
* **功能1:奖牌总榜**
* 可以查看各国代表团的奖牌数及**最终**排行。
* **功能2:每日赛程**
- 展示各项目的详细赛程,显示比赛时间、大项名称、比赛名称、场馆等信息
- 支持通过选择、切换比赛日期、项目、场馆的形式来筛选用户希望查看的赛程
* **功能3:奖牌地图**
-**世界地图**的形式直观地展示各个参赛国家的奖牌数
- 在地图上使用不同的颜色代表大致的奖牌数区间,颜色深浅表示奖牌数的多少
- 鼠标点击或移动到每个国家会高亮显示奖牌信息
### 2、附加功能
**附加功能1:详细赛况**
- 展示单项比赛的**成绩公报**,包含对应项目的参赛选手、得分、排行等比赛数据
(因为不同项目的成绩形式不一样,可挑选**至少3个**你感兴趣的小项目来进行页面实现,例如:高山滑雪-女子滑降
**附加功能2:了解更多**
* 介绍冬奥的举办背景,通过丰富的图文使平台更具吸引力,引起人们对冬奥、冬奥历史的兴趣。(例如,可以介绍近几届冬奥的会徽、举办地、吉祥物等)
### 3、其他说明
* **数据来源**
* 可参考[个人实战](https://bbs.csdn.net/topics/604845497),自主爬取【该爬取行为**仅用于课程教学**,请同学们在帖子中注明!】
* **关于扩展功能**
* 可以扩展你想扩展的功能,扩展功能会被记入作为附加分(不超过编码部分的15%),对于扩展的功能请在博客中**详细描述**
* **本次项目需要部署到云服务器上,并且在博客中给出链接**
* 国内云服务商域名没备案的话链接请给出IP的,否则过几天链接会因为未备案被封禁
* 若未实现部署到云服务器,则项目部署部分的分数为0分,并且需与助教协商时间现场演示
* **关于开发**
* 推荐基于Web来开发,使用Web框架,如常见的JSP、Servlet、spring系列、flask、php、express等,如果技术存在难度也可以直接使用纯前端来进行开发,数据写在代码中,持久化在storage。Web使用的持久化建议持久化在嵌入式数据库中,如sqllite或derby。采用的技术应该具有平台兼容性,不依托于具体的环境。本次作业以实现功能为主要目标,技术考量仅仅占一定的分数。切勿用原型工具生成代码,一经发现**直接0分**
# 二、编码要求
### 1、Gitcode使用
本次作业继续沿用Gitcode,相比第一次个人实战考察基础Git使用,这一次主要考察Git的合作。
1. Fork下面仓库,然后在根目录中新建一个以**学号1_学号2**(两位结对成员的学号)命名的文件夹,并至少进行20次以上的commit修改,两人至少分别提交10次以上,commit记录应该符合项目实情,如果虚构会被扣去所有分数。仓库目录结构没有硬性要求,但要保证可以依靠此仓库提供的代码来构建项目。
```
https://gitcode.net/qq_30777639/pairproject
```
**注:请至少在ddl前2天Fork仓库,最后两天助教会统一处理同学们的pr签入,为避免fork到其他同学的项目,请同学们提早Fork。**
2. 对于非仓库要求的代码,如编译器生成的项目文件、输出文件、class、jar包、exe等,应该使用.gitignore进行忽略,并确保不会提交到Gitcode上。
3. 为自己的仓库编写README.md,内容包括,作业链接、结对学号、项目介绍。
4. 在这次编程合作中学习使用Git分支、Release发布及其他高级功能。建立一条dev分支,让你的队友和你在dev分支上开发,开发结束后再合并到main分支。在基本功能开发完成后发布release包,标注版本为1.0.0,后边完成更多功能可以继续发布新的release包。
5. 在完成项目后,**deadline之前**,请正确发起一个Pull Requet ,并确保自己的代码最终成功签入。(如果成功签入会在原始项目主页看到自己学号为名的文件夹)
### 2、代码规范制定
这一次作业仍然需要编写一份codestyle.md作为代码规范,但是要求该代码规范来自于主流的官方规范或者大公司推荐的规范,并在代码规范顶部标注来源。
### 3、技术和框架
本次作业不限制语言,也不限制库的使用。
# 三、博客撰写要求
1. 给出作业描述和目录。
2. 在文章开头给出**Gitcode仓库地址**
3. 在开始实现程序之前,在**PSP表格**中记录下你估计将在程序的各个模块的开发上耗费的时间和实际花费的时间,实现程序后在**PSP表格**记录实际花费的时间,可以两个人共用一份PSP表格,也可以两个人分开使用两个PSP表格。
4. 给出项目部署到云服务器后的**访问链接**
5. 展示你的成品,要求**提供10张以上的图片,或者采用GIF或者视频嵌入的方式**来展示作业要求的功能,要求对每张展示的图辅以一定**文字说明**
6. **结对讨论过程描述**,即刚开始拿到题目后,和队友怎么讨论,解决问题和查找资料的过程,并提供**两人结对讨论的截图**。。
7. **描述设计实现过程**,给出**功能结构图**
8. 代码说明。展示出项目**关键代码**,300行左右,并**解释思路**
9. 阅读《构建之法》第四章的内容,结合在构建之法中学习到的相关内容,结对伙伴分别撰写**结对开发**项目的**心路历程与收获**,并**评价结对队友**
# 四、作业评分项和评分规则
本次作业总分100分
* 撰写博客 满分30分
* 1、博客排版【5%】:是否采用markdown排版,排版是否整齐,博客是否美观大方【覆盖课程目标5】
* 2、git仓库链接、代码规范链接【5%】【覆盖课程目标3】
* 3、PSP表格【5%】【覆盖课程目标7】
* 4、成品展示【30%】:提供10张以上的图片介绍,或者采用GIF或者视频嵌入的方式展示,展示的效果好,并能够提供充足的文字说明,能够通过展示清晰了解主要的功能。【覆盖课程目标5】
* 5、结对讨论过程描述和设计实现过程【30%】:讨论过程描述不笼统,提供结对讨论截图,未提供结对讨论截图该项扣5分。设计合理,实现过程描述不笼统;提供功能结构图,未提供功能结构图该项扣5分。【覆盖课程目标5】【覆盖课程目标6】
* 6、代码说明【10%】:展示出项目关键代码,并解释思路。【覆盖课程目标5】
* 7、心路历程和收获&评价结对队友【15%】:不笼统,有意义,图文兼备;两个人要写各自的感想和给对方的评价。【覆盖课程目标6】
* 编码实现 满分70分【覆盖课程目标5】【覆盖课程目标6】
* 1、代码规范的制定和遵守【10%】:符合所使用语言的官方规范或者行业规范,且指定的代码规范需要严格在编码中执行。
* 2、Github commit满足多于20次,要求两人均多于10次,且commit时间合理,使用分支、release、issues、pr等其它功能【15%】
* 3、项目功能完整度【75%】
* 1、基础功能
* (1)功能1:奖牌总榜【15%】
* (2)功能2:每日赛程【25%】
* (3)功能3:奖牌地图【25%】
* (4)将项目部署到云服务器上【10%】
* 2、附加功能
* (1)附件功能1:详细赛况【附加分:15%】
* (2)附件功能2:了解更多【附加分:10%】
* (3)扩展功能:扩展基础功能以外的功能【附加分:0%~15%】
* **注:附加功能+基础功能**不超过项目功能完整度部分的满分【**75%**
# 五、规则&格式
### 1、为了方便阅读以及助教评分,请大家在博客开头给出博文目录,作为内容的索引
请确认目录**可以正确跳转**
务必包含以下大标题,标题含义相近即可,你可以个性化你自己的标题:
- git仓库链接和代码规范链接
- PSP表格
- 成品展示
- 结对讨论过程描述
- 设计实现过程
- 代码说明
- 心路历程和收获
- 评价结对队友
### 2、 为了方便其他学校的老师或者助教了解课程实况,请大家在作业开头添加格式描述:
| 这个作业属于哪个课程 | <班级的链接> |
| :------------------- | :----------------------- |
| 这个作业要求在哪里 | <作业要求的链接> |
| 结对学号 | <写上两个结对同学的学号> |
| 这个作业的目标 | <写上具体方面> |
| 其他参考文献 | ... |
### 3、提交规则
- 博客以班级作业页面的提交时间为准;需要提交的代码以gitcode的提交时间为准;
- 在deadline前交,分数为实际得分 ;
- 若帖子发布后在审核(帖子显示404),可以在deadline 之前先于作业页面提交链接,再等待审核通过
- 不接受上传失败、网络原因等补交理由
- **补交**:在deadline 后两天内提交视为补交,分数为实际得分 * 50%;写了但是忘记提交作业和补交扣分一致
- **缺交**:在deadline 之后两天未补交视为博客缺交,分数为0分;
- **作业抄袭**:当助教发现两篇博客文字/图片/代码过于相似时,判定两篇博客都为抄袭,分数都为-100%(注意是倒扣!);
- **伪造提交**:虽然作业博客没有完成,但是先提交到作业占位置,判定为伪造提交,分数得0分;
- 两人**共用一份markdown****都需要发布博客**,作为自己的记录。但是作业提交时**只提交一份**,这一份博客的评论需要两人共同维护,还需要在**ddl之前**在班级群内**在线文档填写**作为作业提交博客的链接
注:提前提交的作业,如果能积极响应助教和老师的反馈并在deadline前做出相应修改,在后续评分时,这些修改完善也会被纳入考量。提早准备好处多~
### 4、注意事项
班级群如果发布相关通知也是作业要求一部分,请及时查看群通知; 若需要在群填写相关信息,未能在deadline之前完成填写的,**扣实际得分的50%**; 如对作业存在疑问,请在deadline之前三天在班级群提出; 若助教对作业要求有修改,会在群内公告,请务必查看并按新的要求完善作业; 请及时回复老师或助教的点评并作出相应修改。即使提交了作业,也应该关注班级群中助教的公告!
### 5、疑惑解疑
若有对题意不清或者有不理解的地方,可在该博客下方留言,或者在微信群中直接提问
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册