百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
H

homs

> 编程语言
开源

Hydra 订单管理系统

330 stars0 点赞3 次浏览
访问官网GitHub

工具介绍

Hydra 订单管理系统

Hydra Order Management System (HOMS)

HOMS is an open source web application for order and business process management.

Application consists of three parts:

  • User interface - managing orders and tasks for registered users (Single Page Application).
  • Administrator interface - managing users and order types.
  • REST API - operations with orders and users.

Requirements:

  • Docker
  • docker-compose

Compatibility:

  • Camunda 7.9.0 compatible with PostgreSQL 9.1 / 9.3 / 9.4 / 9.6
  • Minio latest release

Resources:

  • Documentation: http://hydra-oms.com/docs
  • Demo: http://demo.hydra-oms.com
  • Tickets/Issues: https://github.com/latera/homs/issues

Installation

The preferred way to install HOMS is to use Docker.

In production

  1. Download docker-compose.yml and default .env config file:

    bash
    wget https://raw.githubusercontent.com/latera/homs/master/docker-compose.yml
    wget https://raw.githubusercontent.com/latera/homs/master/.env.sample -O .env

    :pushpin: All variables are set in .env file. There you can change them, if you want to.

  2. For OS X users: make path to folder with config shared in Docker -> Preferences... -> File Sharing.

  3. Set SECRET_KEY_BASE variable in your .env with uniq id as value. You can generate key with openssl rand -hex 64 command. For example:

    bash
    SECRET_KEY_BASE=0750fd0eac13032778f0a42e2ab450003eaece477ea881501be0cc438f870a2f498dbbc00ffb7c8379c30c960568a402d315496bb7bc2b3ee324401ba788a

    :warning: Make sure this key is secret and don't share it with anyone.

  4. Change Minio credentials in .env file. Generate MINIO_ACCESS_KEY and MINIO_SECRET_KEY values with any credentials generator, e.g. pwgen 32 2.

  5. Set MINIO_CONSOLE_PORT in .env file.

  6. Run docker-compose:

    bash
    docker-compose up -d
  7. Navigate to Minio control panel and create a bucket with name equal to MINIO_BUCKET_NAME value from .env file.

  8. Login to HydraOMS with [email protected]/changeme. Now you are able to start Pizza Order demo process.

You can login to Camunda Admin interface with credentials equal to BPM_USER:BPM_PASSWORD values from .env file (user/changeme if these variables aren't set).

In development

  1. Follow the instructions below:

    • With Oracle Instant Client.

    • Without Oracle Instant Client (default way).

  2. Navigate to Minio control panel and create a bucket with name equal to MINIO_BUCKET_NAME value from .env file.

  3. Export all variables from .env file

    export $(cat .env | xargs)
  4. Change in bpm.yml value of development.base_url from http://camunda:8080/engine-rest/ to http://localhost:8766/engine-rest/

  5. In database.yml change value of development.host from `` to localhost

  6. Install Yarn and run:

    bash
    yarn install
  7. Compile assets:

    bash
    yarn dev
  8. Start HOMS application in another console tab:

    bash
    rails s
  9. Create and populate the database (adds an admin user, initial order types, and orders):

    bash
    rails db:migrate
    export SEED_DB=true
    rails db:seed
  10. Log in at HydraOMS with [email protected]/changeme.

Updating dependencies

  • Update gems:
    bundle update
  • Update js packages:
    bash
    yarn upgrade-interactive --latest
    Do not update:
    • bootstrap and related packages
    • jquery and related packages

Work with SSO

Requirements:

  • Keycloak

For using SSO with HOMS:

  1. Add user roles. HOMS use "admin" and "user" client level roles. Only one role could be assigned to user.
  2. Add user attributes in Keycloak: company, department.
  3. Add mappers in Keycloak without prefix:
Name Mapper type User attribute Token clain name Claim JSON type Add to ID token Add to access token Add to userinfo Multivalued Aggregate attributes values
company User Attribute company company string On On On Off Off
department User Attribute department department string On On On Off Off
  1. Add to HOMS config file homs_configuration.yml:
sso:
  enabled: true
  use_regular_login: true
  service_user:
    login: "service_user_login"
    password: "service_user_password"
  keycloak:
    auth_server_url: "http://keycloak_host:keycloak_port/auth/"
    realm: hydra
    client_id: homs
    redirect_uri: "http://homs_host:homs_port/authenticate_by_keycloak"
    secret: "af9504fc-b030-405e-97b6-813220c07a7e"
    logout_redirect: "http://homs_host:homs_port"
    scope:
      - homs

service_user is required when SSO is enabled on Camunda but HOMS users log in via regular login (use_regular_login: true). The widget authenticates to Keycloak with these credentials to obtain tokens for Camunda API calls. A single service user is shared across all Camunda instances configured for the widget.

Filter business processes by user

Set cadidate_starters.enabled in hbw.yml to true to send user email to camunda when fetching business processes definition. That way you can allow users to run only certain business processes.

Contributing/Development

The general development process is:

  1. Fork this repo and clone it to your workstation.
  2. Create a feature branch for your change.
  3. Write code and tests.
  4. Push your feature branch to github and open a pull request against master.

Reporting Issues

Issues can be reported by using GitHub Issues.

Testing

HOMS uses RSpec for unit/spec tests. You need to set up different testing database. Otherwise your development DB would be erased.

bash
# Run all tests
bundle exec rspec spec

# Run a single test file
bundle exec rspec spec/PATH/TO/FILE_spec.rb

# Run a subset of tests
bundle exec rspec spec/PATH/TO/DIR

HBW Widget uses jest and snapshots for tests.

bash
# Run frontend tests
jest
# Update snapshots after intentionally changing implementation elements
jest --updateSnapshot

Upgrade PostgreSQL

To upgrade PostgreSQL (HOMS database) to the 15.4 version, we recommend using the pg_dumpall utility:

  1. Copy service db_homs as db_homs_new in docker-compose.yml
  2. In db_homs_new set image: postgres:15.4, change volume to ./data/homs_new/postgresql:$HOMS_DB_PATH, port to 15432:5432, container name to postgres-homs-new
  3. Run db_homs_new and db_homs services docker-compose up db_homs db_homs_new. Wait for postgres instances to start up
  4. Dump db_homs data to file: docker exec -it postgres-homs /usr/bin/pg_dumpall -U homs > dumpfile
  5. Upload data to db_homs_new: docker exec -i postgres-homs-new psql -U homs < dumpfile
  6. Stop db_homs_new and db_homs containers. Replace old volume: rm -rf ./data/homs && mv ./data/homs_new ./data/homs
  7. In db_homs set image: postgres:15.4, remove db_homs_new in docker-compose.yml
  8. Re-hash password for HOMS_DB_USER: source .env && docker exec -it postgres-homs psql -U $HOMS_DB_USER, \password, enter twice value of HOMS_DB_PASSWORD from .env file and enter quit;

Links

  1. Repo with helper classes for BPMN development.

  2. Example of creating a demo business process.

License

Copyright (c) 2019 Latera LLC under the Apache License.

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Rubybsslateraoms

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言