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

哪位大佬做过政府项目,要求必须有软件设计文档,这个东西到底有人看没?

  •  
  •   iloveyou · 16 小时 6 分钟前 · 1488 次点击
    现在做政府项目天天写概要设计、详细设计、接口设计烦死了,已经好久没写过代码了。这东西是不是就是个形式,有人看吗?
    37 条回复    2024-12-24 18:15:27 +08:00
    iloveyou
        1
    iloveyou  
    OP
       16 小时 2 分钟前
    系统已经开发完了,现在是中标后需要补写这些文档交给甲方,甲方会看这个东西吗?
    iyiluo
        2
    iyiluo  
       16 小时 2 分钟前   ❤️ 1
    你这啥公司?稍微大点的正规项目都要这些材料吧?和形式没啥关系,就是软件工程的硬性要求文档
    gxt92
        3
    gxt92  
       15 小时 59 分钟前   ❤️ 1
    基本都要,而且审计会看不能太糊弄
    gregy
        4
    gregy  
       15 小时 58 分钟前   ❤️ 1
    看运气,也看甲方心情,一般不会细看。
    大概的浏览一下,如果糊弄的地方被发现了。那就开始进行挑刺模式了。
    甲方气不顺,那没问题也会给你找出来问题。
    iloveyou
        5
    iloveyou  
    OP
       15 小时 55 分钟前
    好吧,那我还是认真写吧,之前都互联网行业敏捷开发。
    tcper
        6
    tcper  
       15 小时 53 分钟前   ❤️ 1
    把目录结构放进去,让 ai 帮你写不就完事了,自己调整一下格式就行了
    laobobo
        7
    laobobo  
       15 小时 45 分钟前   ❤️ 1
    没人看,之前做一个电网的,需求文档,设计文档等等写了厚厚的好几本,谁 TM 能看完
    iloveyou
        8
    iloveyou  
    OP
       15 小时 43 分钟前
    @tcper 谁不想用 ai 呢,但是没找到擅长生成 word 文档的,您有推荐的吗
    yxlcareme
        9
    yxlcareme  
       15 小时 41 分钟前   ❤️ 1
    明确告诉你,前几年只要写了有这个东西一般不会看详细内容,所以没啥事,近两年各个部门资金收缩,审计会查的很严,建议 op 还是认真写一下吧。
    iloveyou
        10
    iloveyou  
    OP
       15 小时 41 分钟前
    @laobobo 我估计细节没人看,但是内容量和形式一定要到位
    retrocode
        11
    retrocode  
       15 小时 40 分钟前   ❤️ 1
    肯定要的, 政府项目交付后基本长时间不更新, 不留文档就是屎山, 这个糊弄不了的, 交付的时候至少得把大致流程和接口文档给出来, 最少得有个 Swagger 吧
    miscnote
        12
    miscnote  
       15 小时 37 分钟前   ❤️ 1
    我们做电力行业,我想说的是:甲方会认真看。
    paradoxie
        13
    paradoxie  
       15 小时 32 分钟前   ❤️ 1
    把功能结构做成 excel ,然后尽可能描述一下功能,塞给 ai ,告诉他你在用这个 excel 准备干什么,让他帮你处理那些车轱辘话,然后你复制下来过两遍,删掉跳脱的部分就行了
    billbob
        14
    billbob  
       15 小时 31 分钟前   ❤️ 1
    @iloveyou 现在都会看,比以前正规了,而且会有第三方专业公司评审,我们项目连漏洞都给找出来了,还给了修补的建议.
    有些比较重要的系统甚至都会审查代码.这东西就是一边写代码一边把代码 doc 加好,现在有 AI 这个更方便了.
    最后使用工具生成,美化
    joyhub2140
        15
    joyhub2140  
       15 小时 25 分钟前   ❤️ 1
    据我了解甲方的尿性,看可能不会认真看的,人家未必有专业人士呀,但这些东西一定不能缺的,因为事后如果有问题,起码官方有东西可以提供查证,不管承建方有无倒闭,这些东西都要留底的,事实上官方办事一切东西都需要留档,你只要理解这个就行了。
    once111
        16
    once111  
       15 小时 25 分钟前   ❤️ 1
    看来做电力的同行蛮多,甲方提到的文档材料还是必须要写的,内容可以稍微水一点,但是不能没有,尤其是厚度一定要够
    iloveyou
        17
    iloveyou  
    OP
       15 小时 25 分钟前
    @yxlcareme 好,已老实
    nicocho
        18
    nicocho  
       15 小时 18 分钟前 via Android   ❤️ 1
    后续迭代,或者维护,总要有个参考吧
    tongbufu
        19
    tongbufu  
       15 小时 17 分钟前 via iPhone   ❤️ 1
    来日本接受一下毒打
    Bootis
        20
    Bootis  
       15 小时 14 分钟前   ❤️ 1
    @iloveyou #8 写 markdown 转 word 不就完事了,把格式模板和需求描述清楚不是轻轻松松
    EliStone
        21
    EliStone  
       15 小时 13 分钟前   ❤️ 1
    这些必须要有,而且要多(尽可能的多详细),排版格式什么的都要注意,但是一般没人看 ,必须要有
    Mogugugugu
        22
    Mogugugugu  
       15 小时 10 分钟前   ❤️ 1
    不怕一万就怕万一,你可以不写,但是万一被审计抓到了,寄。
    y741105621
        23
    y741105621  
       15 小时 10 分钟前   ❤️ 1
    我可以不看,但不能没有。
    hafuhafu
        24
    hafuhafu  
       15 小时 5 分钟前   ❤️ 1
    肯定要看的啊。
    你们难道不是先出文档,然后相关人员根据文档开会评审,评审过了才能往下推进吧。
    没评审这个环节的话就没啥实际意义了,留档合规而已。
    TechOrange
        25
    TechOrange  
       15 小时 2 分钟前   ❤️ 1
    完成了做文档不是更容易吗?万事开头难,收尾工作加把劲
    sagaxu
        26
    sagaxu  
       15 小时 0 分钟前   ❤️ 1
    概要设计,详细设计,逻辑设计,物理设计,接口设计...
    架构图,用例图,时序图,状态图,流程图,活动图...

    虽然甲方不看,但是必须得有,他们还会打印出来,有的项目打印一下 A4 纸得有几千页
    243205964
        27
    243205964  
       14 小时 59 分钟前   ❤️ 1
    验收的时候会看,而且要改很多次,上次接到这种活文档写吐了。
    shadowyue
        28
    shadowyue  
       14 小时 56 分钟前   ❤️ 1
    写呗,说不定几千万年以后外星人来考古发现你的文档,肯定认认真真研究,卧槽这是什么
    xiaoyu03
        29
    xiaoyu03  
       14 小时 53 分钟前   ❤️ 1
    我们都是 JC 的项目,文档都要有比如操作文档界面都得对的上,数据库文档表结构也得对的上等等。。至于内容的详细程度倒是不是十分的严格。也可能我们公司的商务还可以。。
    ACCI
        30
    ACCI  
       14 小时 52 分钟前   ❤️ 1
    这些文档必须得有....
    zsc8917zsc
        31
    zsc8917zsc  
       14 小时 45 分钟前   ❤️ 1
    等真出了事儿,就知道这些文档的重要性了~
    ovtfkw
        32
    ovtfkw  
       14 小时 45 分钟前 via iPhone   ❤️ 1
    @paradoxie #13 ai 能传 excel 文件?
    takanashisakura
        33
    takanashisakura  
       14 小时 41 分钟前   ❤️ 1
    我不理解哈,我是说如果,如果开发期间什么文档都没有留,只有代码形成,那后续开发维护不是跟吃了屎一样难受吗?
    lambdaq
        34
    lambdaq  
       14 小时 37 分钟前   ❤️ 1
    以前我也不明白这玩意有啥用。现在明白了

    这玩意最大的用处就是用来挡锅。你把软件设计里的各种坑提前在文档里说清楚,然后需求也看过这文档通过了,那么以后出现坑就可以说:“这个问题我们在文档 X 章节 Y 段落已经告知过了,优劣评估也是当时接受的”
    xiaojie668329
        35
    xiaojie668329  
       13 小时 47 分钟前   ❤️ 1
    不管看不看但得有,不然审计起来找你麻烦,项目过了很久来要你补东西。
    我们做个很大的 gov 项目,结束了两年。一开始说给钱,后来变成义务。现在不仅没钱,回头起诉我们赔钱。
    XTTX
        36
    XTTX  
       13 小时 28 分钟前   ❤️ 1
    小项目有没有独立审计?
    1 。跟甲方的头搞好关系,得到首肯
    2. 跟对接的小兵搞好关心, 直接问他们要写成什么样,怎么样减轻他们的工作量。
    3. 别人说啥就是啥吧, 毕竟还有几年后的 20%保证金。
    4. 后续什么 2 期 3 期,维护才是有嚼头的
    Hansay99
        37
    Hansay99  
       8 小时 20 分钟前   ❤️ 1
    做过很多政府类项目 软件设计文档还是得写的 虽然没人看 但要靠这个吹牛
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1133 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 23ms · UTC 18:36 · PVG 02:36 · LAX 10:36 · JFK 13:36
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.