manageplaces/base-image

ManagePlaces

镜像概述

ManagePlaces是一个基于Ruby on Rails 5.2和PostgreSQL构建的项目，提供本地开发环境的详细配置指南，涵盖依赖安装、数据库设置、前端资源管理及应用运行与测试流程。

核心功能

• 支持Ruby 2.5.3版本及带PostGIS扩展的PostgreSQL环境配置
• 集成Vue.js前端资源管理（基于webpack pipeline）
• 提供数据库初始化、迁移及样本数据加载流程
• 包含RSpec测试框架及开发辅助工具（foreman、letter_opener）

使用场景

• 开发人员搭建ManagePlaces项目的本地开发环境
• 进行项目功能开发、测试与调试
• 更新前端资源（如DHTMLX scheduler）及依赖管理

配置说明

前提条件

需安装以下工具：

• Ruby 2.5.3（推荐rbenv或rvm）
• 启用PostGIS的PostgreSQL（Mac用户推荐Postgres.app）
• localhost:6379运行的redis-server
• Node.js 12.13.0（推荐nvm安装）
• Yarn包管理器

依赖安装

1. 克隆代码并安装Ruby依赖：

bash
git clone git@github.com:manageplaces/manageplaces-app.git
cd manageplaces-app
bundle install

2. 安装前端依赖（进入vendor/vue/manageplaces目录）：

bash
yarn install

配置文件设置

1. 复制示例配置：

bash
cp config/database.yml.example config/database.yml
cp config/application.yml.example config/application.yml

2. 编辑文件填写实际值（如Google API、AWS密钥）
3. 初始化数据库：

bash
bundle exec rake db:create
bundle exec rake db:migrate

运行应用

• 仅启动应用：rails s
• 开发模式（启动Redis、Rails、Webpacker）：foreman start

测试与数据加载

• 运行测试：bundle exec rspec或spring rspec
• 加载样本数据：bundle exec rake db:seed
• 加载自定义表单：bundle exec rake seed_data:reset_custom_forms[project_id]

Docker部署示例

Docker Compose配置（docker-compose.yml）

yaml
version: '3'
services:
  web:
    image: manageplaces/base-image
    command: rails s -b 0.0.0.0
    ports: ["3000:3000"]
    depends_on: [db, redis]
    environment:
      - DATABASE_URL=postgres://postgres:password@db:5432/manageplaces_development
      - REDIS_URL=redis://redis:6379/0
  db:
    image: postgis/postgis:13-3.1
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=manageplaces_development
    volumes: [postgres_data:/var/lib/postgresql/data]
  redis:
    image: redis:6-alpine
    volumes: [redis_data:/data]
volumes:
  postgres_data:
  redis_data:

启动命令

bash
docker-compose up -d