1、XXXX 平台需求文档 文档版本号： V1.0 文档编号： R20160129文档密级： 保密 归属部门/项目： 技术部产品名： XXXXO2O 平台 子系统名：编写人： Paco 编写日期： 2016-01-29一、 简介本文档主要描述 XXX O2O 平台的功能需求与前台页面内容与逻辑。因为平台需要离线数据同步，请做好线上数据与图片的版本生成，方便联网时同步数据，线下部分需要做到离线时数据变化后的提交。建议思路：每个表设有添加时间与更新时间字段，按照更新时间的先后来更新数据，终端机添加的数据记录到临时中界表，同步时先把临时中界表的数据添加到服务器，然后再把线上数据同步到线下。通过平台上所有
2、数据为假删除即状态删除，如有更好的解决方案可提出商讨。1、 目的：清晰、有层次的定义页面中各个模块的内容来源和相关的逻辑，程序员能快速理解功能需求。2、 范围：文档主要罗马易购 O2O 平台（包含 PC 端，移动端，终端机软件）的前端页面涉及到的功能点、相对应的后台管理功能支持、以及部分交互细节， 。本文档主要读者为技术部门的前端工程师，以及视觉部门的视觉设计。二、 用户角色用户角色 用户描述普通会员 平台的普通注册会员经销商 与平台合作的经销商管理员 平台管理员三、总体架构见附图：平台架构图四、功能详细说明1、 PC 端1.1 首页1.1.1 主导航功能描述 主导航（网站主菜单）输入/前置条
3、件需求描述 1、 调用后台定义的显示状态的菜单2、 按排序字段排序3、 使用缓存字段 名称，地址，父 ID，排序预期效果 点击菜单跳到相应的页面1.1.2 分类导航功能描述 分类导航（网站头部左则分类菜单）输入/前置条件需求描述 1、 调用后台定义的显示状态的菜单2、 按排序字段排序3、 使用缓存字段 名称，地址，父 ID，排序预期效果 点击菜单跳到该分类的商品列表页1.1.3 广告功能描述 广告，抱括 banner 与各个商品模块的大图广告输入/前置条件 输入广告位置 ID需求描述 1、 调用后台在有效时间内，且为显示状态的广告2、 按排序字段排序3、 使用缓存字段预期效果 点击广告跳到相应
4、的商品页面或是专题页面1.1.4 商品区域功能描述 首页楼层 如 1F 热区 2F 实木馆 3F 法式馆输入/前置条件 后台推荐首页产品、设定热门标签需求描述 1、 根据楼层分类调用推荐产品2、 根据楼层分类调用热门标签字段预期效果 点击跳到相应的商品页面1.1.5 资讯功能描述 新闻资讯输入/前置条件 后台编辑的新闻需求描述 1、调用最新的闻资讯字段预期效果 点击跳到相应的新闻页面1.1.6 底部功能描述 帮助中心，底部版权信息输入/前置条件 后台编辑的文章，版权信息需求描述 1、调用后台编辑好的文章信息字段预期效果 点击跳到相应的新闻页面1.1.7 搜索功能描述 关键词搜索、标题搜索输入/
5、前置条件 输入的关键字，标签需求描述 1、 匹配分类2、 匹配商品标题3、 匹配商品关键字4、 分词匹配5、 使用全文分词搜索 sphinx6、 排序：销量，人气，收藏，价格，最新，默认销量排序字段预期效果 点击标签或输入关键字相应的新闻页面1.1.8 会员注册功能描述 普通会员注册输入/前置条件需求描述 1、 只能以手机号注册2、 需手机验证码验证3、 完成注册后引导完善资料4、 接入微信扫一扫注册5、 接入 QQ 注册6、 建议密码加密方式：KEY SHA1 的后 16 位数+密码 SHA1 的后 16 位组合再 MD5 加密字段预期效果 1、 手机号码为空或不正确的时提示2、 注册完成后
6、可选择完善资料和回到首页1.1.9 会员登录功能描述 普通会员登录输入/前置条件 输入手机号、密码需求描述 1、 输入三次密码不正确后出现验证码2、 登录成功后跳转到登录前所在页字段预期效果 1、 用户名错误时，提示用户错误2、 密码错误时，提示密码错误3、 三次登录失败后，需要出现验证码4、 登录成功后跳转到登录前所在页1.1.10 忘记密码功能描述 普通会员忘记密码输入/前置条件 手机号码或邮箱需求描述 1、 手机号码，发送验证到手机，输入验证码通过来，让用户输入新密码，有效时间 10 分钟2、 邮箱，发送修改地址到用户邮箱，点击跳转通过后，让用户输入新密码，有效时间 2 两小时字段预期效
7、果 1、 用户输入手机号码，点击获取验证码，10 分钟内输入验证码，验证通过后跳到密码输入页，输入两次相同密码后提交，提示修改成功。2、 用户输入邮箱，点发确定，若有匹配的邮箱，刚发送邮件，用户在 2 小时内点击链接，校验地址信息，验证通过后跳到密码输入页，输入两次相同密码后提交，提示修改成功。1.2 商品列表1.2.1 商品筛选功能描述 根据商品分类和属性筛选商品输入/前置条件 属性 ID，功能分类 ID，风格分类 ID（附属分类）需求描述 1、 根据 ID 或属性组合筛选出商品，并分页2、 筛选条件显示：a、 根据当前分类 ID,显示其一级子分类，若无分类 ID，显示顶级分类（两个分类同时
8、适用）b、 若无功能分类 ID 时，默认筛选条件：功能分类、风格分类c、 若有功能分类 ID 时，调用该分类的商品类型，并调用商品类型中的筛选属性作为筛选条件d、 列表排序：综合，销量，人气，收藏，价格升降序，最新，默认综合排序e、 实现分页f、 优化 URL 地址，如：使用 1-4-7-8.html 的格式字段预期效果 1、 点击风格分类实木家具时，跳转到列表页，筛选条件为：实木家具：白蜡木、白橡木等；功能：客厅 卧室等；再点击当前筛选条件的实木家具时返回上级分类，此例为筛选所有家具。筛选条件为：风格：实木家具，法式，地中海等；功能：客厅，卧室等，2、 点击功能分类客厅时，跳转到列表页，调用
9、风格，与客厅分类的一级子类，同时调用客厅商品类型的筛选属性。如创建了客厅类型的面积、户型两个筛选属性。筛选条件为：风格：实木家具，法式，地中海等；客厅：沙发，电视柜，茶几等；面积：70-100 方 100-120 方；户型：两房一厅，三房两厅。3、列表上方可选择想要的排序销量，人气，收藏，价格升降序，最新，默认销量排序1.2.2 商品列表功能描述 商品列表输入/前置条件需求描述 1、 商品图片统一正方形2、 显示商品标题，价格，销量，评论3、 加入购物车按钮，点击格加入4、 参加促销，显示促销标题或是促销标志5、 在图片右上角，鼠标在图片上时显示商品收藏按钮，点击异步收藏商品，若没登录，提示登
10、录字段预期效果 1、 快速识别出促销产品2、 点击加入购物，按默认规格把商品加入到购物车1.2.3 最近浏览功能描述 展示用户最近浏览过的商品输入/前置条件需求描述 1、 cookie 与数据库结合记录用户的浏览记录，用户没登时，记入 cookie，登录后同步到数据库2、 记录最近浏览的 20 条记录字段预期效果1.2.4 猜你喜欢功能描述 为用户推进相关产品输入/前置条件需求描述 1、根据当前浏览的产品随机推荐当前分类的相关产品字段预期效果1.3 商品详情页 参考 http:/ ID 查找商品，并判断其是否参与促销活动，若商品已下架则提示下架。若商品已删除，则提示商品不存在。1.3.1 商品
11、相册功能描述 商品的主图相册输入/前置条件需求描述 1、 放大镜功能2、 可多张图片，如缩略图位置不够，则可以用鼠标滚动显示图片3、 点击缩略图，切换大图字段预期效果 选择缩略图，鼠标移动到大图上，出现放大镜1.3.2 促销信息功能描述 商品促销信息展示输入/前置条件需求描述 1、 判断商品是否参与促销活动，若参与则是显示活动的名称，并显示活动优惠的价格2、 如是限时抢购，则显示倒计时间，时间需与服务器同步，防止并发时数据出错字段预期效果 打开商品详情页，较显眼的展示商品促销信息1.3.3 商品规格功能描述 商品不同规格选择输入/前置条件需求描述 1、 调出商品各个规格供选择2、 默认选中默认
12、规格3、 用户可根据规格自由组合，若无该组合则显示成灰色，不能选择4、 根据选择不同的组合显示相应该 SKU 中的价格字段预期效果 用户可选择不同的规格组合，并即时显示价格1.3.4 二维码功能描述 生成产品的二维码输入/前置条件需求描述 1、调用添加商品时生成的二维码字段预期效果 用户用手机扫一扫可以在手机上打开该产品1.3.5 加入购物车功能描述 商品加入购物车输入/前置条件需求描述 1、 判断是否选择好规格2、 判断数量是否正确，如 0 或是负数情况3、 未登录使用 cookie 记录，已登录插入数据库4、 登录后，需把 cookie 数据与数据库数据同步字段预期效果 点击加入购物车，商
13、品异步添到到购物车，同时购物车的商品数量加 11.3.6 立即购买功能描述 立即购买商品输入/前置条件 登录需求描述 1、 判断是否选择好规格2、 判断数量是否正确，如 0 或是负数情况3、 未登录提示登录字段预期效果 点击购买，跳转到订单生成页1.3.7 商品收藏功能描述 商品收藏输入/前置条件 登录需求描述 1、 判断是否登录，若没登录提示登录2、 商品异步收藏字段预期效果 点击收藏按钮，若没登录，提示登录，若已登录高亮收藏按钮1.3.8 商品详情功能描述 商品的详介绍输入/前置条件需求描述 1、 详情分三个区：促销区、内容区、公共区2、 促销区：根据商品的分类调用相应的广告促销内容（在后
14、台广告位置中设定）3、 内容区：商品详情介绍4、 公共区：所有详情页共同使用，内容为售后、物流、公司实力等通用内容等。5、 增加浏览数量字段预期效果1.3.9 商品参数功能描述 商品的具体参数说明输入/前置条件需求描述 1、 根据商品类型的属性分类，依次展示商品的具体参数可参：美乐乐的详情页 http:/ 字段预期效果1.3.10 在线客服功能描述 在线即时通信工具输入/前置条件需求描述 接入百度商桥在线客服功能字段预期效果 点击客服图标，弹出窗口实现在线即时通信1.3.11 最近浏览功能描述 展示用户最近浏览过的商品输入/前置条件需求描述 3、 cookie 与数据库结合记录用户的浏览记录，
15、用户没登时，记入 cookie，登录后同步到数据库4、 记录最近浏览的 20 条记录字段预期效果1.3.12 猜你喜欢功能描述 为用户推进相关产品输入/前置条件需求描述 1、根据当前浏览的产品随机推荐当前分类的相关产品字段预期效果1.3.13 热门推荐功能描述 为用户推进相关产品输入/前置条件需求描述 1、根据当前浏览的产品推荐当前分类的人气产品字段预期效果1.4 购物车功能描述 购物车输入/前置条件需求描述 1、 无产品时提示购物车暂无商品，旁边放按钮去挑选商品，跳转到首页2、 显示商品列表，包括：图片，标题，商品规格，单价，数量，折扣，金额，优惠，商品总数量，商品总金额3、 可增加或减少商
16、品数量，最少减到 1，数量改变同时改变价格，总额4、 可删除商品5、 点结算后跳转到订单生成页字段预期效果 点击购物车，能看到欲购买的所有商品，数量，价格，优惠信信息，并可更改商品数理，删除商品1.5 订单生成注：订单有两个付款状态，一个为会员付款，一个为经销付款。通过线上平台在线上付款的订单为普通会员订单，可直接发货，无需验证经销商付款状态。通过线下支付的订单为经销商订单，需判断经销商付款状态。1.5.1 收货地址功能描述 用户的收货地址输入/前置条件需求描述 1、 默认调用会员地址簿的默认地址，若地址簿无地址，显示添加地址表单 2、 用户可异步更换地址3、 用户可异步修改当前地址字段预期效
17、果 1、 进入页面，用户地址簿无地址则是显示添加地址表单 ，用户填写完成后，异步提交。2、 若已有默认地址，用户可异步修改地址或更换地址1.5.2 配送方式功能描述 物流配送方式输入/前置条件需求描述 1、 此处有三个单选项：1、官方物流配送 2、快递配送 3、自行物流配送2、 选择官方配送，根据地址和物流表计算出物流费，并计入订单中，默认选中状态，3、 选择快递，根据地址和快递表计算出快递费，并计入订单中4、 选择自行物流配送，费用为 0，记录配送方式5、 若商品为包物流，则费用为 06、 物流费用计算方式：所有商品的体积和 X 目的地每方费用，如体积小于一方按一方算。快递费类似字段预期效果
18、 1、 默认选择官方物流配送，显示物流所需费用，并计入订单总额2、 选择快递，显示快递所需费用，并计入订单总额3、 选择自行物流配送，费用为 01.5.3 商品清单功能描述 商品清单输入/前置条件需求描述 1、 显示商品列表，包括：图片，标题，商品规格，单价，物流费，体积，数量，折扣，金额，优惠2、 在右下方显示：小计（商品总额） ，物流费，现金券，积分兑换，总计等信息3、下方为确认订单按钮，点击跳到支付页面字段预期效果 清楚的显示所有的商品信息与费用1.5.4 使用积分功能描述 会员使用积分兑换金额输入/前置条件需求描述 1、 判断会员当前的可用积分2、 按照积分与 RMB 比例折算出金额，
19、并从订单中减去相应金额3、 每个订单最高可兑换 10%金额的积分4、 显示最高可例用的积分，用户可自行输入范围内的兑换积分数量5、 确认订单后减去积分，若订单取消或是退款则把积分加回字段预期效果 选择使用积分后，显示最高的可兑换积分，并把该数量写入到文本框中，用户可自行修改想使用的积分数量，计算出兑换后的优惠金额，并从订单中减去1.5.5 使用现金券功能描述 会员使用积分兑换金额输入/前置条件需求描述 1、 判断用户当前可用的现金券，显示给用户选择使用那个券2、 用户选择后，订单减去相应该的金额3、 每个订单仅能使用一张现金券4、 确认订单后修现金券状态为已使用，若订单取消或是退款则则判断现金
20、券有没有过期，没过期 则改状态为未使用字段预期效果 选择使用现金券后，显示可用的现金券让用户选择（单选） ，从订单中减去相应金额1.5.6 推荐人功能描述 会员使填写购买推荐人输入/前置条件需求描述 1、 文本框输入推荐人手机号码，并异步验证是否存在2、 根据推荐人的等级与订单金额计算出优惠金额，并从订单中减去3、 根据订单金额和推荐人等级计算出推荐所应得的积分或返现金额字段预期效果 输入正确的手机号码，并异步验证，通过显示优惠的金额，并从订单口减去1.5.7 索取发票功能描述 索取发票输入/前置条件需求描述 1、 勾选发票选项，显示输入发票抬头文本柜2、 提示要收取的点数，并计算出金额显示，
21、且订单加上此金额3、 订单表需记录税费字段预期效果 勾选发票，显示所要收取的税点与金额，订单金额加上此金额1.5.8 支付方式功能描述 支付方式输入/前置条件 确认订单后转入订单号与订单金额需求描述 1、 四个支付方式单选项：1 支付宝 2 网银在线 3 微信支付 4、线下转帐2、 接口需支付扫码支付与传统支付3、 记录用户选择的支付方式，并记录支付日志（无论成功还是失败）4、 匹配到所属经销商后方可显示些项，选择线下转帐，确定订单后，提示到经销处付款，同时调用地图显示路线字段预期效果 选择支付方式后，点确定，跳转到相应的支付页面，支付完成后，提示支付成功，选择银行转帐，则显示相关转帐信息与注
22、意事项1.5.9 订单所属经销商功能描述 订单所属经销商输入/前置条件需求描述 1、 根据会员的 IP 得出所在地2、 根据所在地寻找经销商，若此地区有经销商，则订单归属于此经销商，若无，归为官方字段预期效果 系统可划分经销商订单与官方订单1.5.10 订单快照功能描述 订单快照输入/前置条件需求描述 订单生成付款后所有数据都写死到表中，形成快照数据，便于商品价格信息变动了不影响订单字段预期效果 点击交易快照，可以查看到商品交易时的价格图片规格优惠信息1.6 会员中心1.6.1 我的交易1.6.1.1 我的订单功能描述 会员订单列表输入/前置条件 会员登录需求描述 1、 显示订单号，下单时间，订单商品，商品图片，规格，价格，优惠信息，订单总额，会员付款状态2、 未付款时，显示付款按钮，点付按钮跳转到支付方式页面3、 付款后，每个商品显示发货状态（1、备货中，2、现货待发，3 已发货）
