{"id":24911465,"url":"https://github.com/hackoregon/housing-2018","last_synced_at":"2025-10-16T22:30:32.529Z","repository":{"id":49698054,"uuid":"118858551","full_name":"hackoregon/housing-2018","owner":"hackoregon","description":"Housing Project for the 2018 Project Cycle","archived":false,"fork":false,"pushed_at":"2021-06-10T20:13:48.000Z","size":3987,"stargazers_count":2,"open_issues_count":5,"forks_count":4,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-04-09T10:45:48.664Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/hackoregon.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}},"created_at":"2018-01-25T03:44:26.000Z","updated_at":"2019-09-29T01:43:59.000Z","dependencies_parsed_at":"2022-09-24T00:23:29.838Z","dependency_job_id":null,"html_url":"https://github.com/hackoregon/housing-2018","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hackoregon/housing-2018","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackoregon%2Fhousing-2018","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackoregon%2Fhousing-2018/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackoregon%2Fhousing-2018/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackoregon%2Fhousing-2018/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hackoregon","download_url":"https://codeload.github.com/hackoregon/housing-2018/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackoregon%2Fhousing-2018/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279249037,"owners_count":26133926,"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","status":"online","status_checked_at":"2025-10-16T02:00:06.019Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-02-02T04:20:17.502Z","updated_at":"2025-10-16T22:30:31.985Z","avatar_url":"https://github.com/hackoregon.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Housing Affordability 2018\n\n## Goal\nSynthesize complex information to understand the state of housing market and promote a vision for long-term affordability.\n\n## About this Repository\nThe housing-2018 repository contains a Django Rest Framework-based API for serving up housing-related data. The API runs in Docker and is based on the example API from https://github.com/hackoregon/backend-examplar-2018. Separate from this API, the branch `elastic-exploration` contains a Docker-based Elasticsearch and Kibana environment for exploring housing-related data. This system was used at the beginning of the project and may be phased out as we focus on the Django API.\n\n## API\nThis API provides access to all of the data contained in the Harvard Joint Center for Housing Studies 2017 State of the Nation's Housing report appendix tables. You can view all data by going to /housing/api/harvardjchs/, or filter by various values. To see all possible options, view the schema at /housing/schema/, or browse the possible filters from /housing/api/harvardjchs/meta/.\n\n## Running locally\nTo run the API:\n1. Clone the repo: `git clone https://github.com/hackoregon/housing-2018.git`\n2. Create a `.env` file in the root folder based on `env.sample`. This can be easily done by `cp env.sample .env`. Make sure to change the Django Secret Key and Postgres password for any versions that will be on the internet.\n3. Build the development containers by running `./bin/build.sh -d`. The -d flag builds the development version and it will run `docker-compose` with `development-docker-compose.yml`. The other option is `-p` for production. If you do not have permission to run, run `chmod +x bin/build.sh` to allow execution.\n4. Start the project by running `./bin/start.sh -d` which will run `docker-compose up` using the `development-docker-compose.yml` file. Once these containers are up and running you can access the Swagger schema site at `http://localhost:8000/housing/schema`.\n\n## Generating database restore files\nThe current operating procedure for Hack Oregon projects is to have each project generate a SQL file containing a backup/restore of the full DRF database (with data) that will feed the API. This file will then be loaded into the production database on AWS. You can generate this file by running all of the Django migrations and loading all of the data into the development database and then running `pg_dump` with options `-Fp -v -C -c` enabled in order to get the proper commands included. See https://www.postgresql.org/docs/9.6/static/app-pgdump.html for details on these options.\n\nWe have setup the development container to automatically generate this backup once it has finished loading the data into the development database, and it saves the file in the Backups folder with the file name being the name of the database.\n\nWe will add more details about the development process and how to contribute to this project as the process is hashed out in `https://github.com/hackoregon/backend-examplar-2018`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackoregon%2Fhousing-2018","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhackoregon%2Fhousing-2018","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackoregon%2Fhousing-2018/lists"}