[DMP 2024]: Implementer Friendliness for Avni

vinayvenu commented 4 months ago

Ticket Contents

Description

An implementer on Avni is someone who configures Avni for an NGO. An NGO is setup as an "organisation" on Avni. The implementer typically works with a dozen different NGOs. Avni requires mechanisms for these implementers to be able to configure Avni easily and without making mistakes. A list of changes that will help is given below. Scroll further down for details on each

Organisation health verification (M)
- Overall organisation metadata health verification
- Overall organisation data health verification
- Apply immediate health verifications when making changes (such as setting up subject types)
Organisation metadata migration (L)
- Allow definition of organisation types (test, production etc)
- Create mechanisms to migrate metadata across organisation types. This will include ways to visualise a metadata diff across organisations
- Allow mechanisms to recreate test environments from production
- Bonus: Allow partial migrations across organisation
Improve usability of the csv upload feature on Avni (S)
- Good error messages
- Good sample files (with data)
Miscellanous (S)
- Verification and fix of documentation
- Ability to remove fast sync for an organisation
- Disallow fast sync for an organisation
- Disallow all sync for an organisation

Organisation health verification

When running an organisation on Avni, it is important to pinpoint any data or metadata problems in the system so that we prevent problems in the future by easily fixing them. Specific problems include

Sync attributes set up incorrectly in data
Subject types that have sync attributes that do not match the way it is setup
Duplicate form mappings
Users who do not have the right configuration to allow for correct sync
Identifier settings wrongly setup, or not enough identifiers allotted
Features such as Glific integration turned on, but not set up correctly

The Organisation health verification will identify these problems and report them so that an administrator can take corrective actions. This feature will also include instant verifications that prevent the user from making incorrect changes to configuration.

Organisation metadata migration

When developing an app on Avni, there are usually two organisations - test/UAT and production. This is essential to be able to test changes on one and apply them on another.

The current mechanism of doing this is using a metada download and upload. The download creates a zip file of all changes, and can be used to upload to another organisation.

Some of the issues with this mechanism is that

There is no protection against uploading to the wrong organisation
There is no way to know what changes are really going to be applied
There is no way to upload partial changes. This is really important when there are multiple changes going in parallel and only part of the changes are required to be applied
It is hard to migrate to organisation groups, where multiple organisations need the same metadata

The purpose of this feature is to mitigate the above issues and provide an error-free and easy migration of metadata on Avni.

Improve usability of the csv upload feature on Avni and Miscellanous

These changes are small pieces of work that can be worked on as a warmup to work on Avni. These changes help immensely in maintaining organisations.

Goals & Mid-Point Milestone

Goals

[ ] Set up of project complete
[ ] S feature 1 completed
[ ] M feature completed
[ ] [Goals Achieved By Mid-point Milestone]
[ ] M feature completed
[ ] L feature completed

Setup/Installation

Setup documentation here
Ensure you set up avni-server and avni-webapp for this project. Others are not necessary.

Expected Outcome

Each item, once implemented, will do one or more of the following

Improve the implementer experience
Reduce mistakes and rework

Acceptance Criteria

Detailed acceptance criteria will be created on individual stories before the start of the project.

Implementation Details

avni-server is Java/Spring Boot while avni-webapp is a static react based app

Mockups/Wireframes

No response

Product Name

Avni

Organisation Name

Samanvay Foundation

Domain

Other

Tech Skills Needed

HTML, Java, JavaScript, React, Spring Boot

Mentor(s)

@vinayvenu

Category

Backend, Database, Documentation, Frontend, Refactoring

ombhardwajj commented 3 months ago

Hi @vinayvenu , The link to setup Avni with docker given on this https://avni.readme.io/docs/developer-environment-setup-ubuntu leads to 404 not found. Do you have some other link for it?

nitian-hritik commented 3 months ago

Sir, I want to contribute in this project ... Please, provide more ideas .. My Tech Stack: MERN stack,Javascript

