ruby on rails版JIRA开发记录 1

阅读更多

想开发一个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

你可能感兴趣的:(Ruby,Rails,项目管理,Bash,OSX)