撰写说明定义

一，总则

• 业务优先于需求，
• 需求优先于功能，
• 功能优先于交互，
• 交互优先于视觉。

二，目标

• 旨在对APP项目的业务架构&产品流程&功能需求做详细的介绍，为产品后续的需求、设计、开发、测试、上线提供依据。
• 向项目组成员(项目经理、开发、测试、运营)传达产品的业务信息与需求细节。
• 管理需求，进行归档，为后续需求迭代与变更提供依据。
• 实现项目的规范化管理

三，撰写说明

• 只有一种输出物，在线原型。
• 只用原型传达思想和表意，不过度考虑视觉呈现。
• 逻辑确定后不经常改动，如有必要上线前统一和前端对照并修改。
• 内容文案是否经得起推敲，顶部标题以及按钮文案以及各种小提示是否简洁清晰。
• 内容结构：一级目录使用"一"，二级目录使用"1"，三级目录使用"③"。
• 元件样式和交互的通用规则，请写到全局规范。其他写到对应的元件逻辑中。
• 写的逻辑禁止不确定字样(也许/可能/maybe/考虑/好像/类似/暂时/待定/等等/像/真的/？)
• 所有变量统一使用红色表示并且配上说明，比如满x元减x元。
• 英文单词尽量小写，易识别。除非是约定俗成的词语，比如iOS、Android。
• 双引号&单引号&小括号不使用全角，只有半角。

四，需求描述原则

• 表述清楚需求的位置是在什么位置，比如"x"页面、还是"x"页面的"x"元件。
• 需求是新增"x"功能、还是修复"x"bug、还是优化"x"功能。

五，技术处理原则

• 表述清楚需求的位置是在什么位置，比如"x"页面、还是"x"页面的"x"元件。
• 需求是新增"x"功能、还是修复"x"bug、还是优化"x"功能。

六，核心模块

• 页面，写在Axure的Pages中。生成原型后请点击左侧Pages进行查看。
• 交互，写在Axure的Interaction中。生成原型后请点击左侧Pages中的链接图标进行展示和隐藏。
• 逻辑，写在Axure的Notes中。生成原型后请点击左侧Notes后查看，或者点击右侧元件旁边的图标进行查看。

元件的逻辑有5种，具体如下：
• 功能逻辑：详细讲解该功能的逻辑。
• 交互逻辑：对页面之间的相互跳转进行说明。
• 视觉逻辑：对颜色，对图标的要求。
• 业务逻辑：讲一下该功能对应着什么业务。
• 技术逻辑：有些逻辑可能用技术语言描述更清楚一点，以及对技术有特殊的要求。

七，关于命名

• 动作，状态的命名一定要区分，比如删除是动作，已删除才是状态。
• 动作的命名一般是"操作+名词"，比如修改文章
• 条件的命名一般是是否怎么样。
• 功能的命名要么是名词，比如购物车；要么是动宾短语，比如确认订单。

八，使用Axure设计原型的准则

• Axure中页面结构的PageTitle尽量和编辑区页面标题保持统一或相似。
• 产品层面的一个功能页尽量对应着Axure的一个Page。如果功能确实复杂，请拆分功能到到多个页面。
• 善用母版，中继器，动态面板，自制元件库。
• 元件的命名可以参考同类型产品的Top3
• 设置页面背景色为灰色，纯白色对大家的视力不好。
• 如果使用系统自带元件，则触发区域=元件范围
• 如果UI单独设计了元件样式(比如单选框，复选框)，则需要PD标注点击范围，然后RD用代码自定义触发区域。

九，注意事项

• Axure中的长度单位是px，请注意不是其他单位。
• RP文件请使用字母数字命名而不是汉字，以免生成网址分享给他人的时候无法使用(比如qq和微信无法识别)
• 页面命名最好都用英文，以防中文在解压时出现乱码，注意编码即可。
• APP主页面不要用index来命名，否则打开Index时默认隐藏侧边栏，后续无法复制URL。
• 原型设计尺寸大小取决于选择的演示方式，比如iPhone6可设置375*647，并设置演示宽度为devide-with即可。由于Axure导出的原型在iOS上不处理statusbar，需要在高度上减去statusbar的高度20，则为375*647。