写架构设计文档有感

又一次写架构设计文档,现在至少也是写过6、7次架构设计文档了,每次写架构设计文档自己都有感觉,每次的想法都不同,所以每次的目录结构都有所改动(尽管公司有规范,但我会按自己的理解进行重整),应该说觉得写了这么多次以来,每次都觉得当时的那次是写的最好的,慢慢的也明白自己在写架构文档方面已经在不断的进步了,其实我认为,能不能写出架构文档很能反应出设计师是否真正的掌握了架构的设计,很多时候觉得架构设计文档没什么写的其实已经表明设计师其实对架构并不是那么的理解,在理解了后要写出来真的是一发不可收拾,都可以写很多,因为要明白架构设计文档的对象,架构文档的作用,尽管现在很多情况下架构文档都是拿来糊弄用户,但我觉得作为设计师还是应该写出一份合格的架构设计文档,架构设计文档对于整个项目的实现具有很大的指导意义,写架构设计文档能让设计师真正的仔细梳理整个系统的架构设计,不会是那种临时突然想出的东西。
这次在写架构设计文档中也开始仔细的考虑架构设计文档到底需要体现什么呢?其次需要明白到底何谓架构,其实我觉得一个形象的说法就是骨架,每个人、每栋房子都需要有骨架,基于这个骨架可实现用户的功能需求以及非功能需求,那么就可以说这是个成功的架构,我觉得在架构设计文档中最重要的是体现出对于系统需求的共性的分析,抽象形成系统的底层支撑子系统(注意,这个子系统是系统业务的共性,而不是具体的功能模块,具体的功能模块是基于此支撑子系统进行搭建的),同时列出系统的非功能性需求,提出在架构级别的应对策略,在经过这个架构分析过程后,根据系统结构是C/S、B/S可提出一个底层架构体系,如B/S采用MVC思想搭建的架构体系,在M进行划分形成N层体系,在做出了底层架构体系设计后将之上架构分析中产生的支撑子系统与之进行融合,同时结合非功能性需求的应对策略,在这个情况下系统的架构图就产生了,^_^,经过这样的过程你系统的架构图就不会是无缘无故产生出来的,在架构图产生后此时就需要做技术的映射,因为在架构图的底层架构体系中列出来的是layer,那么每个layer其设计模型是怎么样的、每个layer的依赖是怎么解决的,在解决完了这个部分后需要对之上的支撑子系统进行设计模型、接口的描述,在完成了这些后即可绘制系统的部署视图、逻辑视图以及物理视图,重要的是需体现出整个系统的需求是如何基于这个架构体系来实现的,在完成了之上的过程后整个架构设计过程可以算是完成了大半部分,在这之后进行支撑子系统的模块划分以及系统功能模块的划分,划分原则依据功能内聚来进行,同时也需考虑架构体系的设计约束,在划分完毕后即产生了系统的模块视图,同时需标明模块的接口关系,在此图绘制完毕后按模块对模块的职责进行描述,同时对其接口做出规范,至此整个架构设计文档才算是比较完整的完成了,^_^,这样写下来我想这份架构设计文档想薄都难呀,架构设计文档作为整个系统后续的设计约束以及方向指导而存在。
这是在这次写架构设计文档后的一些感想,总体来说我觉得最重要的仍然是需要明确的知道架构设计文档的目的,何谓架构,架构设计的过程,架构对于需求的满足,在这之后可进行模块的概要设计,模块的概要设计其实同样是一个由繁化简的过程,产生出关键类以及类的接口设计,详细设计则是具体的对象设计以及接口实现。

posted on 2005-09-22 22:19 BlueDavy 阅读(18242) 评论(43)  编辑  收藏 所属分类: 系统设计

评论

# re: 写架构设计文档有感 2005-09-22 22:46 scud(飞云小侠)

提纲有吗? 嘿嘿

参考参考  回复  更多评论   

# re: 写架构设计文档有感 2005-09-23 22:16 Programmer's Life

^_^,提纲很简单的:
一、概述
二、目的
三、项目背景
四、系统建设目标
五、参考资料
六、架构设计
6.1 架构分析
6.2 设计思想
6.3 架构体系
6.4 系统视图
6.5 模块划分
6.5.1 模块描述
6.5.2 模块接口

呵呵,关键是整个文档要描述清楚,目的结构大致就是如此而已  回复  更多评论   

# re: 写架构设计文档有感 2005-10-25 16:48 帅哥烦恼多

能给一份架构文档学习吗?谢谢  回复  更多评论   

# re: 写架构设计文档有感 2005-10-25 16:49 帅哥烦恼多

邮箱:peopleyl@hotmail.com
转型学习中  回复  更多评论   

# re: 写架构设计文档有感 2005-11-18 10:05 欢迎到武汉去哦:)

如果可以的话,希望站长能发给我一份完整的文档(包含内容,不只是结构)做参考
不胜感激:wangxiaolei2@hotmail.com  回复  更多评论   

# re: 写架构设计文档有感 2005-11-18 11:34 Programmer's Life

