【校招VIP】[约起来] 开发文档：活动发布模块的模型

今天我们来看活动发布模块第二节课，开发文档的设计。

开发文档是根据原型图的功能点去做数据库和接口的设计，接口设计属于单独的接口文档，后面的课程会讲。这节课主要包括三个部分。

第一，原型图对我们来说是最重要的，这作为今年的校招考点之一出现。第二，正式进入开发文档设计阶段，怎么设计数据库，有哪些难点要点，怎么去满足。

第三，其他的枚举或者功能点的设计。

一.原型图

活动发布模块的页面包括活动信息和活动设置两个方向，也包括类别，类别又分六种类别。

数据库或功能一定是根据产品经理给出的原型图的功能和要点进行设计的，这个需要依赖于原型图。可以把原型图下载到桌面，跟视频同步对比。数据库设计的要点是根据产品经理的功能要求完成的，很多新手同学不知道怎么去设计，一定要搞清楚。

二.文档设计

文档的格式并不重要，每个公司都有自己的模板，时序图或者流程图比较简单，我们可以不写。但是一定要把功能难点写清楚。

功能点里强调第一个模块，特别是发布模块对整个项目基本模型的设定，比如活动的分类，活动的状态、地址。所以产品人员和Java人员要进行沟通和理解，这对设计数据库是有帮助的。

项目还分两部分，一部分是审核，在设计数据库的时候要考虑审核状态，比如审核失败，审核通过，发布成功等。另一部分就是活动进行中的状态，比如活动报名中，活动进行中，活动已下线，活动结束等，这在详情模块里是非常复杂的点。

原则上一个商业表里面会有四个固定字段。首先是ID，ID属于自增组件，类型是int类型，Int类型的最大长度是二十亿个字，一般数据长度到了10亿，单表就不能用了。然后是test字段，也就是title，最大32个字段，在数据库设计或切后端的接口设计里分类。还有活动亮点，对应原型图的功能，活动细节有两部分，一部分是活动亮点，150个字，另一个是活动内容，没有限制长度。最后是发布人，知道发布人是谁，后面做其他模块。比如详情模块，活动的发布者一定要展示出自己的身份，再做信用模块时，更好收集发布者的信用信息，判断发布内容的真实性。

第二个默认字段是status，它有一个基本意义就是零的状态，在商业数据库设计的时候，它是一个非法态，比如一般删除这个字段就是零的意思，在做服务查询时，拉数据库就会加一个不等于零，这样就会避免删除数据。每个字段都有它的用处。

活动发布时，有活动描述的图片，这次会用腾讯云的cos把图片放在里面，文件的地址也会放在里面。如果是多个图片，可以把它用逗号分隔开，这样加载也会更清楚。

我们早期是不会扩展到其他城市的，一个创业项目要在早期快速的去把功能点磨合到位，而不是快速扩张。

address type就是地址的类型，地址这个模块有两种情况，第一是线上，不需要地址，第二是线下，线下的地址和城市地址默认的话，城市可以为空。

begin time and time是开始时间和结束时间，开发的时候一定要注意它的最小单位是到分不到秒。数据库里要注意前端样式的时间，样式的处理，后端只要保证数据的完整性就可以。

参与人数可以先不放字段，知道数据库的产品逻辑，就可以做扩展，包括收藏字段也是如此，所以这两个字段目前不在里面，可以先放放。发布模块到这地方为止，一个好的数据表是在设计的时候把功能设计到位，少修改。

另外一个字段是time，也就是更新时间，更新时间会放进最后一条动态。 UIP是一个额外的字段，跟业务逻辑无关。属于风控字段，比如发布人当时的IP，这人有没有风险。一般来说，长度就是15位。

数据库的设计主要就是一个表，有几个字段可以先不考虑，知道有哪些功能是跟业务功能通过设计接口就可以。

三.枚举值

首先基于活动分类，产品可以分成六种。列表可查所有分类，一般来说我们会给个零，这是它的特点之一。枚举的好处是它可以进行很多方法的体验。城市的枚举暂时就用北京，上海，南京，合肥，武汉，西安这六个城市

考虑到城市扩展性，所以暂时就用两位数保证后面数据的统一。地址形式也加了枚举，线上还是线下，活动审核的状态是提交审核还是审核失败。在数据库里，零是失败，一是成功，二是提交审核的状态。

文章下一期会教大家理解这期内容，比如设计哪些字段，怎么设计，有哪些枚举设计和难点设计。购买课程同学的所有素材，不管是开发文档，还是图片代码，都可以进入到项目群，去要。也可以进入小程序在线实习，去以实习的模式来进行项目开发。