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

评论

1 楼 easylife 2010-08-15  

学习的话，建议换成rails3