• 请不要在回答技术问题时复制粘贴 AI 生成的内容
niselover
V2EX  ›  程序员

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

  •  
  •   niselover · Aug 27, 2020 · 3346 views
    This topic created in 2109 days ago, the information mentioned may be changed or developed.
    作为后台的小兄弟们,你们最想看到什么样的开发文档呢?
    有没有标准模板或大厂模板推荐学习一下?
    谢谢!
    Supplement 1  ·  Aug 27, 2020
    我司后台开发是看产品经理画的原型文档,接口数据库自己随便设计。感觉很不合理,不太了解其它公司的后台开发看什么样文档呢?
    11 replies    2020-08-28 09:57:25 +08:00
    xomix
        1
    xomix  
       Aug 27, 2020
    ChevalierLxc
        2
    ChevalierLxc  
       Aug 27, 2020
    为什么做,如何做,为什么要这么做,可分为几个阶段做,有什么影响。 写完就差不多了
    raaaaaar
        3
    raaaaaar  
       Aug 27, 2020 via Android
    什么意思,给后台看的,还是后台写的
    pushback
        4
    pushback  
       Aug 27, 2020
    接口文档还是开发文档?
    taogen
        5
    taogen  
       Aug 27, 2020 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  
       Aug 27, 2020
    openapi, swagger?
    tomy0608
        7
    tomy0608  
       Aug 27, 2020
    @ifsclimbing + 1. 开发有这个基本就够了.
    niselover
        8
    niselover  
    OP
       Aug 27, 2020
    @ChevalierLxc #2
    @raaaaaar #3
    @pushback #4

    请教一下,后台需求开发的流程是什么?
    后台需要什么文档来设计接口,设计数据库呢?
    bintianbaihua
        9
    bintianbaihua  
       Aug 27, 2020
    @taogen 可以
    itechify
        10
    itechify  
    PRO
       Aug 27, 2020 via Android
    swagger
    pushback
        11
    pushback  
       Aug 28, 2020
    swagger 是作为后台接口 API 的框架,一般来说有这个就行了,可适当在注解上进行扩展,
    开发流程工作上按原型图和模块来吧,私人随意,一般是主要业务先行于次要业务。
    数据库设计就用 powerdesigner,我目前是比较习惯的,中大型的设计可以用这个。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   1295 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 43ms · UTC 17:24 · PVG 01:24 · LAX 10:24 · JFK 13:24
    ♥ Do have faith in what you're doing.