/posko-rails

POSko is a Point-of-sale written in ruby on rails

Primary LanguageRubyMIT LicenseMIT

POS using rails Deploy

An open source POS written on rails. Hopefully, it can support real world scenario.

Build Status Maintainability Test Coverage CodeFactor

Specs

  • Tested on Ruby 2.4.3
  • Rails 5.1.6

Setting Up

First Time

Run bin/setup

Else (development)

Instead of db:rollback && db:migrate,

Run bin/update

This command will drop your database and recreates it. Your data will be purged.

Model Diagram

Model Diagram

Running Test

bundle exec rspec or bundle exec guard

Dashboard Preview

Preview

API

The API references is available on POSko API Docs.

You can contribute by documenting our API here.

Mobile App companion

Android App by edwnmrtnz

Desktop App

It will follow after the release of version 1. I plan to utilize the power of Electron

Contributing

Contributions/Suggestions are very welcome. Check it out here

Supported Modules(Basic Functionality)

  • User
  • Products
    • Variants
    • Composite
      • Product Components

Check the diagram for more info.

TODOS (Basic Modules)

  • Roles (Ability later)
    • Pundit
  • Collections
  • Orders
    • OrderLines
    • Fullfillments
  • Payments
  • Customers
  • Cart(ecommerce later)
  • Addresses
  • Contacts
  • Reports(later)
  • Blog(not yet sure)
  • API with Documentation
  • Breadcrumbs
  • Branches