{"id":18587122,"url":"https://github.com/tjas/tjas-erp","last_synced_at":"2026-05-06T19:08:10.069Z","repository":{"id":172367131,"uuid":"648845444","full_name":"tjas/tjas-erp","owner":"tjas","description":"Advanced Python/Django ERP Application.","archived":false,"fork":false,"pushed_at":"2024-04-15T23:00:29.000Z","size":42,"stargazers_count":2,"open_issues_count":23,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-16T06:36:23.505Z","etag":null,"topics":["bootstrap","django","erp","postgres","postgresql","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tjas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"tjas"}},"created_at":"2023-06-03T01:21:29.000Z","updated_at":"2024-01-14T12:49:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"4a52eaa0-da2a-4e49-a1d9-18798a3ab56a","html_url":"https://github.com/tjas/tjas-erp","commit_stats":null,"previous_names":["tjas/tjas-erp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tjas/tjas-erp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tjas%2Ftjas-erp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tjas%2Ftjas-erp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tjas%2Ftjas-erp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tjas%2Ftjas-erp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tjas","download_url":"https://codeload.github.com/tjas/tjas-erp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tjas%2Ftjas-erp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261535046,"owners_count":23173516,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap","django","erp","postgres","postgresql","python"],"created_at":"2024-11-07T00:38:47.747Z","updated_at":"2026-05-06T19:08:10.026Z","avatar_url":"https://github.com/tjas.png","language":"Python","funding_links":["https://github.com/sponsors/tjas"],"categories":[],"sub_categories":[],"readme":"# tjas-erp\n\n[![Status](https://img.shields.io/badge/status-active-brightgreen.svg?label=Status)](./README.md)\n[![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Ftjas%2Ftjas-erp\u0026count_bg=%2379C83D\u0026title_bg=%23555555\u0026title=Hits\u0026edge_flat=false)](https://hits.seeyoufarm.com)\n![Coverage](https://img.shields.io/badge/coverage-76%25-yellow?label=Test%20coverage)\n[![Licence](https://img.shields.io/github/license/tjas/tjas-erp?color=orange\u0026label=Licence)](https://github.com/tjas/tjas-erp/blob/master/LICENCE)\n[![Commits](https://img.shields.io/github/commit-activity/t/tjas/tjas-erp?label=Commits)](https://github.com/tjas/tjas-erp/graphs/commit-activity)\n![Last commit](https://img.shields.io/github/last-commit/tjas/tjas-erp?color=blue\u0026label=Last%20commit)\n![Repo size](https://img.shields.io/github/repo-size/tjas/tjas-erp?color=888888\u0026label=Repo%20size)\n![Code size](https://img.shields.io/github/languages/code-size/tjas/tjas-erp?color=888888\u0026label=Code%20size)\n[![Stars](https://img.shields.io/github/stars/tjas/tjas-erp?color=blue\u0026label=Stars)](https://github.com/tjas/tjas-erp/stargazers)\n[![Watchers](https://img.shields.io/github/watchers/tjas/tjas-erp?color=blue\u0026label=Watchers)](https://github.com/tjas/tjas-erp/watchers)\n[![Forks](https://img.shields.io/github/forks/tjas/tjas-erp?color=blue\u0026label=Forks)](https://github.com/tjas/tjas-erp/forks)\n\n[![Python](https://img.shields.io/badge/python-v3.10.11-darkgreen?label=Python)](https://www.python.org/)\n[![Django](https://img.shields.io/badge/django-v4.2.1-green?label=Djando)](https://www.djangoproject.com/)\n[![PostgreSQL](https://img.shields.io/badge/postgresql-v15.3.0-blue?label=PostgreSQL)](https://www.postgresql.org/)\n\n\u003e ⭐ Mark the project with a star. 👀 Watch the project for receive news.\n\u003e\n\u003e 🇧🇷 Acesse esta página em [Português do Brasil](./README_pt-br.md).\n\u003c!-- \u003e\n\u003e 🌐 Access my personal website: [thiago-tjas.com](http://thiago-tjas.com/) --\u003e\n\nAdvanced Python/Django ERP application for product, employee and sales registration, detailing, editing, deletion and listing, with access control. Features and evolutions planned can be found in the [Main Features Available](#main-features-available) section.\n\n\u003c!-- \n## Build With\n\n* Python 3.10.11\n* Django 4.2.1\n* PostgreSQL 15.3.0 \n--\u003e\n\n## Main Features Available\n\n\u003e To learn more about upcoming releases, refer to the [Project Roadmap](https://github.com/users/tjas/projects/2/views/1)\n\n* Employees' registration, detailing, editing and listing;\n* Products' registration, detailing, editing, deletion and listing;\n* Sales' registration, detailing, editing, deletion and listing;\n* Public and private pages access control;\n* Connection to persist informations in local data base;\n* 76% of test coverage.\n\n\u003c!-- \n* Create rich user interface with [Bootstrap](https://getbootstrap.com/);\n* Create new product, employee and sale's fields and categories;\n* Create products' stock control;\n* Create stores' registration, detailing, editing, deletion and listing;\n* Create link between stores and employees;\n* Create stores' public and restrict access pages;\n* Create customers' registration, detailing, editing and listing;\n* Create customers' rich shopping page;\n* Create customers' shopping cart;\n* Create customers' following store list;\n* Create customers' favorites list;\n* Create customers' purchase history page;\n* Create customers' shipping address page;\n* Create customers' payment method page;\n* Create purchase steps with payment method and delivery address;\n* Create pagination in listing views;\n* Create filters in listing views;\n* Create translation to other languages. \n--\u003e\n\n## Getting Started\n\nThis is an example of how you may set up the project locally in your computer. We strongly recommended that you use virtual environments to run the application, we recommend [Virtualenv](https://virtualenv.pypa.io/en/latest/) (or any other of your choice). Read it, create and activate the virtual environment inside the project folder before steps 5.\n\nTo get a local copy up and running follow these steps:\n\n1. Make sure you have Python 3.10.11+ installed or do it from [Python.org](https://www.python.org/) or from [Anaconda](https://www.anaconda.com/);\n2. Make sure you have Git installed or do it from [Git-scm.com](https://git-scm.com/);\n3. Access the folder you want to save the project, then clone the repo there\n    ```sh\n    git clone https://github.com/tjas/tjas-erp\n    ```\n4. Access the project folder;\n5. Install the project dependencies\n   ```py\n   pip install -r requirements.txt\n   ```\n6. Make sure [PostgreSQL](https://www.postgresql.org/) is running on your computer and that the ```db_erp``` database has been created. The database name, access and other related settings must be verified and can be changed in the ```DATABASES``` variable of ```settings.py``` file, located in main application folder (```core``` module).\n7. Run the migrations\n    ```py\n    python manage.py migrate\n    ```\n8. Run Django project\n    ```py\n    python manage.py runserver\n    ```\n9. Then access aplication at \u003chttp://127.0.0.1:8000/\u003e\n\n## Contributing\n\u003c!-- \u003e Adapted from the [\"Flappy Bird: Dev Soutinho\"](https://github.com/omariosouto/flappy-bird-devsoutinho/blob/master/CONTRIBUTING.md) project. --\u003e\n\n1. Fork it!\n2. Create your feature branch:\n    ```sh\n    git checkout -b my-new-feature\n    ```\n3. Add files changed:\n    ```sh\n    git add .\n    ```\n4. Commit your changes:\n    ```sh\n    git commit -m \"Add some useful comment here\"\n    ```\n5. Push to the branch:\n    ```sh\n    git push origin my-new-feature\n    ```\n6. Submit a [pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)\n    * Add a title and description that let clear your suggestion;\n    * Use the English language for comments and branch names;\n    * After your pull request is merged, you can safely delete your branch.\n\n## Tests\n\nFor unit testing creation it was been used the tools available in the [```django.test```](https://docs.djangoproject.com/pt-br/4.2/topics/testing/) module of Django and in [unittest](https://docs.python.org/3/library/unittest.html) library of Python. To assess test coverage, the [coverage](https://pypi.org/project/coverage/) package was used.\n\n### Performing the Tests\n\nFrom inside the project folder, run:\n\n```sh\npython manage.py test\n```\n\n### Checking Tests Coverage\n\nFrom inside the project folder, run the tool and generate reports:\n\n```sh\ncoverage run --omit='*/venv/*' manage.py test\ncoverage report\ncoverage html\n```\n\n## Contact\n\n**Thiago Jorge Almeida dos Santos**, project author and maintainer.\n\n[![LinkedIn](https://img.shields.io/badge/-LinkedIn-blue?style=flat-square\u0026logoColor=white\u0026link=https://www.linkedin.com/in/thiago-tjas)](https://www.linkedin.com/in/thiago-tjas) [![YouTube](https://img.shields.io/badge/-YouTube-FF0000?style=flat-square\u0026logoColor=white\u0026link=https://www.youtube.com/@thiago_tjas)](https://www.youtube.com/@thiago_tjas) [![Instagram](https://img.shields.io/badge/-Instagram-E4405F?style=flat-square\u0026logoColor=white\u0026link=https://www.instagram.com/thiago.tjas/)](https://www.instagram.com/thiago.tjas/) [![Website](https://img.shields.io/badge/-Website-888888?style=flat-square\u0026logoColor=white\u0026link=http://thiago-tjas.com/)](http://thiago-tjas.com/) [![GitHub](https://img.shields.io/badge/-GitHub-555555?style=flat-square\u0026logoColor=white\u0026link=https://github.com/tjas)](https://github.com/tjas)\n\n## Licence\n\n* Code distributed under [MIT License](https://github.com/tjas/tjas-erp/blob/master/LICENCE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftjas%2Ftjas-erp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftjas%2Ftjas-erp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftjas%2Ftjas-erp/lists"}