如何撰写开发哥哥喜爱的交互文档

交互文档的意义

交互文档是产品需求与设计思路的完整呈现，能够帮助团队各角色了解产品目标，明确设计目的。能够在项目开发过程中，提高对设计的还原度，降低沟通成本，提高各方协作效率。一份好的交互文档就像交互设计师自己的产品一样，有它需要服务的目标人群。

产品：更加关注核心交互流程是否充分满足产品需求；

视觉：控件样式及页面展现；

开发：控件交互、页面展示、页面跳转、页面加载方式、异常情况处理等页面实现逻辑；

测试：场景是否考虑周全、异常情况是否覆盖、是否受设备限制等所有容易遗漏的问题。

文档书写及注意事项

怎样的文档组成才能达到这样的目标呢？下面将从几个方面介绍文档的组成及书写注意事项。

文档结构

设计方案及交互说明

文档管理

文档结构

文档结构一般包括文档名称、修订记录、全局性产品逻辑 、通用交互说明 、交互设计方案 、飞机稿（设计师备份）。

1.文档名称：版本号+日期+需求名称，比如【V3.0.0_0105_手机账号体系】，方便查找、管理。

2.修订记录 ：一般从开始开发到项目上线过程中,交互文档会根据项目需要有所调整。各角色需要通过修订记录对修改内容及时间点有清晰认识，明确分工方便协作。因此修订记录需要明确修订日期、修改or新增内容概览、对应各角色责任人。

3.全局性产品逻辑：包含产品通用的名词解释、重点业务逻辑说明、推送、后台需求等，这些除页面流程信息外的内容也统一管理避免遗漏。此部分可由产品同学统一撰写维护。

4.通用交互说明：包含设计稿中通用交互规则，如输入框交互逻辑、加载方式等页面通用交互。在实际项目中，交互设计师可以在交互初稿输出后，对项目中通用的交互规则逻辑进行梳理。通用交互能够保证设计体验的准确一致，更好的实现设计组件化，也可以提高各角色协作效率。

设计方案及交互说明

设计方案呈现结构应包含：标题、责任人、设计目标、页面编号、页面、产品需求、交互说明 。

如何画交互方案相信设计师都有自己的方法，这里列举一些需要注意的点。

1.交互逻辑考虑周全

经常有同学困惑如何解决考虑不周全的问题，此处推荐MECE分析法——相对独立，完全穷尽。在输出方案及撰写说明过程中，尽量保障各部分之间相互独立，所有部分完全穷尽。

2.异常情况避免遗漏

可以将异常情况如数据为空、数据获取失败、断网、服务器异常、设备限制、权限等异常情况整理成表格，以自查表的形式备份。在正常流程梳理结束后参考自查表开始自查，整理所有的异常情况。

3.不同需求对应不同的交互方案展现形式

a.页面优化，尽量放线上对比图，明确更改点；

b.新增功能，需要清晰的流程图；

c.大型功能，注意拆分细节任务流，方便协作 。

4.交互说明注意点

a.说明注意措辞，描述尽量统一语法。如相同的控件、交互动作用同样词汇表达，减少误解；

b.语句表达简单明确，让交互逻辑清晰易懂；

c.页面之间有跳转联系应标注清楚页面编号，方便查找。

文档管理

1.文档修改

文档修改对应更新修改记录、交互说明。交互说明中需明确添加修改或新增标签及日期，方便相关人员第一时间获取及快速查找相关信息。

2.消息同步

可以通过邮件、讨论组等方式第一时间周知相关角色避免遗漏。

3.文档备份

随着不断的迭代，产品重要页面或流程会记录在不同的交互文档中，这时可以新建一份文档记录页面迭代。根据版本号及修改点对文档进行备份整理，方便设计师对项目进行跟进管理。

---END---