medic / bikram-sambat

Javascript and Java utilities for converting between the Nepali Bikram Sambat (Vikram Samvat) and Gregorian (standard European) calendars.

The Core Framework of the Community Health Toolkit (CHT)

This is the repository of the CHT Core Framework, a technical resource of the Community Health Toolkit (CHT) contributed by Medic.

Medic is a nonprofit organization on a mission to improve health in the hardest-to-reach communities through open-source software. Medic serves as the technical steward of the Community Health Toolkit.

For the latest changes and release announcements see our release notes. Our exact support matrix (including older app versions) can be found in our docs.

Overview

The CHT's Core Framework is a software architecture that makes it faster to build full-featured, scalable digital health apps that equip health workers to provide better care in their communities. To learn more about building an application with the Core Framework, visit our guide for developing community health apps.

The Core Framework addresses complexities like health system roles and reporting hierarchies, and its features are flexible enough to support a range of health programs and local care provider workflows.

Mobile and web applications built with the Core Framework support a team-based approach to healthcare delivery and management. Health workers can use SMS messages or mobile applications to submit health data that can then be viewed and exported using a web application. These web applications are fully responsive with a mobile-first design, and support localization using any written language. They can be installed locally or in the cloud by setting up the individual components or as a Docker container.

For more information about Medic's architecture and how the pieces fit together, see Architecture Overview. For more information about the format of docs in the database, see Database Schema. For more information about the SMS exchange protocol between webapp and gateway, see Message States.

Using the Core Framework

If you are a developer looking to contribute to the Core Framework itself, you should follow the development setup instructions.

If you wish to evaluate the Core Framework, or you are a developer looking to create or modify applications built with the Core Framework, you can instead follow the easy deployment instructions, which will get the latest stable release running locally via Docker.

You will need to also familiarise yourself with cht-conf, a tool to manage and configure your apps built using the Core Framework. A brief guide for modifying the config is available alongside the config. A more detailed guide is available in cht-docs.

Supported Browsers

Currently, the latest versions of Chrome, Chrome for Android and Firefox are functionally supported. We do not support Safari (unreliable implementations of necessary web APIs) and the generic android browser (unreliable implementations in general). Our webapp code, which includes any code written as configuration, is still ES5. Our exact support matrix (including older app versions) can be found in our docs.

Contributing

The Core Framework of the Community Health Toolkit is powered by people like you. We appreciate your contributions, and are dedicated to supporting the developers who improve our tools whenever possible.

To setup a development environment to contribute to the Core Framework follow the development instructions.

First time contributor? Issues labeled help wanted are a great place to start.

Looking for other ways to help? You can also:

• Improve documentation. Check out our style guide here
• Review or add a translation
• Find and mark duplicate issues
• Try to reproduce issues and help with troubleshooting
• Or share a new idea or question with us!

The easiest ways to get in touch are by raising issues in the medic Github repo or joining our Community Forum.

For more information check out our contributor guidelines.

Build Status

Builds brought to you courtesy of GitHub Actions.

Copyright

Copyright 2013-2022 Medic Mobile, Inc. [email protected]

License

The software is provided under AGPL-3.0. Contributions to this project are accepted under the same license.

bikram-sambat's Issues

Request for adding date separator variations and date formats.

Can you please provide the separator variations such as /, :, -, ., etc. It would be so much helpful. And also the formats for date such as: YYYY-mm-dd, mm-dd-YYYY, etc just like the javascript Date object does.
I would be delighted by your response... :)

Converters don't work with newly added dates

Pr #10 has been merged adding more dates.
Unfortunately, converters don't work with those dates.

BsCalendar.getInstance().toBik() throws an expception:
bikramsambat.BsException: Date outside supported range:

and BsCalendar.getInstance().toGreg() returns year 1950 for all newly added years.

@garethbowen

Create Java8 Chronology

https://docs.oracle.com/javase/8/docs/api/index.html?java/time/chrono/Chronology.html

travis tests should run on web browsers

Android project or another

Hi . I clone this project thinking as android project, but gradle has not any configuration for android project. I am very new at android project and with gradle build tools, i have no idea. I would be very glad to reciev your response

May be bugs and disagreements between java and javascript implementation

• Test data starts at 2000 BS: https://github.com/medic/bikram-sambat/blob/master/test-data/daysInMonth.json
• javascript implementation starts at 2007 BS: https://github.com/medic/bikram-sambat/blob/master/js/src/index.js#L7
• 3rd party implementation suggests that our days-in-month for year 2000 BS are incorrect: https://github.com/medic/bikram-sambat/blob/master/test-data/daysInMonth.json#L2 vs https://github.com/bahadurbaniya/Date-Converter-Bikram-Sambat-to-English-Date/blob/master/src/main/java/np/com/converter/date/nepali/Lookup.java#L233, even though this implementation seems to agree with ours for dates output

Steps forward:

1. write new level of testing which tests the output of our javascript and java implementations against each other
2. write new level of testing which tests the output of our java or javascript against implementation at https://github.com/bahadurbaniya/Date-Converter-Bikram-Sambat-to-English-Date

skip #4

Incorrect daysInMonth data for year 2081

bikram-sambat/test-data/daysInMonth.json

Line 113 in c730b32

"2081": [31, 31, 32, 32, 31, 30, 30, 30, 29, 30, 30, 30],

In Bikram Sambat year 2081:

• 2nd month should have 32 days
• 3rd month should have 31 days

Reference

• opensource-nepal/node-nepali-datetime#79
• https://english.hamropatro.com/calendar/2081/3
• https://english.hamropatro.com/calendar/2081/4

Throw an error on bikram-sambat-bootstrap for invalid date

The updateBackingDateInput function sets the date only when the date is valid. Because of this in a form when a date is updated and invalid date is inputed by user, an error is not thrown since the bootstrap would still give the valid old date because of this condition.

We should be setting whaterver the converted value is coming instead of setting the value only when valid date is available. The current behavior causes issues like this.

Create Android Chronology

https://developer.android.com/reference/java/time/chrono/Chronology.html

Create JodaTime Chronology

• http://www.joda.org/joda-time/key_chronology.html
• http://joda-time.sourceforge.net/apidocs/org/joda/time/chrono/BaseChronology.html

Support more dates (eg. <1950)

I work as an Android developer on ODK Collect where we use this project.
Recently one of our users wanted to use not supported dates <1950
https://forum.opendatakit.org/t/bikram-sambat-nepali-date-widget/16844

Is it possible to support more dates?

travis tests should run on web browsers