Estatio Open Source Estate Management built on Apache Isis
Java HTML Other
Latest commit 831d71b Feb 17, 2017 @jcvanderwal jcvanderwal Merge branch 'EST-1119'

README.adoc

Estatio: an open source estate management system.

Estatio is modern and flexible property management software. It offers real estate professionals and service providers the power and flexibility to manage their business in a superior, flexible and cost-effective manner.

Screenshots

The following screenshots (taken 13 december 2014) correspond to the business logic in Estatio’s domain object model.

All properties

AllProperties
AllProperties Map

Lease

Lease

LeaseItem

LeaseItem

Invoice

Invoice

Trying out Estatio

Building Estatio

Prereqs

Estatio runs on Java and is built with Maven. The source code is managed using git, and is held on github.

If you don’t already have them installed, install Java (JDK 6 or later), Maven (3.0.4 or later), and git.

After that, you’ll need to manually build and install the google RFC-2445 Jar (this is not available in Maven Central repo).

git clone https://github.com/jcvanderwal/google-rfc-2445.git
cd google-rfc-2445/
git checkout mavenized
mvn clean install -DskipTests

Download and build Estatio

Download using git:

git clone https://github.com/estatio/estatio.git
cd estatio

and build using maven:

mvn clean install

The clone is approx 400Mb, and takes approximately 5 minutes to build.

Configure Estatio (JDBC URL)

Before Estatio can be run, you must configure its JDBC URL; typically this lives in the webapp/src/main/webapp/WEB-INF/persistor.properties properties file.

You can do this most easily by copying a set of property entries from webapp/src/main/webapp/WEB-INF/persistor-SAMPLE.properties.

For example, to run against an in-memory HSQLDB, the persistor.properties file should consist of:

isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionDriverName=org.hsqldb.jdbcDriver
isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionURL=jdbc:hsqldb:mem:test
isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionUserName=sa
isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword=

The JDBC driver for HSQLDB is on the classpath. If you want to connect to some other database, be sure to update the pom.xml to add the driver as a <dependency>.

Run Estatio

You can run Estatio either using mvn jetty plugin, or using the standalone (self-hosting) version of the WAR:

  • Running through Maven

    Run using:

    mvn -pl estatioapp/webapp jetty:run
  • Running as a self-hosting JAR

    Package using:

    mvn -pl estatioapp/webapp -Dmavenmixin-jettyconsole package

    and run using:

    mvn -pl estatioapp/webapp -Dmavenmixin-jettyconsole antrun:run

Once the app has started, browse to:

http://localhost:8080/wicket/

Using Estatio

  • Login using estatio-admin/pass or estatio-user/pass.

  • Install some demo fixtures (as estatio-admin):

    Prototyping > Run Fixture Script > Run script: Estatio Demo Fixture
  • Run a script to setup invoices:

    Prototyping > Run Fixture Script > Run script: Generate Top Model Invoice

And take a look around :-)

If you encounter any bugs, do let us know.

Developers' Guide

A developers guide can be found here.

Thanks

Thanks to:

Support

You are free to adapt or extend Estatio to your needs. If you would like assistance in doing so, go to www.estatio.org.

You can find plenty of help on using Apache Isis at the Isis mailing lists. There is also extensive online documentation.

Copyright 2012-`date` Eurocommercial Properties NV

Licensed under Apache License 2.0