...
完整的文档我这基本都是公司内部的,商业性质的,我觉得我的目录结构里已经说明了每个部分需要描述的内容了!  回复  更多评论   

# re: 写架构设计文档有感 2006-07-21 15:02 yesun

dyesur@hotmail.com
谢谢
一直处于理论阶段,没有真正动手写过,希望能得到一份真正的设计文档作参考,谢谢  回复  更多评论   

# re: 写架构设计文档有感 2007-05-18 10:41 netie

真希望能给我发一篇真实的项目例子,让我学习学习,netice@tom.com  回复  更多评论   

# re: 写架构设计文档有感 2007-05-24 14:44 jallock17@126.com

我认为架构有要分清是业务架构还是系统架构.两个的针对性是不一样的,
所以目录,提纲不重要,里面的差键看你的目标,你写架构文档是为什么服务.
应该回到架构设计上来,文档只是设计思路的一个展现方式而已,相信才写的时候多数人都有过这样的体验:写篇文档就好像是在凑数。
说了堆废话。
业务架构设计重要的是抛开系统与你的软件、计算机,完全深入领域,站在用户角度去理清业务,所以其核心是下面7个问题:
1、工作目标是什么?
2、职能是什么?
3、具体办法是什么?
4、所存在的主要问题和困难是什么?
5、改革和发展方向是什么?
6、关注的焦点是哪些?
7、业务定位是什么?
回答了上述问题后,你就能够清楚的就业务目标、业务范围、业务功能、业务流程做出规划与回答。
系统架构.....
  回复  更多评论   

# re: 写架构设计文档有感 2007-05-24 14:46 jallock17@126.com

上边没写完
其实重要的是每个步骤都要理清你的目标,你做这个是为什么服务,  回复  更多评论   

# re: 写架构设计文档有感 2007-06-12 12:13 油条

我们在做架构设计文档一般分为两个层面:
1 技术架构设计。
从技术的解决上来讨论,着重点是讨论采用什么样的技术,如何分层,采用了那些好的技术特性。采用这些技术特性会为我们的工作带来哪些好处。为什么要这么做。
2 体系结构设计。
从业务需求的角度来出发,理清物理结构图和逻辑结构图。
划分每个子模块,为什么要这么划分,以及各个只模块之间的交互关系,每个子模块具有哪些接口。
这个是要求对需求的把握十分到位,是用设计对需求的映射,重点是要理清整个系统的脉络。

  回复  更多评论   

# re: 写架构设计文档有感[未登录] 2007-12-28 10:14 ajax

你好,小弟最近要写份架构,但不知如何下手,希望能得到一份参考范文,学习学习,谢了!
邮箱:wyiyong@hotmail.com
  回复  更多评论   

# re: 写架构设计文档有感[未登录] 2007-12-29 16:52 abc

你好,最近要写份架构,但不知如何下手,希望能得到一份参考范文,学习学习,谢了!
邮箱:zhangxiaow1983@163.com
  回复  更多评论   

# re: 写架构设计文档有感[未登录] 2008-01-09 09:45 aa

你好,最近要写份架构,但不知如何下手,希望能得到一份参考范文,学习学习,谢了!
邮箱:chenhongbiao1980@163.com
  回复  更多评论   

# re: 写架构设计文档有感 2008-02-19 17:32 求学

jallock17@126.com 说的很好,能否给我一点资料看看?
zeng.shuxiong@163.com  回复  更多评论   

# re: 写架构设计文档有感[未登录] 2008-02-21 22:50 REX

rex__@126.com
能给一份例子学习一下吗
不胜感谢  回复  更多评论   

# re: 写架构设计文档有感 2008-02-28 16:13 eqiang8271@163.com

我也计划写个B/S的架构 ,如果可以能给我发一个范例最好了,万分感谢!
eqiang8271@163.com  回复  更多评论   

# re: 写架构设计文档有感 2008-03-18 15:57 亢文才

我要写个B/S的架构如果可以能给我发一个范例最好了,万分感谢!
kwchappy@163.com  回复  更多评论   

# re: 写架构设计文档有感[未登录] 2008-04-10 23:00 super

我也渴望有一个示范。谢谢!
szerlei@126.com  回复  更多评论   

# re: 写架构设计文档有感 2008-04-17 15:13 朱春

对我们这些没有真正写过设计文档的人来说,看看样本是最实际的啊,希望能把你修改过的文档发给我们看看,从你的思想上看你的层次很思想都很高了,谢谢  回复  更多评论   

# re: 写架构设计文档有感 2008-04-17 15:14 朱春

我的邮箱:muchun1983@126.com  回复  更多评论   

# re: 写架构设计文档有感 2008-06-25 14:47 剑圣

我也要写一份软件架构文档,想了很久,还是觉得无从下手,主要是不知道怎么来描述架构,和架构文档应该表达,或者怎样来表达,高手可以发一份文档让江湖小弟来学习吗,邮箱 huhengliang@sina.com 谢谢  回复  更多评论   

