https://github.com/luontola/territory-bro

Tool for managing congregation territory cards
https://github.com/luontola/territory-bro

Last synced: 4 days ago
JSON representation

Tool for managing congregation territory cards

• Host: GitHub
• URL: https://github.com/luontola/territory-bro
• Owner: luontola
• License: apache-2.0
• Created: 2015-11-06T19:57:13.000Z (about 9 years ago)
• Default Branch: main
• Last Pushed: 2024-10-29T18:26:03.000Z (16 days ago)
• Last Synced: 2024-10-29T20:33:21.036Z (16 days ago)
• Language: Clojure
• Homepage: https://territorybro.com
• Size: 6.25 MB
• Stars: 2
• Watchers: 3
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Territory Bro

Territory Bro is a tool for managing territory cards in the congregations of Jehovah's Witnesses.

For more information, see 

[![Build Status](https://luontola.semaphoreci.com/badges/territory-bro/branches/main.svg?style=shields)](https://luontola.semaphoreci.com/projects/territory-bro)

## Running

The easiest way to run this application is to use [Docker](https://www.docker.com/products/docker-desktop).

Start the database

    docker compose pull

    docker compose up -d db

Start the application

    docker compose up -d app

The application will run at http://localhost:8080

Stop the application (does not remove the database volume)

    docker compose down

## Developing

The tools for developing this project are

[Java JDK](https://www.oracle.com/java/technologies/downloads/),

[Leiningen](https://github.com/technomancy/leiningen),

[Node.js](https://nodejs.org/) and

[Docker](https://www.docker.com/). It might also be useful to have the [PostgreSQL](https://www.postgresql.org/) command

line tools, even if you run the database with Docker.

Install dependencies

    npm install

Build the frontend assets for the backend (once or automatically)

    npm run build

    npm run autobuild

Start the database

    docker compose up -d db

Start the backend, it will run at http://localhost:8080

    lein repl

    (start)

Restart the backend, reloading code changes

    (reset)

Run tests

    lein test

    npm run test

Run tests selectively

    lein kaocha fast

    lein kaocha slow

    lein kaocha e2e

Run tests automatically on change

    lein autotest

    npm run autotest

Upgrade dependencies

    lein ancient upgrade :all :check-clojure :no-tests

    npm run upgrade

    asdf install java latest:temurin-21

    asdf local java latest:temurin-21

    asdf global java latest:temurin-21

    asdf install nodejs latest

    asdf local nodejs latest

    asdf global nodejs latest

Download dependency sources

    lein pom

    mvn dependency:sources

Produce canonical XML for better diffs

    xmllint --c14n11 example.qgs > resources/template-territories.qgs

## License

Copyright © 2015-2024, [Esko Luontola](https://www.luontola.fi)

This software is released under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).