https://github.com/alnvdl/oks

A small ERP system tailor-made for a grinding wheel company.
https://github.com/alnvdl/oks

erp gtk pygtk python sqlite

Last synced: 3 months ago
JSON representation

A small ERP system tailor-made for a grinding wheel company.

• Host: GitHub
• URL: https://github.com/alnvdl/oks
• Owner: alnvdl
• License: apache-2.0
• Created: 2019-01-08T23:16:24.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-01-06T18:11:14.000Z (over 1 year ago)
• Last Synced: 2024-01-07T18:49:37.372Z (over 1 year ago)
• Topics: erp, gtk, pygtk, python, sqlite
• Language: Python
• Homepage:
• Size: 424 KB
• Stars: 2
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Oks

Oks is a small ERP system tailor-made for a grinding wheel company in Brazil.

It has been in use in production for more than 15 years.

It features:

- Customer/supplier management

- Inventory control

- Order, sales and manufacturing management

- Accounts payable/receivable

- Several customizable reports

![Oks](gui/screenshot.png)

It was originally built using Python 2, PyGTK and SQLite, and has since been

updated to Python 3 and the new GTK/GI bindings.

It was mostly developed in 2008, when I (Allan) was 18 years old, before I

started attending university. It was my first real big project. I am proud of

some parts of it, namely the database model, the abstractions I came up with

and the *relative* tidiness of the code in certain parts.

I'm a little ashamed by the lack of proper testing (there are only some

integration tests) and some really questionable decisions, like having a

gigantic singleton for the GUI. But this thing still works after all these

years and is still used everyday as of 2023 :)

The user interface only supports Portuguese (despite all of the code being in

English).

The company for which Oks was developed allows the code to be published here

under the Apache 2.0 license. The icons were made by Luiz Henrique Camargo.

## Running on a desktop

On a vanilla Ubuntu 22.04 desktop, just `cd` into the root folder and run:

    $ python3 oks.py

## Running on a server

On a vanilla Ubuntu 22.04 minimal server or container, install the following

packages first:

    $ sudo apt-get install python3-gi python3-gi-cairo libgtk-3-0 \

        gir1.2-gtk-3.0 gir1.2-gtk-3.0 gir1.2-cairo gir1.2-gtk-3.0 \

        python3-cairo yaru-theme-icon evince

To avoid quirky behavior involving mnemonics in GTK 3.0 when using Broadway,

make sure to disable them with:

    mkdir -p ~/.config/gtk-3.0

    cat < ~/.config/gtk-3.0/settings.ini

    [Settings]

    gtk-enable-mnemonics = 0

    EOF

Then start `broadwayd`:

    $ broadwayd :5

And start Oks:

    $ GDK_BACKEND=broadway BROADWAY_DISPLAY=:5 python3 oks.py

It will be available at http://localhost:8085.