# re: 写架构设计文档有感 2008-07-28 10:22 渴求实际文档

本人一直想得到一份确实有价值的设计文档,能发一份给我感激不尽,绝对只供学习使用,

zglboygod@hotmail.com  回复  更多评论   

# re: 写架构设计文档有感 2008-07-28 17:14 Jack.Wang

很好,LZ 很强大! 能否多发些架构体会的文章! 小弟谢谢了!  回复  更多评论   

# re: 写架构设计文档有感[未登录] 2008-08-06 08:36 wei

写得不错,不过最好对每个提纲再加点说明就更清楚了,比如说这个标题是要写此什么内容,要注意什么事项等等。以前在旧公司也写过不少文档,跳槽后要写设计文档时只好上网搜了,久了不写对每项内容都有些生疏了。  回复  更多评论   

# re: 写架构设计文档有感[未登录] 2008-10-02 13:10 wei

楼主看来很利害呀,我也在写设计文档,按你的提纲写了文档,大概的框架都用图的方式写出来了,就是写不长啊,要我加些费话进去,或者加些与框架无关的内容,我又不能认同,能不能指点一下。weishengf@163.com  回复  更多评论   

# re: 写架构设计文档有感 2008-12-24 18:01 扳机

很精彩,俺还没写过呢,很希望楼主能给偶发一份,chinarenhs@163.com
不胜感激,小弟先谢了  回复  更多评论   

# re: 写架构设计文档有感 2009-01-18 15:17 red_hill@126.com

给小弟一份
谢谢  回复  更多评论   

# re: 写架构设计文档有感 2009-04-15 00:18 蒋耘

请问架构设计文档和概要设计文档以及详细设计文档有什么区别?  回复  更多评论   

# re: 写架构设计文档有感 2009-07-08 22:51 lzb

不胜感激,小弟先谢了,liuzibol@tom.com  回复  更多评论   

# re: 写架构设计文档有感[未登录] 2009-07-10 19:08 pony

一直在关注你的博客,对一个刚开始入门架构的人非常有用
impony@gmail.com多谢  回复  更多评论   

# re: 写架构设计文档有感 2009-07-15 12:08 大兵

很想学习一下,感谢,shidabing666@163.com  回复  更多评论   

# re: 写架构设计文档有感 2009-07-20 11:17 迷茫

最近一直在研究,希望楼主能给小弟一份参考一下,谢谢了。
dfbhfhda8@163.com  回复  更多评论   

# re: 写架构设计文档有感 2009-09-07 15:58 qk

能发我一份吗?不慎感激。scjp_first@tom.com  回复  更多评论   

# re: 写架构设计文档有感 2009-10-11 13:32 我是大强

我觉得楼主的架构好像更多在于程序上,这固然是架构的很重要一部分,但是架构应该还需要从数据视图、部署视图、用例视图等方便来剖析。
刚开始学习写架构文档,有很多的疑问,请见谅!也欢迎阁下交流:hustlxjaw@163.com  回复  更多评论   

# re: 写架构设计文档有感 2009-10-20 16:05 一天天

你好,正在做系统架构设计,学习中,是否有相关完整的架构设计文档可以共享呢:ybyangcn@163.com  回复  更多评论   

# re: 写架构设计文档有感 2010-09-19 10:55 架构学习

@一天天
你好,小弟最近再学架构,不知道如何下手,能否发一份完整的架构文档范例给我,谢谢了。feipengmeng@126.com
  回复  更多评论   

# re: 写架构设计文档有感 2011-04-21 16:32 firerat

您好,我最近需要份架构设计文档,博主可以发份我么,谢谢!
邮箱:lukai_rat@163.com  回复  更多评论   

# re: 写架构设计文档有感 2011-05-06 17:50 tudou

正在学习中,头疼啊,博主可以发份我么,谢了!
邮箱:tudou08@qq.com  回复  更多评论   

# re: 写架构设计文档有感 2013-03-07 19:48 一米,希望

你好,最近公司让写一份架构设计文档,不知道如何下手,能否发一份完整的架构文档范例给我 mlg_wing@sina.com  回复  更多评论   

# re: 写架构设计文档有感 2013-04-25 16:15 xiaochanzi

你好,最近经理让我写份技术架构文档,毫无头绪,能不能给我发份完整的模板范例给我,601697537@qq.com,非常感谢。  回复  更多评论   

# re: 写架构设计文档有感 2015-07-09 11:20 Tang Zhigang

看了您的后感,我非常清晰的感觉到了架构思路。 小弟从没写过架构设计,真心求高手也能发我份完整的文档范例。 sapphire1202@163.com ,非常感谢。  回复  更多评论   


只有注册用户登录后才能发表评论。


网站导航:
 

公告

 









feedsky
抓虾
google reader
鲜果

导航

<2005年9月>
28293031123
45678910
11121314151617
18192021222324
2526272829301
2345678

统计

随笔分类

随笔档案

文章档案

Blogger's

搜索

最新评论

阅读排行榜

评论排行榜