想开发一个ruby on rails版的JIRA,有没有市场价值暂不考虑,主要是为了学习ruby & rails而做。
开发环境:Mac OSX 10.6.4 | ruby 1.8.7 | Rails 2.3.5
今天是开发的第一天,先是简单分析了一下JIRA需求,接下来设计了实体类,然后用migration搭建起了基本的框架。
1. 简单的需求分析
JIRA是一个用JAVA开发的web应用,它是一个项目管理工具,主要的功能是提交问题->解决问题。
罗列一下主要功能:
- 项目成员提交一个问题到某项目中,同时指定0或1个开发者。
- 项目成员查找自己需要解决的问题。
- 问题的开发者开始解决问题,最终完成该问题,其实就是修改问题的状态。
- 项目成员查看项目的状况,包括项目信息、问题列表、版本、日志等。
其他细节的功能还有好多,这里不再细化,开发过程中可以再参考JIRA
我自己还计划增加几项小功能:
- 根据数据,分析得出该项目处于什么状况。
比如可以得出该项目存在很多bug,或者有很多功能没有完成等。
或者不分析,而直接给出项目的数据统计或许更加直观。
- 项目成员可以关注某个问题,在开始关注的同时该成员可以选择以那一种方式关注。
关注方式就是在项目状况发生变化的时候象关注者发出消息,选择可以是邮件、站内消息、首页提示等。
- 根据每个问题的关注的人数得出问题的热门程度,在首页上给出热门问题的链接。
2. 抽出来几个实体及其属性:
- 用户
用户名,姓名,密码,邮箱,电话,分类,所属项目,所属模块(多个),关注问题(多个),是否是系统管理员
- 项目
名称,拥有模块(多个),拥有问题(多个),拥有用户(多个),拥有版本(多个),负责人
- 问题
所属项目,类型,概要,影响版本,描述,附件(多个),关注人(多个),运行状态,重要度,紧要度,预期完成时间,开发者,创建者,合作伙伴,客服名称,应用名称,环境
- 模块
名称,所属项目,开发者(多个),负责人
- 版本
所属项目,版本号
- 日志
谁,干了什么,所属项目
- 关注
谁,关注了哪个问题
注:对于一些简单的属性形式的,比如运行状态,用户类型,我准备直接放在ruby文件里,不在数据库里记录了。这是一个Property类,有type, key, value三个属性。这里的type是指哪种属性,比如可以是“用户类型”或者是“运行状态”等,这里的key是程序中使用的英文代号,value是中文或者其他语言,这样也可以方便的实现国际化,只要替换一个文件就可以了。当然以上都是我的想法,不知道能不能这么玩?就是说可不可以在rails框架之外定义一个自己的Property类?然后在运行的时候调用。
3.开始进行进行项目的开发
创建项目
$ rails rbjira -d mysql
$ cd rbjira
修改config/database.yml文件,以正确配置数据库连接。
创建数据库
$ rake db:create
编写migrate脚本
主要是考虑到可能会在命令行里一次写错,所以才写到文件里一个一个执行。
$ mkdir script/bash
$ cd script/bash
然后建立几个bash脚本文件
attention
ruby script/generate scaffold Attention user_id:integer task_id:integer
log
ruby script/generate scaffold Log who_id:integer action:string project_id:integer
module
ruby script/generate scaffold Module name:string project_id:integer leader_id:integer
project
ruby script/generate scaffold Project name:string leader_id:integer
task
ruby script/generate scaffold task project_id:integer task_type:string title:string version:string description:text status:string important:string time:timestamp creator_id:integer developer_id:integer partner:string customer:string application_name:string environment:string attention_count:integer
user
ruby script/generate scaffold user username:string password:string name:string email:string telephone:string user_type:string project_id:integer is_admin:boolean
version
ruby script/generate scaffold Version project_id:integer number:string
添加执行权限
$ chmod +x script/bash/*
分别执行以上脚本
$ ./script/bash/xxx
用scaffold生成数据库表
$ rake db:migrate
启动服务器
$ ruby script/server
现在看看数据库里的表都已经建好了,然后访问http://localhost:3000/tasks,看到CRUD的页面都已经有了。
到此今天的开发告一段落。
今天有两个小插曲
一个是,我开始把migrate脚步里的integer写成了int,死活建立不了这些字段。因为这些字段都是xx_id的形式,所以我开始怀疑是不是下划线不符合这里的约定,排除了之后又怀疑是不是migrate认为_id结尾的都是外建而相应的表还没有建立所以无法建立字段,后来发现也不是。于是只有第三种可能了,那就是整形只能是integer而不能简写成int。之所以开始没有发现这个问题是因为rails的guids上面没有整形的例子,所以开始没往这方面去想。
顺便说一下bool是错的,要写成boolean。
另一个是有个表开始忘记写migrate脚步,所以是后来加进去的,还有个字段也是后来补进去的。
补加字段的方法很简单
$ ruby script/generate migrate AddProjectIdToLogs project_id:integer
主要是这里,要在后面添加版本,以限定只执行这一个项目
$ rake db:migrate VERSION=xxx
这里的xxx是migrate生成的文件的开头数字,其实就是创建时的系统时间,在上一句执行之后会打印出来得。
The END!
本人新博客:tuoxie.me