哪位大佬做过政府项目,要求必须有软件设计文档,这个东西到底有人看没? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
iloveyou
V2EX    外包

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

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

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

    这玩意最大的用处就是用来挡锅。你把软件设计里的各种坑提前在文档里说清楚,然后需求也看过这文档通过了,那么以后出现坑就可以说:“这个问题我们在文档 X 章节 Y 段落已经告知过了,优劣评估也是当时接受的”
    xiaojie668329
        35
    xiaojie668329  
       2024-12-24 12:48:44 +08:00   1
    不管看不看但得有,不然审计起来找你麻烦,项目过了很久来要你补东西。
    我们做个很大的 gov 项目,结束了两年。一开始说给钱,后来变成义务。现在不仅没钱,回头起诉我们赔钱。
    XTTX
        36
    XTTX  
       2024-12-24 13:07:12 +08:00   1
    小项目有没有独立审计?
    1 。跟甲方的头搞好关系,得到首肯
    2. 跟对接的小兵搞好关心, 直接问他们要写成什么样,怎么样减轻他们的工作量。
    3. 别人说啥就是啥吧, 毕竟还有几年后的 20%保证金。
    4. 后续什么 2 期 3 期,维护才是有嚼头的
    Hansay99
        37
    Hansay99  
       2024-12-24 18:15:27 +08:00   1
    做过很多政府类项目 软件设计文档还是得写的 虽然没人看 但要靠这个吹牛
    realpg
        38
    realpg  
    PRO
       351 天前   1
    @laobobo #7
    电网都会看 甚至会给你挑毛病 提整改意见 还不是瞎提的
    realpg
        39
    realpg  
    PRO
       351 天前   1
    @sagaxu #26
    真出重大问题时候 就会看了

    如果是软件设计问题,或者设计和实际代码逻辑不一致,法院甚至会支持主张赔偿直接无法追回的损失

    如果大范围不一致,纯脱离软件的糊弄文档,甚至可能以合同诈骗 诈骗 导致经侦上门 虽然最后大概率能花钱平事

    某地医保局有过先例的
    SageXiong
        40
    SageXiong  
       351 天前   1
    上面大家都讲了很多了,这些文件在某些项目里面,也可以算是付款节点的交付文件,评审通过了就给钱的,还是要仔细做呀
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2797 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 25ms UTC 12:29 PVG 20:29 LAX 04:29 JFK 07:29
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86