vinayvenu commented 3 months ago

@ombhardwajj thanks for pointing it out. Docker-based setup does not exist natively in Avni, although we publish containers on docker-hub. I have removed that part of the documentation.

There is some work done by other projects to set up Avni on Docker. Look up this link.

Btw, you won't be able to develop on Avni if you use their setup as it is not meant to be a developer machine setup. It is best to follow the "regular" procedure.

ombhardwajj commented 3 months ago

Hey @vinayvenu , I've installed JDK 8 and set Set JAVA_HOME ,also cloned avni-server from Github and also created the database by using _make builddb in terminal. I already had postgresql-server and configured the system user to have all privileges on postgres DB. But _make startserver gives an error probably because I have not installed postgresql-contrib packages.. I tried looking for them on the internet but could not find a good resource. Could you please assist me. Thank you

vinayvenu commented 3 months ago

@ombhardwajj can't figure out without the error message. Also, best to ask this question on the developer channel for debugging support - https://join.skype.com/xiTU162DSJTd

shashank007s commented 3 months ago

i want this project because i have much idea about this lang.

Kartik2057 commented 3 months ago

Hi @vinayvenu , I would like to work on this project. My tech stack includes core Java, spring boot, JPA. Is there any smaller issue to work on this first?

vinayvenu commented 3 months ago

@Kartik2057 try these - https://github.com/avniproject/avni-server/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22

AbhimanyuSamagra commented 3 months ago

Do not ask process related questions about how to apply and who to contact in the above ticket. The only questions allowed are about technical aspects of the project itself. If you want help with the process, you can refer instructions listed on Unstop and any further queries can be taken up on our Discord channel titled DMP queries. Here's a Video Tutorial on how to submit a proposal for a project.

chetanpawar29 commented 3 months ago

Hi @vinayvenu , I would like to work on this project. My tech stack includes HTML, core Java, JavaScript, spring boot.Please, provide more ideas ..

Riyasharma28 commented 3 months ago

Respected Mentor @vinayvenu I'm a Full Stack Developer proficient in HTML, CSS, JavaScript, MongoDB, React.js, Node.js, Bootstrap, Database Management, UI/UX Design, Test-driven Development, and frameworks like Laravel and Material-UI. With over 10 projects completed in similar domains, I'm eager to contribute my expertise to your project. I'm excited about the opportunity to collaborate and drive its success. Looking forward to discussing this further.

gauravghuge7 commented 2 months ago

Respected sir@vinayvenu I'm a Full Stack Developer good foundation in Html Css, Java, JavaScript, MongoDb Nodejs and frameworks like react Express With 6 to 7 projects and i want to contribute in this project can please provide a opportunity for the contribute in this project

Rahulkumar2488 commented 2 months ago

My name is Rahul Kumar. Web developer fluent in HTML, CSS, JavaScript, and various frameworks. Skilled in creating responsive, user-friendly websites. Proficient in troubleshooting and optimizing site performance. Committed to staying updated on emerging technologies. Passionate about crafting engaging digital experiences. Available for exciting web development opportunities.

vinayvenu commented 2 months ago

@Rahulkumar2488 @gauravghuge7 @Riyasharma28 @Chetan-Vilas-Pawar please see https://github.com/avniproject/avni-product/issues/1536#issuecomment-2071996489 for more details on how to apply for the project. If you have project-specific questions, you can ask them here. If you have trouble setting up, Avni developers will be available on the Skype channel at https://join.skype.com/xiTU162DSJTd .

You can find me as well on the Skype channel for quick questions. If you have questions regarding the DMP programme, please use the Discord channel linked by @AbhimanyuSamagra .

muskansingh17 commented 2 months ago

@Rahulkumar2488 @gauravghuge7 I want to do contribute to this project I have also made a certain project using the same application in Intellij using Spring Boot kindly review the same (the project link-https://github.com/muskansingh17/Hotel_Management_System) kindly provide your reference sir.

avniproject / avni-product