前阵子负责一个接口项目的开发，虽然技术上没有太大问题，但过程并不顺利。现在总结一下经验上的不足：
一是，前期没有明确的分析文档、用例图和活动图，为了让快点看到成果，只凭着简单的需求文档进行开发。
二是，中期没有补上缺失的文档，而是在原来代码上修修补补，最后由于变化很大，所以基本上完全重构。
三是，给潜在客户的文档不明确方向，技术上太细致化，而且没有一个明确的世界观，不能在一个比较高的层面上表现接口的功能。
四是，接口散乱，没有统一的中心流程，虽然可以用，却经常走入死胡同。
建议：
前期文档一定要到位，要有分析文档，用例和流程图、活动图要画出来；接口的提供方式要有一个明确的世界观，方式统一，实用；要有一个中心流程，把所有接口绑在一起的一个流程；需要能够站在一定的业务高度上看待接口。