/sanwada

Forum service built on microservices architechture

Primary LanguageJava

sanwada forum service

Sanwada is sinhala term (සංවාද ) which literally translates into discussion. In software terms Sanwada is forum services which enables creation/alteration/deletion of typical forum related entities such as question/posts, answers/comments, points and flags. Sanwada provides the forum engine that can be deployed in a microservices environment excluding the frontend for the forum engine. This gives you the room to BYOUI (Bring Your Own UI) solving the issue of inabality to decouple unpleasent UI that are glued with many popular open source and commerical forum software.

High level view

hight level view

Sanwada when deployed should be assisted with a frontend service and a authentication/authorization service.

Building

$ git clone https://github.com/whitejninja/sanwada.git
$ cd sanwada
$ gradle build

Testing

$ gradle check

Deploying

Although any .war file can be run in a Java containered appliction server, It is recommended to deploy Sanawada with glassfish application server.

Start application server

$ $GLASSFISH_INSTALL_DIR/bin/asadmin start-domain

deploy sanawada.war

$ $GLASSFISH_INSTALL_DIR/bin/asadmin deploy build/libs/sanwada.war

Contributing

If you intend to contribute to Sanwada please make a pull request. We would like to inform you that as a convention we follow Java style guide published by Google. If you use eclipse as your IDE goto windows -> preferences -> Java -> formatter and import eclipse-java-formatter.xml at the project root which follows Google's code style.

The developer documentation is accessible at Developer documenation