A cat directory made for the Cal Poly Cat Program (CPCP)
The Cal Poly Cat Program (CPCP) is a non-profit organization of students, faculty, staff and community members who care about the health and happiness of both feral and domesticated cats. This software was made to decrease logistical friction (they were using paper filing and a large excel sheet) so they could focus on helping the cats. This site is currently live here.
There is also an accompanying mobile app for this site! The repository can be found here.
- Sydney Nguyen @syddaddie - Designer
- Finlay Piroth @finlaylp - Mobile Developer
- Jillian Quinn @JillianQuinn - Mobile Developer
- Jay Sung @jaysungl42 - Frontend Developer
- Evan Witulski @ewitulsk - Backend Developer
- Ethan Zimbelman @Zimboboys - Team Lead / Full Stack Developer
The web portion of this application was made in Django. The following will assume you have Python, Django, and pip installed.
- Clone the repo
git clone https://github.com/hack4impact-calpoly/calpoly-cat-program - Install postgresql [ Mac OS | Windows | Linux ]
- Move into the directory by using
cd calpoly-cat-programand install the dependanciespip install -r requirements.txt - Configure the environment variables in
.defaultenvand rename it to.env - From the command line, run
python manage.py migrate, thenpython manage.py runserver - Hopefully the site is up and you can visit it at localhost:8000
This site is deployed on Heroku, which is nice because it is free, but not nice because it won't store files long term. To get around this, we use s3 for file storage. This should be fine because s3 is cheap.
Note: Deploying with static files on Heroku is difficult. Keep the server in DEBUG=True mode to counter this
To setup s3 file storage, do the following. This assumes you have an AWS account.
- Create an IAM user with the AmazonS3FullAccess policy attached
- Copy these credentials into your
.env - Create an S3 bucket and enable CORS
- Copy the bucket name to your
.envfile and change ISPROD to True - Start the web server