sarapis / fusio-orapi-hsds1.1

Human Service Data API Suite - https://openreferral.readthedocs.io/en/latest/hsda/
GNU General Public License v3.0
0 stars 0 forks source link

Deploying another instance of this #1

Open one000mph opened 4 years ago

one000mph commented 4 years ago

Hello Maxim & Devin. I'm working with a small team on behalf of WA 211 in an effort to create a new search app. This project seems like a good place to start but I've had some trouble getting this app running in my local environment. I'm not super familiar with PHP, however, so part of my issue may just be user error.

It looks like the README is intended for someone who already has a PHP server ready to go. I was able to get your Laravel app running locally with docker, but I haven't had luck with this repo. Is it possible to run this fusio API locally to test out the endpoints? If so, can you provide some direction on this process for me? What does your development workflow look like? I looked at the fusio-electron app project but wasn't quite sure how to make that work with this project. I also have access to some Linux servers if you think it would be easier to configure on a remote machine.

I am also a bit concerned about the fusio-orapi.sql file that is present in the repo. This looks to be a dump of all the Miami 211 data including the fusio route configuration. This is confusing to me since fusio documentation seems like rely upon a set of .yml files which do not appear in the repo. Are these files available somewhere? I'd rather not rely upon the sql dump to reconstruct the .yml configuration.

Thanks for your time and I hope that it will work to collaborate on this project.

soundpress commented 4 years ago

Hi Heather,

Actually the API if fully functioning and README installation flow should be working correctly. I guess you may experience troubles calling git clone or composer update instructions. Really there is a gap in Environment section of README. Git and composer are two separate apps which should be also installed before API installation. If you fail any other instruction please let me know.

API uses two databases:

.yml is just one of several file types used by Fusio to describe API logic. There are settings which can not be entered with configuration files and require manual installation. So prepared configuration dump is much more usable for quick start. .yml and other files along with full fusio manual is needed if you want to work deeply with API structure. php development skills are also necessary in second case as low layer data model is developed with php. Please let me know if you need .yml and other configuration files so I will add them to the repo.

Thanks for your efforts and questions, so we can find bottlenecks and make the product more easy to launch and use.