ums-rails
这是一个基于rails开发的用户管理系统组件,实现了以下功能:
- 用户帐号的设置、登录、退出、密码修改,访问权限检查
- 基于rails controller和action的功能模块管理
- 权限基于角色管理,角色对应多个功能模块
- 应用日志功能,可以记录用户登录事件
要求
- rails 4.0.0
- will_paginate 3.0.0
- Bootstrap 3.0
安装
在rails应用的Gemfile中加入:
gem 'ums'
或者加入最新的开发版本:
gem 'ums', :github => 'wangfuhai2013/ums-rails'
然后执行:
$ bundle
$ rake ums:install:migrations
$ rake db:migrate
在 db/seeds.rb文件中加入:
Ums::Engine.load_seed
然后执行:
$ rake db:seed
初始化账号为admin
,密码admin
使用
设置应用路由,在 config/routes.rb中加入
mount Ums::Engine =>'/ums'
配置访问权限检查功能,可在 app/controllers/application_controller.rb中加入
helper Ums::Engine.helpers
include Ums::ApplicationHelper
before_filter :authorize
before_action :set_current_session
after_action :operate_log
配置登录后的菜单,可在 app/views/layouts/appliction.html.erb中加入
<nav class="navbar navbar-default" role="navigation">
<div class="collapse navbar-collapse ">
<ul class="nav navbar-nav">
<% if validate_permission(ums.users_path[1..-1]) %>
<li <%= raw 'class="active"' if params[:controller].start_with?("ums") && !action_name.match('password|profile') %> ><%= link_to "用户管理", ums.users_path %></li>
<% end %>
</ul>
<ul class="nav navbar-nav pull-right">
<li><a>当前用户:<%= session[:user_name] %></a></li>
<li <%= raw 'class="active"' if action_name == 'password' %> ><%= link_to "修改密码", ums.users_password_path %></li>
<li <%= raw 'class="active"' if action_name == 'profile' %>><%= link_to "修改邮箱", ums.users_profile_path %></li>
<li><%= link_to "退出", ums.users_logout_path %></li>
</ul>
</div>
</nav>
<div class="container">
<% if params[:controller].start_with?("ums") && !action_name.match('password|profile') %>
<ul class="nav nav-pills">
<li <%= raw 'class="active"' if controller_name == "users" %> ><%= link_to "用户管理", ums.users_path %></li>
<li <%= raw 'class="active"' if controller_name == "roles" %> ><%= link_to "角色管理", ums.roles_path %></li>
<li <%= raw 'class="active"' if controller_name == "functions" %> ><%= link_to "功能管理", ums.functions_path %></li>
<li <%= raw 'class="active"' if controller_name == "logs" %> ><%= link_to "操作日志", ums.logs_path %></li>
</ul>
<% end %>
<%= yield %>
</div>
注:如果在此文件的公共部分引用application中helper方法(ums模块中会调用到),需加前缀 main_app ,如:
<li <%= raw 'class="active"' if params[:controller].start_with?("cms") %> ><%= link_to "内容管理", main_app.cms_docs_path %></li>
登录操作可参考 示例页面