TitoMoi / servihelper

Servihelper is an executable application (Windows, Mac or Linux) for the creation of assignments and territories.
MIT License
8 stars 0 forks source link
jw jw-org servihelper

logo

Introduction

Servihelper is an app that runs on the machine 🖥️ (Windows, Mac or Linux)

Does not work on mobile phone 📱 or tablet (Android, iOS) But it works on Windows tablet.

The program is free. 🙅‍♂️💵

Your data is managed internally on the local device with .json and .gz files, so it never goes to the internet.

Its purpose is for help the Jehovah's witnesses to:

And also:

Download links

Download app section: Download for Windows, Mac or Linux.

The executable is not recognized on Mac

Thats because i dont have an Apple developer Id (i have to pay for it), you need to trust the binary manually, go to:

mac -> security tab -> general tab and below the section are the instructions to allow it.

allow-mac

More help: Open a Mac app from an unidentified developer

The executable is not recognized on Windows

The same as Mac, you need to trust the binary manually, when the smart screen appear, confirm that you want to open it:

windows smart screen

Example images

S89 slip:

example

Native, general purpose assignment slip:

example

Example territory images

Overview:

map-overview

Edition:

map-update

Heatmap:

map-heatmap

Languages

Available interface languages are at the end of the page.

In case your language is not supported, you can customize the native slip and the s89 slip with your language in the config section.

Only the time format can't be changed, but you can select a lang that suits your format.

Benefits and disadvantages of using an offline app

Offline (Servihelper) vs other online solutions Servihelper(offline) Online apps
Free Yes Most yes (but requires donations to maintain servers and can change in the future) and some others you have to pay
Immediate update and fixes No (you need to download new version) Yes
Multiple administrators at the same time (real time) No (works importing and exporting copies, most of the tasks dont really need real time) Yes
Needs mobile version No Some yes (i see it as overengineering or privacy concerns)
Can receive web attacks and lose data No Yes
Privacy Files are in admin. computer or google drive Files are encrypted on backend servers
Restore backups Just import an old copy Depends on how app admins. do this

What cannot be done or implemented?

Ways of work with multiple administrators 🧑👨‍🦰🧔

Free mode:

  1. Use 'google drive desktop app' (or other solution) to centralize and share copies of servihelper.

    • Do not enable: config -> online mode.
    • Required knowledge of how to install and run google drive desktop app (or other desktop solution)
    • Your responsability to ensure that you have the last backup before working.
    • Import the last backup, work locally and when finished, export a new copy to the shared folder. (little complexity and a bit of overhead, on finish your work you have to remember to save your backup to the shared folder. ✅ this is the most robust approach and the one i recommend)
  2. Export the app data from administrator one and importing in the app of the administrator two sharing the copy through email or whatsapp (⚠️ not recommended)

    • Do not activate: config -> online mode.
    • Do not use shared folder (google drive or others...)
    • (Easy, no complexity but an overhead to understand wich and where is the latest copy)
  3. Enable built in online mode with a shared folder (google drive, one drive... advanced mode)

    • Enable: config -> online mode (Required setup inside Servihelper in the config section to configure the shared folder)
    • Required knowledge of how to install and run google drive desktop app (or other desktop solution)
    • Your responsability to ensure that all files are synchronized before working.
    • Warning: Sometimes data is not updated on real time.
    • (this way of work has configuration complexity but later has less overhead, just check you are online and google drive is working and files are up to date before working)
    • (this scenario is not real time, it just works directly with the files instead of with copies, you MUST export a security copy from time to time for security)

Paid mode 💲:

(If money is not a concern, it's better in terms of complexity to use another theocratic online tool instead of configure a server just for servihelper)

If you want to continue, configure a remote desktop and avoid the need to export and import data manually. This requires a person with medium/advanced skills and a bit of overhead to configure. And also a platform mantainance over time (⚠️ not recommended)

Guide to configure a remote desktop with kamatera

Way to create assignments

Open Servihelper and open jw library app, split the screen between Servihelper and jw library.

First, create participants.

Then on creating the assignment copy the assignment title from jw library and put it on the "theme field":

create-assignment

Then, select the participant/s* and click the create button (or create another assignment):

*The algorithm used to sort the participants is based on participation of that assignment type and then are sorted again by time distance. Also, there is a yellow and red clock helpers to distribute the effort along the year. This ensures equallity among all the participants, but there are special cases where you need the global participation view.

*The global view: Assign participants only by global count (round robin queue) is a bad measure and can lead to repeat assignment types just because it's the participant turn. It's better to assign participants by assignment type and then by time distance. This way, the participants will have a more balanced work load. When there are many participants, it's a good idea to increase the 'distance in days clock' (yellow clock in settings section) that prevents the participant to take another assignment in a long time. Anyway, when creating the assignment you also have the global count option.

The global view ensures faster times to make an assignment but punishes the participant to do diferent assignment types. Use this view wisely.

Best order to create assignment types based on priority

  1. First, create life & ministry assignments.
  2. Second, create weekend meeting assignments.
  3. Third, create other assignments (video, audio, etc...)

¿Can I distribute the app?

Yes, although it is recommended that you distribute the download link, as a new version may have come out with some correction or new feature.

¿How do I distribute the assignments?

¿How do I distribute the territories?

When selecting the participant for the assignment, a number is displayed next to it, what is it?

It is the number of times the participant has participated in that type of assignment with that role (principal or assistant)

The display list is sorted by participation and then is again sorted by time. You can click the "info" blue icon to have more details.

¿How do I report a bug or ask for a feature?

You can use github issues or send me an email to servihelper@gmail.com

¿Can it be translated to my language?

Yes, send me the file located on assets/i18n/en.json translated attached by email and the name of the language.

Available languages