Skip to content
Use Minimily to organize your minimalist life.
Clojure JavaScript TSQL Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
config
docs
resources
src/minimily
test/minimily
.gitignore
CHANGELOG.md
LICENSE
Procfile
README.md
app.json
project.clj

README.md

Minimily

Minimily is an application designed to help you keeping your life as simple as possible. We will help you to make decisions taking into account the impact on your health, family, living place, community and environment.

CircleCI

Requirements

Minimily is a web application and it has 3 requirements:

  1. PostgreSQL is a database that scales from a Raspberry PI to a high availability cluster. It requires some additional configuration at the beginning, but it is quite straightforward to work with.

  2. The application is developed in Clojure, a language hosted on the Java Virtual Machine (JVM), which means it depends on a Java environment to work. The JVM is well known for its performance and large ecosystem.

  3. Leiningen is a build tool for Clojure applications. It is used during development, packaging and deployment.

Installing PostgreSQL

Execute the following commands to install PostgreSQL:

$ sudo apt-get install postgresql
$ sudo su - postgres -c "createuser -s $USER"

Then create the database for the application:

$ createdb minimily
$ createuser minimily -P
$ psql -d minimily
  =# grant connect on database minimily to minimily;
  =# \q

Installing JVM

Installing Leiningen

Run from the terminal (dev profile):

$ lein run

Run from the REPL (dev profile):

$ lein repl
minimily.web=> (start-server 3000)
minimily.web=> (stop-server)

Package the application into a jar file (uberjar profile with prod config):

$ lein uberjar

Run the jar package:

$ java $JVM_OPTS -cp target/minimily-standalone.jar clojure.main -m minimily.web

To deploy to Heroku, make sure you have a PostgreSQL database and an environment variable named DATABASE_URL.

Code Conventions

The application is organized in decoupled modules. They are:

  • accounting: manages the finances of the family
  • documents: manages digitalized and phisical copies of documents
  • family: define the family, its members and the relationship between them
  • inventory: manages all objects in the house
  • auth: manages the authentification of users

Each module contains two basic folders:

  1. model: contains the code that access sources of data to add, search, retrieve, modify and delete records
  2. web: contains the code renders the web user interface to enable all possible data operations

The model is divided in two parts:

  1. sql: a collection of sql queries organized by entity, keeping them separated from the model logic.
  2. model workspace: the model that manages the data of the entities.

The web is divided in four parts:

  1. routing: associates urls with controller functions that return web content.
  2. controller: functions that receive requests from web clients and interact with the model to generate responses expected by the clients.
  3. ui:
  4. api:

Functions

  1. The prefix get- indicates the function returns a single value or record.
  2. The prefix find- indicates the function returns a collection of values or records.

License

Copyright © 2017-2018 Hildeberto Mendonca

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.

You can’t perform that action at this time.