paneldata/ddionrails

DDI on Rails

镜像概述

DDI on Rails是一款开源数据门户工具，陪伴研究人员完成从项目构思到发表/引用的整个研究流程。它具备研究独立性、多版本数据文档支持、纵向研究适配等特点，且操作简便，适用于学术数据管理场景。

核心功能

• 数据探索：提供数据浏览与分析能力
• 个性化数据集编译：支持用户创建定制化数据集
• 结果发布：允许在公开数据库发布研究成果
• 多版本数据文档：记录数据的不同版本与分布特征
• 纵向研究支持：适配长期跟踪类研究的数据管理需求

使用场景

• 学术研究项目：覆盖从立项到成果发表的全流程数据管理
• 纵向研究：处理长期跟踪数据的文档与版本管理
• 开源数据平台搭建：基于镜像快速部署专业数据门户

配置说明

前提条件

安装Docker及Docker-Compose：

• Docker：https://docs.docker.com/install/
• Docker-Compose：https://docs.docker.com/compose/install/

验证安装：

bash
docker --version
docker-compose --version

开发环境部署

1. 克隆仓库：

bash
git clone https://github.com/ddionrails/ddionrails.git
cd ddionrails/

2. 创建符号链接（简化命令）：

bash
ln -s docker-compose-remote-dev.yml docker-compose.override.yml

3. 启动服务：

bash
docker-compose up -d

生产环境部署

关键步骤：

1. 配置环境文件：修改docker/environments/下的database.env（设置安全密码）、django.env（关闭DEBUG、配置ALLOWED_HOSTS等）
2. 配置Nginx：修改docker/nginx/nginx.example.conf为nginx.conf，替换REPLACE_ME部分，如需SSL需挂载证书
3. 启动服务：确保环境配置正确后执行docker-compose up -d

数据导入

导入研究元数据：

1. 添加研究：

bash
docker-compose exec web python manage.py add soep-test github.com/ddionrails/testsuite

2. 更新研究：

bash
docker-compose exec web python manage.py update soep-test

3. 数据库插入与索引：

bash
docker-compose exec web python manage.py update

运行测试

执行单元与集成测试：

bash
cd ddionrails/
docker-compose -f "docker-compose.yml" -f "docker-compose-dev.yml" up -d
docker-compose exec web paver test

版本控制

遵循语义化版本2.0.0，版本信息可查看https://github.com/ddionrails/ddionrails/tags%E6%88%96%E5%8F%98%E6%9B%B4%E6%97%A5%E5%BF%97%E3%80%82

许可证

采用GNU AGPL-3.0许可证，详情见https://github.com/ddionrails/ddionrails/blob/master/LICENSE.md%E3%80%82