concordconsortium/lara

Lightweight Activities Runtime and Authoring（LARA）

![Code Climate]([] ![Build Status]([]

这是一个基于Rails的应用，旨在提供轻量级活动的创作和使用平台。

快速开始

我们使用Docker进行本地开发，且当前使用rails-lts（Rails 3.2的非开源安全回溯版本），因此你的DockerHub用户需要访问concordconsortium/docker-rails-base-private镜像才能进行开发。

1. 登录Docker（若未登录）：

   bash
   docker login
   

2. 快速启动：

   bash
   docker-compose up
   

   此时可通过http://localhost:3000访问LARA。

3. OSX优化设置： OSX上直接运行可能较慢，可使用.env文件覆盖配置：

   bash
   cp .env-osx-sample .env
   docker-compose up
   

   注意：若未设置Dinghy，需先完成Dinghy设置，之后通过[***]

4. 用户注册与管理员权限：

   • 注册新用户：[***]
   • 将最后注册的用户设为管理员：

     bash
     docker-compose exec app bundle exec rake lightweight:admin_last_user
     

5. SSO集成（与门户）：

   • 在.env中设置正确的PORTAL_HOST。
   • 在门户目录执行以下命令添加客户端：

     bash
     docker-compose exec app bundle exec rake sso:add_client
     

   客户端参数：

   参数	值
   client_id	localhost
   secret	unsecure local secret
   site_url	[***]

用户与管理

用户认证由https://github.com/plataformatec/devise%E5%A4%84%E7%90%86%EF%BC%8C%E6%B3%A8%E5%86%8C%E7%94%A8%E6%88%B7%E4%BC%9A%E8%87%AA%E5%8A%A8%E7%A1%AE%E8%AE%A4%E3%80%82%E6%96%B0%E7%94%A8%E6%88%B7%E9%9C%80%E7%94%B1%E7%8E%B0%E6%9C%89%E7%AE%A1%E7%90%86%E5%91%98%E6%8E%88%E4%BA%88%E4%BD%9C%E8%80%85%E6%88%96%E7%AE%A1%E7%90%86%E5%91%98%E6%9D%83%E9%99%90%E3%80%82%E8%A7%92%E8%89%B2%E6%9D%83%E9%99%90%E8%AF%A6%E6%83%85%E5%8F%AF%E6%9F%A5%E7%9C%8B%60app/models/ability.rb%60%E6%96%87%E4%BB%B6%E3%80%82

OSX上的Dinghy设置

仅需执行一次，适用于所有Docker容器：

1. 启动代理容器：

   bash
   docker run -d --restart=always -v /var/run/docker.sock:/tmp/docker.sock:ro -v ~/.dinghy/certs:/etc/nginx/certs -p 80:80 -p 443:443 -p 19322:19322/udp -e DNS_IP=127.0.0.1 -e CONTAINER_NAME=http-proxy --name http-proxy codekitchen/dinghy-http-proxy
   

2. 创建/etc/resolver/docker文件，内容如下：

   nameserver 127.0.0.1
   port 19322
   

CSS编辑

项目使用Sass和Compass，开发模式下资产管道会自动处理样式，无需运行compass watch。

主题支持

运行环境支持主题（主要为样式表），分为CC和MW两大系列。主题样式表需添加到config/environments/production.rb的config.assets.precompile列表中才能在生产环境生效。

运行测试

RSpec测试

• 持续运行测试：

  bash
  docker-compose exec app docker/dev/run-ci.sh
  

• 单次运行测试：

  bash
  docker-compose exec app docker/dev/run-spec.sh
  

• 生成代码覆盖率报告（需设置COVERAGE_REPORT环境变量）：

  bash
  docker-compose exec -e COVERAGE_REPORT=true app docker/dev/run-spec.sh
  

Jasmine测试

bash
docker-compose run -p 8888:8888 --rm app bundle exec rake jasmine

访问http://localhost:8888查看测试结果。

延迟任务处理

使用https://github.com/collectiveidea/delayed_job%E5%A4%84%E7%90%86%E5%90%8E%E5%8F%B0%E4%BB%BB%E5%8A%A1%EF%BC%8C%E7%94%9F%E4%BA%A7%E6%A8%A1%E5%BC%8F%E6%88%96%E8%AE%BE%E7%BD%AE%60DELAYEDJOB=1%60%E6%97%B6%E5%BC%82%E6%AD%A5%E8%BF%90%E8%A1%8C%E3%80%82%E7%A4%BA%E4%BE%8B%EF%BC%9A

ruby
class Device
  def deliver
    # 长时间运行的方法
  end
  handle_asynchronously :deliver
end

许可证

LARA基于MIT许可证发布。