Mentorship-android
Product Information
Use Cases
Public chat
Support Plans
There are currently no OSS plans available
If you are a provider or contributor to the repository, you can start adding your OSS plan.
Add an OSS planContact us if you are looking for a plan for this open source.
We will help you get in touch with professional providers.
Product Details
Mentorship System (Android)
Mentorship System is an application that allows women in tech to mentor each other, on career development topics, through 1:1 relations for a certain period.
This is the Android client for the Mentorship System.
Features
- Once the App is installed, the user can view an onboarding screen that introduces the app and gives the user an idea of how it works.
- A member gets an option to be a Mentor, a Mentee, or Both.
- A member can build/customize the app profile with their username, bio, skills, interests, location, occupation, etc. anytime.
- A member can read and know more about the Mentorship System including the terms and conditions, privacy and policy, and code of conduct.
- A member can directly access the AnitaB-org Github repo, Zulip chat, and website from this App.
- A member can refresh every page.
- A member can view a list of other members and search for a member on the Members Page.
- A member can search for particular members there in the Mentorship System.
- A member can sort other members based on their name either (A-Z) OR (Z-A), registration date, and age.
- A member can filter other members by the label need mentoring or available to mentor, interest, location, and skills that are given while creating a profile.
- A member can either send mentorship requests to other members as a Mentor or Mentee according to their interests or reject mentorship requests from other members.
- A member can track the number of Pending Requests, Accepted Requests, Rejected Requests, and Completed Requests and view Recent Achievements on the Home Page.
- A member can view the details of pending, past, and all mentorship requests on the Requests Page.
- A member can create, update, or delete tasks in their current mentorship relationship.
- A member can send feedback about the Mentorship System such as reporting a bug, giving suggestions, or other comments.
- A member can delete their account.
- A member can change their account password anytime.
Setting up the project
To setup the project locally read these wiki pages and follow the instructions:
Contributing
Please read our Contributing guidelines, Code of Conduct and Reporting Guidelines
Please follow our Commit Message Style Guide while sending PRs.
Please follow Kotlin official docs for Coding Conventions to maintain a consistent code style in the repository.
Contributors
Thanks goes to these people (emoji key):
Isabel Costa 💻 🚧 ⚠️ 📖 🎨 |
Vaishnavi Joshi 🚧 🎨 👀 📓 |
Kapil Bansal 🚧 ⚠️ 👀 📓 |
Aditya Kurkure 💻 ⚠️ 👀 📓 |
Gauri V. Nair 🚧 👀 |
This project follows the all-contributors specification. Contributions of any kind welcome!
Running the UI tests
To run the existing UI tests follow the steps given below:
- Connect your Android device or open the emulator.
- On the terminal type:
./gradlew clean build connectedAndroidTest --stacktrace
- If the above command is not working try using the command:
gradlew clean build connectedAndroidTest --stacktrace
- Wait until all the tests are completed.
- You will get a report generated with a test summary.
- See the complete report
./mentorship-android/app/build/reports/androidTests/connected/index.html
- The report
./mentorship-android/app/build/reports/androidTests/connected/index.html
will show all the testsuites that have passed as well as failed. - To get a more detailed explanation about the tests of a particular testsuite visit respective html file of the testsuite.
For e.g.:
org.anitab.mentorship.LoginActivityTest.html
will contain the results of all the tests run under that particular testsuite. - You can find the respective html files of the different testsuites under the heading classes in
index.html
report.
Documentation
To learn more about the project's goals and progress, check out Mentorship Roadmap.
To learn more about this app you can look at this project's wiki.
Check out the design history at User Interface Design.
Our tech stack includes:
- Language: Kotlin
- Architecture: Model View ViewModel (MVVM)
- Libraries: Retrofit, RxJava, ViewModel, LiveData, DataBinding
Branches
The repository has the following permanent branches:
-
master This contains the code which has been released.
-
develop This contains the latest code. All the contributing PRs must be sent to this branch. When we want to release the next version of the app, this branch is merged into the
master
branch. -
apk This branch contains the apks for the code in the develop branch. The apks are automatically updated when a commit is pushed to
develop
branch.
Screenshots
Contact
You can reach our community at AnitaB.org Open Source Zulip.
We use #mentorship-system stream on Zulip to discuss this project and interact with the community. If you're interested in contributing to this project, join us there!
License
Mentorship System is licensed under the GNU General Public License v3.0. Learn more about it in the LICENSE file.