Skip to content
This repository has been archived by the owner on Nov 25, 2024. It is now read-only.

Latest commit

 

History

History
336 lines (246 loc) · 11.3 KB

README.md

File metadata and controls

336 lines (246 loc) · 11.3 KB
Raw

vue version element-ui Docker Pulls Publish GH Action license GitHub release Gitter

English | Spanish

Introduction.

adempiere-vue is a new UI for ADempiere ERP, CRM & SCM]. It based on vue and use the UI Toolkit element-ui.

POS Image

It is a great UI for ADempiere ERP, CRM & SCM based on the newest development stack of vue, built-in i18n solution, typical templates for enterprise applications, lots of awesome features. This project was forked from Vue-Element-Admin originally write by PanJiaChen / 花裤衩 over MIT license and was changed to GNU/GPL v3 by Yamel Senih after forked granted by PanJiaChen / 花裤衩 on issue "Extend as GNU/Gpl v3 License #1434".

adempiere-vue use the modern open source high performance RPC framework that can run in any environment gRPC as server.

The current version is v1.0+ build on vue-cli. If you find a problem, please put issue.

This project does not support low version browsers (e.g. IE). Please add polyfill by yourself.

Preparation

You need to install node and git locally. The project is based on ES2015+, vue, vuex, vue-router, vue-cli , gRPC and element-ui. Understanding and learning this knowledge in advance will greatly help the use of this project.

Edit on CodeSandbox

For all enviroment you should run the follow images:

docker pull erpya/adempiere-grpc-all-in-one
docker pull erpya/proxy-adempiere-api
docker pull erpya/adempiere-vue

Run docker container:

Minimal Docker Requirements

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

Build docker image (for development only):

docker build -t solopcloud/adempiere-vue:dev -f ./Dockerfile .

Download docker image:

docker pull solopcloud/adempiere-vue

Run container container:

docker run -it \
	--name adempiere-vue \
	-p 80:80 \
	-e API_URL="http://localhost:8080/api/" \
	-e TZ="America/Caracas" \
	solopcloud/adempiere-vue

Or easy run container using docker-compose with follow command:

docker-compose up

Environment variables for the configuration

  • PUBLIC_PATH: You will need to set publicPath if you plan to deploy your site under a sub path, for example GitHub Pages. If you plan to deploy your site to https://adempiere-vue.github.io/bar/, then publicPath should be set to /bar/. In most cases please use /.

  • API_URL: It indicates the address of the server to which you will point the service ADempiere-UI-Gateway, by default its value is http://localhost:8080/api/.

  • TASK_MANAGER_URL: It indicates the address of the API RESTFul to task manager ADempiere-Business-Processors and dKron, by default its value is http://localhost:8080/v1.

  • TZ: (Time Zone) Indicates the time zone to set in the nginx-based container, the default value is America/Caracas (UTC -4:00).

Note If you do not change the values of the environment variables, it is not necessary to indicate them in the docker run command, since the default values will be set.

Sponsors

ERP Consultores y Asociados

Become a sponsor and get your logo on our README on GitHub with a link to your site. Become a sponsor

Features

- Login / Logout
- Register
- Forgot Password

- Permission Authentication
  - ADempiere backend permission
  - Page permission
  - Directive permission
  - Permission configuration page

- Multi-environment build
  - Develop (dev)
  - sit
  - Stage Test (stage)
  - Production (prod)

- Global Features
  - I18n
  - Multiple dynamic themes
  - Dynamic sidebar (supports multi-level routing)
  - Dynamic breadcrumb
  - Tags-view (Tab page Support right-click operation)
  - Svg Sprite
  - Screenfull
  - Responsive Sidebar

- Editor
  - Rich Text Editor
  - Markdown Editor
  - JSON Editor

- Excel
  - Export Excel
  - Upload Excel
  - Visualization Excel
  - Export zip

- Table
  - Dynamic Table
  - Drag And Drop Table
  - Inline Edit Table

- Error Page
  - 401
  - 404

- Components
  - Avatar Upload
  - Back To Top
  - Drag Dialog
  - Drag Select
  - Drag Kanban
  - Drag List
  - SplitPane
  - Dropzone
  - Sticky
  - CountTo

- ADempiere supported
  - Window
  - Process
  - Report
  - Smart Browser
  - Form
  - Workflow

- Advanced Example
- Error Log
- Dashboard
- Guide Page
- ECharts
- Clipboard
- Markdown to html

Getting started

Use gRPC ADempiere Server as gRPC provider.

# Enable https to install packages
git config --global url."https://".insteadOf git://

# clone the project
git clone -b experimental https://github.com/solop-develop/frontend-core.git

# enter the project directory
cd frontend-core

# install dependency (yarn install --frozen-lockfile)
yarn ci

# run project as develop
yarn dev

This will automatically open http://localhost:9527

Build

# build for test environment
yarn build:stage

# build for production environment
yarn build:prod

Advanced

# preview the release environment effect
yarn preview

# preview the release environment effect + static resource analysis
yarn preview --report

# code format check
yarn lint

# code format check and auto fix
yarn lint --fix

Refer to Documentation for more information

Changelog

Detailed changes for each release are documented in the release notes.

Online Demo

Live Preview

  • User: GardenAdmin
  • Password: GardenAdmin

Donate

If you find this project useful, you can help this make a better UI

Paypal Me

Some Contributors

Thanks you for any effort to improve this great project. The follows are some companies that paying for help us to make a best software.

vDevSoft

Browsers support

Modern browsers and Internet Explorer 10+

IE / Edge
IE / Edge		 Firefox
Firefox		 Chrome
Chrome		 Safari
Safari
IE10, IE11, Edge last 2 versions last 2 versions last 2 versions

License

GNU/GPL v3

Previous License

MIT

Initial Contributors