unicenta-pos

unicenta-pos copied to clipboard

// Global settings :ascii-ids: :encoding: UTF-8 :lang: en :icons: font :toc: :toc-placement!: :toclevels: 3 :numbered: :stem:

ifdef::env-github[] :imagesdir: https://raw.githubusercontent.com/poolborges/unicenta-pos/main/docs/src/main/images/ :tip-caption: :bulb: :note-caption: :information_source: :important-caption: :heavy_exclamation_mark: :caution-caption: :fire: :warning-caption: :warning: :badges: :doc-dir: https://github.com/poolborges/unicenta-pos/tree/main/docs :repo-base-url: https://github.com/poolborges/unicenta-pos/ endif::[]

[[doc]] = Kriol Open Source Point Of Sales :author: Copyright (c) 2020-2022 KriolOS. :revnumber: 2022-08-23 :revdate: {last-update-label} {docdatetime} :version-label!:

WARNING: IN DEVELOPMENT (NOT RELEASE YET)

ifdef::badges[] == Build status

image:https://github.com/poolborges/unicenta-pos/actions/workflows/ci.yml/badge.svg["Build Status", link="https://github.com/poolborges/unicenta-pos/actions/workflows/ci.yml"] image:https://codecov.io/github/poolborges/unicenta-pos/coverage.svg["Code Coverage", link="https://codecov.io/gh/poolborges/unicenta-pos"] image:https://img.shields.io/badge/License-GPLv3-blue.svg["License: GPL v3", link="https://www.gnu.org/licenses/gpl-3.0.en.html"] image:https://badges.crowdin.net/krpos/localized.svg["Crowdin/Translation Status", link="https://crowdin.com/project/krpos"]

== Stats

image:https://img.shields.io/github/issues-pr-raw/poolborges/unicenta-pos["GitHub Pull Requests", link="https://github.com/poolborges/unicenta-pos/pulls"] image:https://img.shields.io/badge/team-committers-green["GitHub Committers", link="https://github.com/orgs/kriolos/teams/obiz-core-team/members"] image:https://img.shields.io/github/contributors/poolborges/unicenta-pos["GitHub Contributors", link="https://github.com/poolborges/unicenta-pos/contributors"] image:https://img.shields.io/github/commit-activity/m/poolborges/unicenta-pos["GitHub Commit Activity", link="https://github.com/poolborges/unicenta-pos/commits"]

endif::[]

== About

Kriol Open Source Point Of Sales (kriolosPOS)

image::krpos-screenshot.gif[]

=== History of kriolosPOS

• kriolosPOS is a fork of UnicentaOPOS 4.5 (2019-06-30)
• UnicentaOPOS was a fork of OpenBravoPOS
• OpenbravoPOS was a fork of Librepos (previously named Tina POS) ** Adrian Romero was the founder and main developer for Tina POS

=== Pass Developers and Contributors

• @author Mikel Irurita
• @author jaroslawwozniak
• @author adrianromero (adrian)
• @author JG uniCenta (jack gerrard, jack)
• @author HS uniCenta
• @author Ryan Airey
• @author Ali Safdar and Aneeqa Baber
• @author jaroslawwozniak
• @author Luis Ig. Bacas Riveiro [email protected]
• @author Pablo J. Urbano Santos [email protected]
• @author Xibergy Systems
• @author JA
• @author poolborges
• @author Teodor Danciu ([email protected])

== Run App From source

.Example Compile and Execute (windows powershell/Terminal) [source,cmd]

.\mvnw.cmd compile install .\mvnw.cmd exec:java -pl kriolos-opos-app "-Dexec.mainClass=com.openbravo.pos.forms.StartPOS"

.Example Compile and Execute (Linux/Unix Bash) [source,bash]

./mvnw compile install ./mvnw exec:java -pl kriolos-opos-app "-Dexec.mainClass=com.openbravo.pos.forms.StartPOS"

== Run DB on Docker

.Run MySQL database for Developer Env

docker run --name unicenta -p 3306:3306 -d -e MYSQL_ROOT_PASSWORD=root -e MYSQL_DATABASE=unicenta -e MYSQL_USER=unicenta -e MYSQL_PASSWORD=unicenta mysql:5.6

.Run MariaDB database for Developer Env

docker run --name unicentaMDB -p 3306:3306 -d -e MARIADB_ROOT_PASSWORD=root -eMARIADB_DATABASE=unicenta -eMARIADB_USER=unicenta -eMARIADB_PASSWORD=unicenta mariadb/server:10.5

== Reference

• link:{doc-dir}/[Documentation]

== Screenshots

image::kriolos-opos-screenshot.gif[]