{"id":14983717,"url":"https://github.com/nexxus/nsk","last_synced_at":"2025-04-10T19:41:39.411Z","repository":{"id":37431552,"uuid":"135529496","full_name":"Nexxus/NSK","owner":"Nexxus","description":"Nexxus Stock Keeping","archived":false,"fork":false,"pushed_at":"2023-07-16T23:23:40.000Z","size":3227,"stargazers_count":14,"open_issues_count":19,"forks_count":9,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-24T17:21:15.545Z","etag":null,"topics":["billing","distribution","erp","hardware","inventory","inventory-management","inventory-management-system","inventory-system","logistics","php","recycling","sales","stock","stock-management","stock-management-system","symfony","symfony3","webapplication"],"latest_commit_sha":null,"homepage":"https://nexxus.eco/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Nexxus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2018-05-31T03:58:48.000Z","updated_at":"2024-06-09T14:36:36.000Z","dependencies_parsed_at":"2024-09-24T15:25:25.326Z","dependency_job_id":"d2af4d1c-ce30-4968-baf7-b08294316c05","html_url":"https://github.com/Nexxus/NSK","commit_stats":{"total_commits":623,"total_committers":13,"mean_commits":47.92307692307692,"dds":0.6147672552166934,"last_synced_commit":"a2d7e582b6cb478b9e6f2ead78005d1b3f7ac265"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nexxus%2FNSK","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nexxus%2FNSK/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nexxus%2FNSK/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nexxus%2FNSK/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nexxus","download_url":"https://codeload.github.com/Nexxus/NSK/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248281415,"owners_count":21077423,"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":["billing","distribution","erp","hardware","inventory","inventory-management","inventory-management-system","inventory-system","logistics","php","recycling","sales","stock","stock-management","stock-management-system","symfony","symfony3","webapplication"],"created_at":"2024-09-24T14:07:49.275Z","updated_at":"2025-04-10T19:41:39.385Z","avatar_url":"https://github.com/Nexxus.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nexxus Stock Keeping\r\n\r\nNexxus stock keeping is a webapplication made for purchase, sale and keeping of any stock. The application is built upon most popular technologies, such as PHP, Symfony, MySQL, jQuery and Bootstrap. This repository holds version 2 of Nexxus, which is made open source under the terms of the GNU General Public License (GNU GPLv3). \r\n\r\n## Background\r\n\r\nMy name is Mardten de Bakker and I am owner of Copiatek. Copiatek refurbishes and recycles used computer hardware and uses Nexxus for its own daily workflow. It started when I was manager in a thrift store and I wanted to sell used computers. There was no way to keep track of the computers and to know in what state they were in. Since we operated multiple stores, I also needed to keep track of the computers at several locations and which ones were sold.\r\n\r\nThe software evolved and it became possible to also keep track of other objects besides computers. Also a billing part was introduced so we could use it as a point of sales. Since we picked up objects through the country, I needed a way to keep track of logistics and distribution. Most of the whishes have been implemented, however it was build on a shady foundation. Last year we decided to start developing from the ground up. This repository tracks the development of the second version of Nexxus Stock Keeping.\r\n\r\n## Requirements\r\n\r\nThe following technologies should be present in order to install and use Nexxus.\r\n\r\n- Web server like Apache on Linux (Tested with Apache 2.4.7 and Ubuntu Linux 14.04.4)\r\n- PHP 7 with regular extensions (tested with 7.0.32)\r\n- MySQL 5.6 (Tested with 5.6.33-0ubuntu0.14.04.1)\r\n- Composer (dependency manager for PHP)\r\n- Git\r\n\r\nNexxus is tested with these versions. Higher versions of PHP could give undesirable results.\r\n\r\n## Installation\r\n\r\nIn order to install Nexxus, you need to open a Windows command prompt, Linux terminal or SSH connection (like with Putty). Some steps below might require more user rights, ie. when you get permission denied errors. In that case prepend the command with the _sudo_ command. We advise not to install the Nexxus application using the _root_ user.\r\n\r\nIf this manual is too brief for you, more than enough information can be found on the internet, as these steps are very regular for a Symfony 3 application.\r\n\r\nFor installation follow these steps:\r\n\r\n### 1. Choose the right place to install\r\n\r\nIn the terminal, go to the right place where you would like to install Nexxus. Typically this is one directory above the _public_html_ or _wwwroot_ folder. **Never install Nexxus inside the public web folder!** Like 90% of the source code of a webapplication like this is not in the public web folder. Step 3 of this installation manual will make a certain part of the application available for public.\r\n\r\n### 2. Download the repository\r\n\r\nTo clone the source code, run:\r\n```\r\ngit clone https://github.com/Nexxus/NSK.git nexxus\r\n```\r\nThis will download all source code and place it in a newly created folder named _nexxus_. Go to the new folder when the download has finished:\r\n```\r\ncd nexxus\r\n```\r\nAll next steps will happen in this new folder.\r\n\r\nWhen using Linux, make sure the application can modify the _var_ folder:\r\n```\r\nchmod -R 777 var\r\n```\r\nNow you have your clean clone of Nexxus.\r\n\r\n### 3. Move some files to the public web folder.\r\n\r\nIf you need a production web server like Apache, the public web folder is at a designated location, in which you (fortunately) did not install Nexxus. To make Nexxus publically accessible, move the web folder of the installation to the public web folder of your server. The public web folder is typically named _public_html_ or _wwwroot_. This is an example how it can be achieved:\r\n```\r\nmkdir ../public_html/nsk\r\nmv web/* web/.* ../public_html/nsk\r\n```\r\nDon't copy this line literally, but apply it to the situation of your web server. In this example, Nexxus will be available on URL http://www.yourdomain.com/nsk\r\n\r\nWhen you would get an error about device or resource being busy, there is no problem. Just execute this extra command:\r\n```\r\nrm -rf web\r\n```\r\nIn _composer.json_ you should add or change the value for field _symfony-web-dir_. The file is in the current directory. You can change this file with a text editor like Nano. The line to change is somewhere at the bottom in the node named _extra_. In this example, the value should be changed from _web_ to _../public_html/nsk_.\r\n\r\n### 4. Install dependencies\r\n\r\nNexxus depends on other PHP packages. To install these, run:\r\n```\r\ncomposer install\r\n```\r\nThis will take a while...\r\n\r\nAfter installation, some parameters will be asked. You can enter thru most of them. The database does not need to exist yet, but the database user does need to exist. For _database_user_ and _database_password_ you need to enter the appropiate values. For the _secret_ enter a random value of your liking. These parameters can be edited later in file _./app/config/parameters.yml_.\r\n\r\n### 5. Install the database\r\n\r\nTo create a database with all needed tables, run:\r\n```\r\nphp bin/console doctrine:database:create\r\nphp bin/console doctrine:schema:create\r\n```\r\n\r\n### 6. Create the first user\r\n\r\nTo get you started, make the first user in the terminal\r\n```\r\nphp bin/console fos:user:create superadmin superadmin@whatever.com p@ssw0rd\r\nphp bin/console fos:user:promote superadmin ROLE_SUPER_ADMIN\r\n```\r\nDon't copy these line literally, but change the name, email and password to your likings. Take care of choosing a good password.\r\n\r\nNow you can login and create other users in the Admin section.\r\n\r\n### 7. Finishing installation\r\n\r\nFinally make sure the application root can find the source code from its new location. This happens in a different folder:\r\n```\r\ncd ../public_html/nsk\r\n```\r\nYou are now in the public root. Open _app.php_ in a text editor and change lines 6 and 7 like so:\r\n```\r\n$loader = require __DIR__.'/../../nexxus/app/autoload.php';\r\ninclude_once __DIR__.'/../../nexxus/var/bootstrap.php.cache';\r\n```\r\nFinally, if you are installing an production environment, remove _app_dev.php_. In Linux:\r\n```\r\nrm app_dev.php\r\n```\r\nPlease check if the commands are appropiate for your specific situation. For example, you might have installed the application in different folders then _nexxus_ and _nsk_.\r\n\r\n### 8. Use Nexxus\r\n\r\nCongratulations, Nexxus is now ready for use. To start with, go to the Admin section and configure all meta data: Users, Locations, Product types, Attributes, Product statuses, Order statuses, Tasks. Without  this meta data the application will not behave as desired.\r\n\r\nWhen your first visit to Nexxus gives an error 500, our first guess is that the write rights to the _var_ folder is not accurate. You could try to repeat this command from the application folder:\r\n```\r\nchmod -R 777 var\r\n```\r\nFor more information, for example about upgrading installations or the API reference, go to the [Wiki](https://github.com/Nexxus/NSK/wiki).\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexxus%2Fnsk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnexxus%2Fnsk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexxus%2Fnsk/lists"}