adempiere/adempiere-mobile-service

A default service (as example) to publish mobile service backend

ADempiere Mobile Service

This project was created for add support to Mobile Service with ADempiere as server.

Requirements

The ADempiere template is a service to expose ADempiere as gRPC service with a little functionality of ADempiere:

• Run Login

Since the ADempiere dependency is vital for this project is high recommended that the you are sure that of project adempiere-jwt-token is installed and the setup is runned in ADempiere Database.

Run it from Gradle

gradle run --args="resources/env.yaml"

Some Notes

For Token validation is used JWT

Run with Docker

docker pull openls/adempiere-mobile-service:latest

Minimal Docker Requirements

To use this Docker image you must have your Docker engine version greater than or equal to 3.0.

Environment variables

• DB_TYPE: Database Type (Supported Oracle and PostgreSQL). Default PostgreSQL
• DB_HOST: Hostname for data base server. Default: localhost
• DB_PORT: Port used by data base server. Default: 5432
• DB_NAME: Database name that adempiere-mobile-service will use to connect with the database. Default: adempiere
• DB_USER: Database user that adempiere-mobile-service will use to connect with the database. Default: adempiere
• DB_PASSWORD: Database password that Adempiere-Backend will use to connect with the database. Default: adempiere
• SERVER_PORT: Port to access adempiere-mobile-service from outside of the container. Default: 50062
• SERVER_LOG_LEVEL: Log Level. Default: WARNING
• TZ: (Time Zone) Indicates the time zone to set in the nginx-based container, the default value is America/Caracas (UTC -4:00).

You can download the last image from docker hub, just run the follow command:

docker run -d -p 50062:50062 --name adempiere-mobile-service -e DB_HOST="localhost" -e DB_PORT=5432 -e DB_NAME="adempiere" -e DB_USER="adempiere" -e DB_PASSWORD="adempiere" openls/adempiere-mobile-service:latest

See all images here

Run with Docker Compose

You can also run it with docker compose for develop enviroment. Note that this is a easy way for start the service with PostgreSQL and template.

Requirements

• Docker Compose v2.16.0 or later

docker compose version
Docker Compose version v2.16.0

Run it

Just go to docker-compose folder and run it

cd docker-compose

docker compose up

Some Variables

You can change variables editing the .env file. Note that this file have a minimal example.

Where is the service?

• ZK service by default is launched at [here](http://localhost:8080/webui/timeout.zul)
• The Mobile service is launched at 50059 port

Note: For Postman collection you can import the file located at resources/Mobile_Postman_Collection.json

ADempiere Core Changes

This project depends of adempiere-mobile-changes, please refer to project for core changes.

Supported Endpoints

• /login
• /check-token
• /logout
• /adempiere/organizations
• /app/base-settings
• /app/home-screen
• /appoinment/get-list
• /dashboard/statistics
• /upcoming-events/get-list
• /user/attendance/get-checkin-checkout-status

What else?

• You can login with the follow data:
  • User: app
  • Password: app
• The seed database have all related to Mobile Application:
  • User
  • Role
  • Test Roles
  • Dictionary Changes

Some utils

pg_dump -U adempiere -Fc -d "adempiere" > /tmp/seed.backup --verbose
docker cp adempiere-mobile-service.adempiere.database:/tmp/seed.backup postgresql/