V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
niselover
V2EX  ›  程序员

[请教] 后台开发文档应该怎么写?

  •  
  •   niselover · 2020-08-27 16:42:26 +08:00 · 2555 次点击
    这是一个创建于 1551 天前的主题,其中的信息可能已经有所发展或是发生改变。
    作为后台的小兄弟们,你们最想看到什么样的开发文档呢?
    有没有标准模板或大厂模板推荐学习一下?
    谢谢!
    第 1 条附言  ·  2020-08-27 18:43:03 +08:00
    我司后台开发是看产品经理画的原型文档,接口数据库自己随便设计。感觉很不合理,不太了解其它公司的后台开发看什么样文档呢?
    11 条回复    2020-08-28 09:57:25 +08:00
    xomix
        1
    xomix  
       2020-08-27 17:15:27 +08:00
    ChevalierLxc
        2
    ChevalierLxc  
       2020-08-27 17:15:38 +08:00
    为什么做,如何做,为什么要这么做,可分为几个阶段做,有什么影响。 写完就差不多了
    raaaaaar
        3
    raaaaaar  
       2020-08-27 17:18:49 +08:00 via Android
    什么意思,给后台看的,还是后台写的
    pushback
        4
    pushback  
       2020-08-27 17:27:27 +08:00
    接口文档还是开发文档?
    taogen
        5
    taogen  
       2020-08-27 17:47:22 +08:00 via Android
    Software Design Document ??

    1. Introduction
    1.1 Purpose
    1.2 Scope
    1.3 Audience
    1.4 Document Organization
    1.5 Acronyms, Abbreviations, Terms and Definitions
    1.6 References

    2. Design Considerations
    2.1 Design Assumptions, Dependencies and Constraints
    2.1.1 Assumptions and Dependencies
    2.1.2 Design Constraints
    2.2 Design Goals and Guidelines
    2.2.1 Reliability
    2.2.2 Usability
    2.2.3 Portability
    2.2.4 Extensibility

    3. Architecture Design
    System Architecture
    Hardware Architecture
    Software Architecture
    Information Architecture
    Internal Communications Architecture
    Security Architecture
    Performance

    4. System Design
    System User Cases
    System Modules
    Database Design
    System Interface Design
    User Interface Design

    5. Detailed Design
    xxx Module
    ifsclimbing
        6
    ifsclimbing  
       2020-08-27 17:48:17 +08:00
    openapi, swagger?
    tomy0608
        7
    tomy0608  
       2020-08-27 18:25:16 +08:00
    @ifsclimbing + 1. 开发有这个基本就够了.
    niselover
        8
    niselover  
    OP
       2020-08-27 18:44:51 +08:00
    @ChevalierLxc #2
    @raaaaaar #3
    @pushback #4

    请教一下,后台需求开发的流程是什么?
    后台需要什么文档来设计接口,设计数据库呢?
    bintianbaihua
        9
    bintianbaihua  
       2020-08-27 21:12:02 +08:00
    @taogen 可以
    oneisall8955
        10
    oneisall8955  
       2020-08-27 22:17:12 +08:00 via Android
    swagger
    pushback
        11
    pushback  
       2020-08-28 09:57:25 +08:00
    swagger 是作为后台接口 API 的框架,一般来说有这个就行了,可适当在注解上进行扩展,
    开发流程工作上按原型图和模块来吧,私人随意,一般是主要业务先行于次要业务。
    数据库设计就用 powerdesigner,我目前是比较习惯的,中大型的设计可以用这个。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1824 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 34ms · UTC 16:35 · PVG 00:35 · LAX 08:35 · JFK 11:35
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.