matijamatija/open_insure

Open source insurance policy management software

Open insure

Take control of your insurance

• setup group insurance for you and your friends
• Browse and pick group insurance policies that are right for you
• 100% of unused premiums get returned to you at the end of the period
• Manage claims against your policies with a direct democracy, opt for "jury duty" or elect representatives to manage on your behalf

Apps overview

Pods

• User profile
• Groups of users
• Permissions/Roles
• User authentication

Policies

• Coverage types (e.g. property, renters, etc.)
• Policy types (Capped Pool, Perpetual Pool, Capital Call)
• Claims
  • Settlement type (Commitee or direct democracy)
  • Claim evidence (Pictures, statements)
  • Claim Approvals (Votes from policy holders)

Development

Environment Setup

VS Code

VS code settings for formatting code with prettier are set for this package, if you choose to use another code editor please run prettier before committing with Front End: npx prettier --write src/**/*.tsx

1. Install VS code
2. Use VS code

API Setup

1. Copy .env.example and rename the copy to .env
2. Run the following commands:

  pipenv install

  pipenv shell

  pipenv run python manage.py migrate

  pipenv run python manage.py createsuperuser

  pipenv run python manage.py runserver

Note: database is all sqlite, proper db settings setup to come

For development notes see: roadmap.md

Frontend Setup

In frontend directory: Copy .env.example and rename the copy to .env

In a separate terminal window, run the frontend

  cd frontend

  npm install

  npm run start

setup help

If you're running on a mac you might need to set up postgres for psycopg2, pythons postgresql driver:

brew install libpq --build-from-source
brew install openssl

export LDFLAGS="-L/opt/homebrew/opt/[email protected]/lib -L/opt/homebrew/opt/libpq/lib"
export CPPFLAGS="-I/opt/homebrew/opt/[email protected]/include -I/opt/homebrew/opt/libpq/include"

pipenv install

Docker

Build command docker build -t insure .

Code Review Process

1. Create and push a new branch
2. Create new Pull Request in Github

Deployment

Backend python manage.py migrate

gunicorn open_insure.wsgi:application --access-logfile=- --bind 0.0.0.0:8000 --capture-output --enable-stdio-inheritance

Frontend npm run build (I often build on a seperate machine that has more RAM than the typical prod server and copy the build folder over) serve -s build