荔波智慧全域旅游_详细设计说明书_05手机App

荔波智慧全域旅游-详细设计说明书荔波智慧全域旅游手机app详细设计文档安顺软通动力信息技术有限公司2019年4月 文档修改记录编号日期描述文档版本作者审核批准12015/12/28新建文档V0.1王勇新黄俊22016/2/5修订V0.5刘旺胜黄俊32016/5/30定稿V1.0方晓宇黄俊456本文档中所包含的信息属于内部资料，如无软通动力公司的书面许可，任何人都无权复制或利用。 目 录1 设计说明41.1 荔波全域旅游手机App41.1.1 App首页41.1.2 登录注册71.1.3 个人中心111.1.4 荔波全域旅游指南261.1.5 景区、酒店、交通、美食、民宿、娱乐综合服务331.1.6 地图571.1.7 预订功能591.1.8 足迹功能622 统出错处理设计732.1 异常处理设计732.2 系统检查设计752.3 尚待解决的问题751 设计说明从本章开始，逐个地给出各个系统及系统内每个模块的设计考虑。以下给出的提纲是针对一般情况。对于一个具体的模块，尤其是层次比较低的模块或子程序，其很多条目的内容往往与它所录属的上一层模块的对应条目的内容相同，在这种情况下，会简单地说明这一点。另为使预期读者能够顺利、准确理解本文档内容，在此对文档中的“特殊语言”加以约定，即本文档中使用的格式、符号等内容在此做统一标准，以使本文读者能够在共同语言的基础上理解本文档内容。1.1 荔波全域旅游手机App门户平台是用于集资讯门户、电子商务平台、社区交互平台、电子政务平台为一体的展示窗口，需要涉及到的功能模块有门户首页、登录注册、个人中心、荔波六要素服务、荔波必游、旅游服务、门户后台管理系统。1.1.1 App首页1.1.1.1 功能设计1.1.1.1.1 App首页菜单导航编号PORTAL001_1优先级一级功能名称荔波全域旅游App的所有页面内容导航。操作对象及权限普通公众用户参考界面导航栏首页信息数据表述数据项对应字段约束控件特殊要求页面操作逻辑描述操作处理逻辑特殊要求点击栏目跳转到相应的栏目页面1.1.1.1.2 首页风格及内容编号PORTAL001_2优先级一级功能名称荔波旅游App首页，包括食、住、行、游、购、娱六要素的列表入口；天气预报；旅游动态、旅游攻略的列表入口；推荐的旅游详情；景区、酒店、餐饮、购物、娱乐的地图搜索入口。虚拟游及六大类的搜索功能。操作对象及权限普通公众用户参考界面首页信息数据表述数据项对应字段约束控件特殊要求城市city必填Text页面操作逻辑描述操作处理逻辑特殊要求1.1.2 登录注册1.1.2.1 功能设计1.1.2.1.1 注册编号PORTAL002_1优先级一级功能名称荔波旅游App用户注册页面。操作对象及权限普通公众用户参考界面插入字段数据描述数据项对应字段约束控件特殊要求手机号PhoneNumber必填text密码Pwd必填text页面操作逻辑描述操作处理逻辑特殊要求输入手机号点击获取短信验证码等待短信验证码发到手机上，然后将验证码输入到输入框内输入密码2次要保证一致1.1.2.1.2 登录编号PORTAL002_2优先级一级功能名称注册用户登录App。操作对象及权限普通公众用户参考界面数据项对应字段约束控件特殊要求账号PhoneNumber必填Text密码Pwd必填Text页面操作逻辑描述操作处理逻辑特殊要求输入账号就是手机号输入密码点击登录系统会返回登录成功还是失败1.1.2.1.3 忘记密码编号PORTAL002_3优先级一级功能名称用户重置密码操作对象及权限普通公众用户参考界面插入字段数据描述数据项对应字段约束控件特殊要求手机号PhoneNumber必填Text密码Pwd必填Text页面操作逻辑描述操作处理逻辑特殊要求输入手机号点击获取短信验证码等待短信验证码发到手机上，然后将验证码输入到输入框内输入密码2次要保证一致1.1.3 个人中心1.1.3.1 功能设计1.1.3.1.1 我的信息管理编号PORTAL003_1优先级一级功能名称管理和设置我的基本信息，包括：个人信息修改、登录注销、我的收藏、关注、粉丝及订单、行程的管理。操作对象及权限普通公众用户参考界面个人信息修改页面字段数据描述数据项对应字段约束控件特殊要求昵称Nickname姓名Name性别Sex手机号PhoneNumber密码Pwd页面操作逻辑描述操作处理逻辑特殊要求点击图像左侧按钮页面出现个人信息各字段的输入框可供编辑点击收藏、关注、粉丝、订单、行程、美图进入对应的列表界面点击图像左侧按钮进入设置界面1.1.3.1.2 信息修改编号PORTAL003_2优先级一级功能名称对登录用户可进行个性化信息设置，包括：昵称、真实姓名、性别、手机号码、所在城市。操作对象及权限普通公众用户参考界面输入字段描述数据项对应字段约束控件特殊要求昵称NicknameText姓名NameText性别SexText手机PhoneNumberText城市CityText页面操作逻辑描述操作处理逻辑特殊要求点击标签项输入对应文字1.1.3.1.3 我的行程编号PORTAL003_3优先级一级功能名称展示我所有的行程，对每条行程进行管理，包括日期，名称修改及删除该条行程操作对象及权限普通公众用户参考界面数据项对应字段约束控件特殊要求行程规划名称TourName出发日期BeginDate页面操作逻辑描述操作处理逻辑特殊要求点击管理对每条数据进行管理，包括日期，名称修改及删除该条行程点击单条行程跳转页面，显示行程单内的明细项1.1.3.1.4 我的行程详情界面编号PORTAL003_4优先级一级功能名称对我的每条行程进行具体管理，包括：行程跳转，该条行程在地图上的展示，行程名称的修改，行程的预览，单个景区的详情展示，所在地到目的地的地图导航及添加食住行游购娱等选择。操作对象及权限普通公众用户参考界面我的行程详情界面点击我的行程界面右上角地图图标，进入行程地图界面点击我的行程界面右上角铅笔图标，进入行程跳转界面点击我的行程界面行程名称，进入行程名称界面修改行程名称点击我的行程界面单条景点，进入景点详情界面点击我的行程界面汽车图标，进入地图界面，查看地图导航点击我的行程界面右下角+图标，进入添加界面，可添加食住行游购娱的对应地点数据项对应字段约束控件特殊要求行程规划名称TourName每日行程名称BeginDate页面操作逻辑描述操作处理逻辑特殊要求1.1.3.1.5 我的订单编号PORTAL003_5优先级一级功能名称展示我预订过的酒店，门票，线路，商品的订单列表操作对象及权限普通公众用户参考界面我的订单的列表展示我的订单列表，点击单条订单，展示该条订单详情，当订单状态为待支付时，可对该订单取消及支付操作进行支付操作时，跳转支付宝登录界面输入字段描述数据项对应字段约束控件特殊要求订单号码orderNo不为空Text订单类型orderType不为空Number订单价格orderPic不为空订单名称orderName不为空页面操作逻辑描述操作处理逻辑特殊要求点击查询根据搜索条件返回数据点击订单名称跳转到订单商品详情页传入商品ID点击付款进入在线支付页面传入订单号点击取消订单点击去点评可对订单进行点评1.1.3.1.6 我的收藏编号PORTAL003_6优先级一级功能名称对我收藏过的所有旅游6大要素、商铺、商品及足迹的内容进行管理。操作对象及权限普通公众用户参考界面输入字段描述数据项对应字段约束控件特殊要求收藏的类型menuType不为空关联codeCode不为空用户IDUserID不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.3.1.7 我的关注和粉丝编号PORTAL003_7优先级一级功能名称查看我的关注对象及粉丝操作对象及权限普通公众用户参考界面我的关注列表我的粉丝列表点击关注对象及粉丝后，进入他们的个人输入字段描述数据项对应字段约束控件特殊要求数据类型menuType不为空关联codeCode不为空用户IDUserID不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.4 荔波全域旅游指南1.1.4.1 功能设计1.1.4.1.1 旅游动态编号PORTAL004_1优先级一级功能名称荔波旅游新闻，包括节庆活动、通知公告。操作对象及权限普通公众用户参考界面列表页详情页输入字段描述数据项对应字段约束控件特殊要求标题title不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求点击动态或公告跳转到内容详情页传入内容ID1.1.4.1.2 旅游攻略编号PORTAL004_2优先级一级功能名称对荔波旅游吃、住、行、游、购、娱详情的旅游攻略。操作对象及权限普通公众用户参考界面列表页详情页输入字段描述数据项对应字段约束控件特殊要求标题title不为空类型Type不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.4.1.3 旅游游记编号PORTAL004_3优先级一级功能名称对荔波旅游后的游记展示，分为热门游记，最新游记，最赞游记。操作对象及权限普通公众用户参考界面列表页详情页输入字段描述数据项对应字段约束控件特殊要求标题title不为空类型Type不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求点击标题跳转到内容详情页传入内容ID1.1.5 景区、酒店、交通、美食、民宿、娱乐综合服务1.1.5.1 功能设计1.1.5.1.1 景区列表编号PORTAL005_1优先级一级功能名称以列表形式展示所有景区，分为非游不可及全部景区。操作对象及权限普通公众用户参考界面非游不可列表界面全部景区列表界面全部景区列表界面右上侧图标点击，可对显示景区进行条件筛选输入字段描述数据项对应字段约束控件特殊要求景区名称Name不为空标题title不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.5.1.2 景区详情编号PORTAL005_2优先级一级功能名称展示该景区详情。操作对象及权限普通公众用户参考界面景区详情界面景区详情界面点击顶部大图，进入图片预览界面景区详情界面点击周边按钮，进入景区周边列表界面景区详情界面点击地图按钮，进入景区地图界面景区详情界面点击电话按钮，可拨打电话景区详情界面点击景点图标，可跳转景点详情界面输入字段描述数据项对应字段约束控件特殊要求景区名称Name不为空景区编号Code不为空标题title不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.5.1.3 酒店列表编号PORTAL005_3优先级一级功能名称以列表形式展示所有酒店，分为非住不可及全部酒店。操作对象及权限普通公众用户参考界面非住不可列表界面全部酒店列表界面全部酒店列表界面右上侧图标点击，可对显示酒店进行条件筛选输入字段描述数据项对应字段约束控件特殊要求酒店名称Name不为空标题title不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.5.1.4 酒店详情编号PORTAL005_4优先级一级功能名称展示该酒店详情。操作对象及权限普通公众用户参考界面酒店详情界面酒店详情界面点击顶部大图，进入图片预览界面酒店详情界面点击周边按钮，进入酒店周边列表界面输入字段描述数据项对应字段约束控件特殊要求酒店名称Name不为空酒店编号Code不为空标题title不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.5.1.5 交通界面编号PORTAL005_5优先级一级功能名称显示荔波航空线路及汽车客运操作对象及权限普通公众用户参考界面输入字段描述数据项对应字段约束控件特殊要求城市编号cityCode不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.5.1.6 定制行程编号PORTAL005_6优先级一级功能名称定制行程。操作对象及权限普通公众用户参考界面点击右上方完成按钮，完成行程定制，跳转行程详情界面输入字段描述数据项对应字段约束控件特殊要求用户id userID不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.5.1.7 餐饮详情编号PORTAL005_7优先级一级功能名称展示该商品详情。操作对象及权限普通公众用户参考界面输入字段描述数据项对应字段约束控件特殊要求特产名称Name不为空特产编号Code不为空标题title不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.5.1.8 餐饮列表编号PORTAL005_8优先级一级功能名称以列表形式展示商铺。可预定支付操作对象及权限普通公众用户参考界面餐饮列表输入字段描述数据项对应字段约束控件特殊要求特产名称Name不为空标题title不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.5.1.9 娱乐列表编号PORTAL005_9优先级一级功能名称以列表形式展示所有设施，分为非玩不可及更多娱乐。操作对象及权限普通公众用户参考界面非玩不可列表界面更多娱乐列表界面更多娱乐列表界面右上侧图标点击，可对显示娱乐设施进行条件筛选输入字段描述数据项对应字段约束控件特殊要求娱乐名称Name不为空标题title不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.5.1.10 娱乐详情编号PORTAL005_10优先级一级功能名称展示该娱乐设施详情。操作对象及权限普通公众用户参考界面娱乐详情界面娱乐详情界面点击顶部大图，进入图片预览界面娱乐详情界面点击周边按钮，进入酒店周边列表界面娱乐详情界面点击地图按钮，进入娱乐地图界面输入字段描述数据项对应字段约束控件特殊要求娱乐设施名称Name不为空娱乐设施编号Code不为空标题title不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.5.1.11 民宿列表编号PORTAL005_11优先级一级功能名称以列表形式展示所有设施。操作对象及权限普通公众用户参考界面列表界面列表界面右上侧图标点击，可对显示民宿设施进行条件筛选输入字段描述数据项对应字段约束控件特殊要求娱乐名称Name不为空标题title不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.5.1.12 民宿详情编号PORTAL005_12优先级一级功能名称展示该民宿设施详情。操作对象及权限普通公众用户参考界面民宿详情界面详情界面点击周边按钮，进入酒店周边列表界面详情界面点击地图按钮，进入地图界面输入字段描述数据项对应字段约束控件特殊要求娱乐设施名称Name不为空娱乐设施编号Code不为空标题title不为空时间CreateDate不为空内容Content不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.6 地图1.1.6.1 功能设计1.1.6.1.1 地图首页编号PORTAL006_1优先级一级功能名称地图首页。操作对象及权限普通公众用户参考界面插入字段数据描述数据项对应字段约束控件特殊要求城市编号cityCode不为空页面操作逻辑描述操作处理逻辑特殊要求点击地图文字按钮跳转对应景点手绘图1.1.6.1.2 地图搜索编号PORTAL006_2优先级一级功能名称不同类别搜索。操作对象及权限普通公众用户参考界面数据项对应字段约束控件特殊要求景点编号Code不为空页面操作逻辑描述操作处理逻辑特殊要求点及详情介绍跳转景点详情1.1.7 预订功能1.1.7.1 功能设1.1.7.1.1 票务，酒店详情页面编号PORTAL007_1优先级一级功能名称票务，酒店详情界面，可进行预订操作。操作对象及权限普通公众用户参考界面数据项对应字段约束控件特殊要求用户iduserID不为空预订对象编号Code不为空页面操作逻辑描述操作处理逻辑特殊要求点击预订按钮跳转预订界面1.1.7.1.2 票务，酒店订单展示页面编号PORTAL007_2优先级一级功能名称票务，酒店，线路，特产订单展示界面。操作对象及权限普通公众用户参考界面数据项对应字段约束控件特殊要求用户iduserID不为空预订对象编号Code不为空页面操作逻辑描述操作处理逻辑特殊要求支付跳转支付宝登录界面1.1.8 足迹功能1.1.8.1 功能设计1.1.8.1.1 足迹首页编号PORTAL008_1优先级一级功能名称足迹首页，包含：推荐足迹，最新足迹，我的足迹。操作对象及权限普通公众用户参考界面插入字段数据描述数据项对应字段约束控件特殊要求用户iduserID不为空足迹名称 Name不为空发布时间Date不为空 内容Content不为空 图片Image页面操作逻辑描述操作处理逻辑特殊要求点赞点赞按钮变色，显示人数改变收藏收藏按钮变色我的足迹无法收藏评论对该足迹评论可编辑对该足迹编辑只有我足迹可编辑可添加添加足迹1.1.8.1.2 发布足迹编号PORTAL008_2优先级一级功能名称发布足迹。操作对象及权限普通公众用户参考界面发布足迹界面, 添加图片，或照相选择地址选择时间数据项对应字段约束控件特殊要求用户iduserID不为空标题Title不为空文本输入框内容Content不为空文本框输入图片Image不为空地点Address不为空时间Date不为空页面操作逻辑描述操作处理逻辑特殊要求点击发布按钮发布足1.1.8.1.3 足迹详情编号PORTAL008_3优先级一级功能名称足迹详情界面。操作对象及权限普通公众用户参考界面图片展示数据项对应字段约束控件特殊要求用户iduserID不为空标题 Title不为空名称 Name不为空内容 Content不为空图片 Image不为空时间 Date不为空页面操作逻辑描述操作处理逻辑特殊要求图片展示界面保存按钮点击保存图像1.1.8.1.4 足迹路线编号PORTAL008_4优先级一级功能名称足迹路线界面。操作对象及权限普通公众用户参考界面数据项对应字段约束控件特殊要求用户iduserID不为空名称Title不为空图片Image不为空时间Date不为空经纬度Latitudelongitude不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.8.1.5 足迹图片编号PORTAL008_5优先级一级功能名称足迹图片展示。操作对象及权限普通公众用户参考界面数据项对应字段约束控件特殊要求图片Image不为空页面操作逻辑描述操作处理逻辑特殊要求1.1.8.1.6 足迹评论编号PORTAL008_6优先级一级功能名称足迹评论列表页面，可发表评论及回复。操作对象及权限普通公众用户参考界面数据项对应字段约束控件特殊要求用户iduserID不为空名称Name不为空回复Reply时间Date不为空页面操作逻辑描述操作处理逻辑特殊要求2 统出错处理设计2.1 异常处理设计1.不要返回错误码。2.要通过抛出异常的方式来报告操作失败。3.考虑在代码遇到了严重问题且无法继续安全的执行时，通过调用System.Environment.FailFast来终止进程，而不要抛出异常。4.不要在正常的控制流中使用异常，如果能够避免的话。5.考虑抛出异常可能会对性能造成的影响。6.要为所有的异常撰写文档，并把他们作为契约的一部分。7.不要让共有成员根据某个选项来决定是否抛出异常。8.不要把异常作为公有成员的返回值或输出参数。9.考虑使用辅助方法来创建异常。10.不要在异常过滤程序中抛出异常。11.避免显示的从finally块中抛出异常。12.不要为了通报使用错误而创建新的异常类型。13.考虑为程序错误创建并抛出自定义异常。14.不要创建新的异常类型如果对该错误的处理和对框架中已有异常的并没有什么不同。15.要创建新的异常类型来传达独一无二的程序错误。16.避免设计出会导致系统失败的API。17.不要仅仅为了拥有自己的异常而创建并使用新的异常。18.要使用合理的，最具针对性的（最底层派生类）异常。19.要在抛出异常时为开发人员提供非富而有意义的错误消息。20.要确保异常消息的语法正确无误。21.要确保在异常消息中每个句子都有句号。22.避免在异常消息中使用问号或惊叹号。23.不要在没有的到许可的情况下，在异常消息中泄漏安全信息。24.考虑把组件抛出的异常消息本地化。25.不要在捕获具体类型不确定的异常，如Exception。26.不要把任何特殊异常排除在外。27.考虑捕获特定类型的异常如果确实理解该异常在具体环境中产生的原因，并能对错误作出适当的反应。28.不要捕获不应该捕获的异常。应该允许异常沿着调用栈向上传递。29.要在进行清理工作时使用try-finally，避免使用try-catch。使用using来处理实现了IDisposable的对象。30.要在捕获并重新抛出异常时使用空throw，这是保持异常调用栈不变的最好方法。31.不要用无参的catch来处理不符合CLS规范的异常。不派生自System.Exception32.考虑对较低层抛出的异常进行封装如果低层异常对高层没什么意义。33.避免捕获并封装具体类型不确定的异常。34.要在对异常进行封装时为其制定内部异常。35.Exception和SystemException 不要抛出 不要在框架代码中捕获，除非打算重新抛出 避免捕获，除非在顶层的异常处理器。36.不要抛出ApplicationException或从它派生新类。37.