{"id":25565947,"url":"https://github.com/fiforms/reliefinventory","last_synced_at":"2026-02-15T01:33:11.935Z","repository":{"id":276054465,"uuid":"928047703","full_name":"fiforms/reliefinventory","owner":"fiforms","description":"A Warehouse Inventory Management System for Disaster Relief","archived":false,"fork":false,"pushed_at":"2025-03-12T19:03:12.000Z","size":1340,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-02T19:45:11.910Z","etag":null,"topics":["database","disaster-relief","laravel","php"],"latest_commit_sha":null,"homepage":"https://reliefinventory.fiforms.net/","language":"PHP","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/fiforms.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-06T01:06:47.000Z","updated_at":"2025-03-12T19:03:15.000Z","dependencies_parsed_at":"2025-02-06T03:21:40.396Z","dependency_job_id":"7e98561e-6f9a-4683-b07d-6db60d02451b","html_url":"https://github.com/fiforms/reliefinventory","commit_stats":null,"previous_names":["fiforms/reliefinventory"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fiforms/reliefinventory","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiforms%2Freliefinventory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiforms%2Freliefinventory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiforms%2Freliefinventory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiforms%2Freliefinventory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fiforms","download_url":"https://codeload.github.com/fiforms/reliefinventory/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiforms%2Freliefinventory/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29464160,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T01:01:38.065Z","status":"ssl_error","status_checked_at":"2026-02-15T01:01:23.809Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["database","disaster-relief","laravel","php"],"created_at":"2025-02-20T22:21:17.133Z","updated_at":"2026-02-15T01:33:11.922Z","avatar_url":"https://github.com/fiforms.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# About Relief Inventory\n\nRelief Inventory is a collaborative open source software project to facilitate tracking of donated goods in disaster response scenarios. \nIt was originally developed in cooperation with Adventist Community Services to facilitate warehouse management.\n\nYou can find the latest information about the Relief Inventory project at our [website](https://reliefinventory.fiforms.net)\n\n# Setup \n\nThis software utilizes the Laravel Open Source PHP Framework and related software. The following brief list of steps\nshould help you to get an instance up and running in your environment:\n\nInstall prerequisite packages:\n\n** Use your package manager to install relevant packages, i.e. **\n\n    sudo apt install php php-cli composer mariadb-server php-mysql php-redis git php-xml npm\n\n** Clone the Repository (or see below for using the Eclipse editor instead) **\n\n    git clone https://path/to/reliefinventory\n\n** Create a database to hold data (change YourPasswordHere accordingly) **\n\n    mysql\n    create user reliefinventory@localhost identified by 'YourPasswordHere';\n    create database reliefinventory;\n    grant all on reliefinventory.* to reliefinventory@localhost;\n    exit\n\n** Create your local configuration, and edit .env, adding the database info and password you created above **\n\n    cd reliefinventory\n    cp .env.example .env\n    nano .env\n\n** Install Laravel packages using composer **\n\n    composer install\n    php artisan key:generate\n    \n  \n** Install node packages **\n\n    npm install\n\n** Create datastructures **\n\n*(If you have a database backup, this would be the point to restore it instead)*\n\n    php artisan migrate\n  \n** Create a new user (YOU MUST do this before loading test data) **\n\n    php artisan user:create\n  \n** Load initial data **\n\n    # Creating essential data\n    php artisan db:seed\n    \n*This is a great place to import site-specific data. Refer to site-specific documentation outside of GitHub*\n    \n    # (Optional) Load additional test data, if you aren't importing site-specific data\n    php artisan db:seed --class=TestDataSeeder\n\n# Updating\n\nAfter updating (git pull, etc) you may need to run some or all of these commands:\n\n    php artisan migrate\n    composer install\n    npm install\n\n\n# Running in a testing environment \n\n** Spin up the instance from the command line **\n\n    composer run dev\n  \n# Running in Production\n\n(These steps are still incomplete)\n\n** If you're going to run this in a server environment, you'll need a webserver like Apache or nginx, as well as a cache server **\n\n    sudo apt install apache2 redis\n\n** Setup SMTP Server **\n\nModify these values in .env to point to a working SMTP server, e.g. you can \nuse an app password from Gmail and relay through a gmail account:\n\n    MAIL_MAILER=smtp\n    MAIL_HOST=smtp.gmail.com\n    MAIL_PORT=587\n    MAIL_USERNAME=my_email_address@example.com\n    MAIL_PASSWORD=apppasswordhere\n    MAIL_ENCRYPTION=tls\n    MAIL_FROM_ADDRESS=\"my_email_address@example.com\"\n    MAIL_FROM_NAME=\"${APP_NAME}\"\n    \n** Setup Cloudflare Turnstile for User Registration **\n\nGet a Turnstile Site Key and Secret Key from [Cloudflare](https://www.cloudflare.com/application-services/products/turnstile/)\n\nPut them into .env:\n\n    CLOUDFLARE_TURNSTILE_SITE_KEY=\n    CLOUDFLARE_TURNSTILE_SECRET_KEY=\n\n** Ban User Signups from Disposable Email Domains **\n\nDownload the listing of disposable domains from \n[this GitHub Project](https://github.com/disposable-email-domains/disposable-email-domains)\n\n    php artisan user:import-banned /path/to/disposable_email_blocklist.conf\n    \n** Import Listing of Counties **\n\nDownload a county listing from the [census.gov website](https://www.census.gov/library/reference/code-lists/ansi.html#cou)\n\n    php artisan counties:import /path/to/downloaded/file.txt\n\n** Recompile Project **\n\n    composer dump-autoload --optimize\n    npm run build\n  \n  \n# Eclipse IDE\n\nThe Eclipse IDE is a helpful editor that can streamline your workflow. You can download [Eclipse IDE for PHP Developers](https://www.eclipse.org/downloads/packages/)\n\n# MySQL Workbench\n\nA helpful graphical tool for working directly with the MySQL Database is MySQL Workbench from Oracle. (If you're using MariaDB as suggested above, you'll get a warning about compatibility but it does work well with MariaDB). You can [download MySQL Workbench here](https://www.mysql.com/products/workbench/)\n\n\n# LICENSE\n\n## Relief Inventory - Open Source Software\n\n### Copyright (C) 2024-2025 Adventist Community Services\n    This program is free software: you can redistribute it and/or modify\n    it under the terms of the GNU General Public License as published by\n    the Free Software Foundation, either version 3 of the License, or\n    (at your option) any later version.\n    \n    This program is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    GNU General Public License for more details.\n    \n    You should have received a copy of the GNU General Public License\n    along with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n\n## Original Authors\nThis software was originally designed and written by \"The Preacher Hackers,\" a group of Seventh-day Adventist Ministers dedicated to the cause of helping those in need. Original contributing authors include [Daniel McFeeters](https://www.pastordaniel.net), Mark Kent, and Jonathan Cantrell.\n\n## Purpose and Rationale\nThe **Relief Inventory** project is an open-source software system designed to facilitate the management of donated goods in disaster relief efforts. It allows organizations to efficiently track, store, and distribute donated items to those in need. The goal of this project is to provide a **transparent, accessible, and collaborative** solution that enhances humanitarian aid operations.\n\nTo ensure that this software remains open and freely available to all, the project is licensed under the **GNU General Public License v3.0**. This license ensures that:\n- The software remains **free and open-source** for anyone to use, modify, and distribute.\n- Any modifications or derivative works are also **licensed under GPL-3.0**, preserving openness.\n- Users have the **freedom to improve** the software while contributing back to the community.\n\nPlease see [LICENSE.md](LICENSE.md) for details\n\n## Attributions, Disclaimers and Additional Free Licenses\nMuch of the code in this project has been generated by the \"artisan\" command in [Laravel](https://laravel.com/), with modifications made to fit the requirements of this project. Additonal code has been generated or modified through the use of Large Language Models such as ChatGPT in order to accelerate the development process. However, it is the belief of the developers that such use of existing tools should not influence the licensing terms set forth above. \n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiforms%2Freliefinventory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiforms%2Freliefinventory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiforms%2Freliefinventory/lists"}