===Profile Information
**Name**: Shashank Kumar
**Email**: shashank.kumar.phe22@itbhu.ac.in
**Education: ** Indian Institute of Technology (BHU) , Varanasi
**Github : **[[ https://github.com/shashankiitbhu | shashankiitbhu ]]
**LinkedIn : **[[ https://www.linkedin.com/in/shashank-k-606/ | Shashank Kumar ]]
**Location**: Varanasi, India
**Other Communication modes:** Discord, Zulip, Telegram
**Typical working hours**: 9 am - 10 pm (IST) UTC+5:30
===Synopsis
- Wikimedia Commons Android App is an App that Enables user to Upload and Review Images (Contributions) through their Android Devices. The goal of this GSOC Project is to Improve the Upload Management Queue and Modernize the app.
- **Mentors** - @Nicolas_Raoul @RitikaPahwa4444
> Have you contacted your mentors already?
Yes
===Deliverables
**There are Main Three Divisions of this Project: **
**1. Improve Upload Queue Management: **
**2. Modernize the App**
**3. Split Nearby into a fast query for coordinates + a details query for each pin**
===Implementation Strategy
====Improve Upload Queue Management
**1. Making Upload Queue Behave as a Real Queue **
- The main objective here is **Only One Upload Proceeds at a time** , What needs to be done here is to make sure that due to No Reason, whether it is //Retry of Failed Uploads// or //Pausing and Resuming Uploads// or //Making Multiple Uploads at the same time one after another//.
- Currently, there is no distinction between **//Queued//** Uploads and //**Not-Started Progress Bar**// but still we see two different visual Indicators Uploads which makes it Confusing for users. Hence It needs to be simplified to one tag - //**Queued**// which should be assigned only after the Upload Worker starts the Job of Uploading them.
- Maintaining a Queue where only one Upload is in progress at a time, making sure all others are with a single label - Queued and possibly maintaining their queue position number to make sure that no two uploads overlap or get "stuck" as mentioned here - [[ https://github.com/commons-app/apps-android-commons/issues/5603 | #5603 ]]
What is required here is to Introduce a mechanism hat dynamically updates the state of the uploads based on their position in the upload queue. This mechanism should ensure that only one upload is marked as **STATE_IN_PROGRESS** at any given time, while the others are either set to **STATE_QUEUED** or a new state indicating they are waiting to start.
Here is how I have planned it for now :
# Initially, Set all all items to STATE_QUEUED and only transition an item to STATE_IN_PROGRESS when it's actually being processed.
# Modify logic in the UploadWorker to manage state transitions between STATE_QUEUED and STATE_IN_PROGRESS more dynamically.
This is the Current UploadWorker Flow (Only Tracking Contribution) :
{F43245555}
This is the Rough flow after the Modification :
{F43248330}
However, I plan to dive deeper into finding better solutions or to Improve current solution in my GSOC Period.
**2. Building New UI for Pending Uploads**
{F43151303}
- Make a Separate **Pending Uploads** Screen which Follows the above principles for a **Real Upload Queue** , In which only //one upload is seen in Progress at a time//
- Making It Easier for users to see their **Queued Uploads** ,**Paused Uploads**, and **Failed Uploads**, this clarifies to the user that Failed Uploads will be added at the last of the Queue if retried and Paused Uploads are different from Queued Uploads
- This provides users a clean way to see the status of their uploads and decide what action they should take.
**3. Prevent Retries For Genuinely Failed Uploads ** [[ https://github.com/commons-app/apps-android-commons/issues/5284 | #5284 ]]:
- As mentioned [[ https://github.com/commons-app/apps-android-commons/pull/5613 | here ]], Identify which reasons qualify as "Genuine"
- Whitelist the "Genuine" reasons and check if Upload is Failed due to any of these reasons.
- Only Retry if the Failed reason is not in the list of whitelisted reasons for failure.
**4. Handling Failed Uploads **
- This Involves Fixing [[ https://github.com/commons-app/apps-android-commons/issues/5280 | #5280 ]] & [[ https://github.com/commons-app/apps-android-commons/issues/5283 | #5283 ]]
- For Issue #5283 , till this point, I have observed and also mentioned [[ https://github.com/commons-app/apps-android-commons/issues/5283 | here ]] that //it only appears// that the failed upload is going on Simultaneously but isn't going on, this seems to be an issue with Incorrectly updating the UI, However, it would require more extensive debugging and find a more reliable way to reproduce this to get to a conclusion.
- For Issue #5280 , Based on the current method of reproduction, the reason for this Issue seems to be that the current logic for determining upload success or failure might be too simplistic, not accounting for partial successes (where the image is uploaded, but subsequent steps fail). To solve this, we have to more accurately track and update the state of uploads, taking into consideration partial successes and providing more accurate error feedback.
**5. Preventing Duplicates ** [[ https://github.com/commons-app/apps-android-commons/issues/5608 | #5608 ]]:
- The task here is to first Investigate the reason for duplicates that arise in case of Multiple Uploads, Finding a reliable way to reproduce it is the first step.
- There could be multiple reasons for this, as far as I have examined Upload Worker and the overall whole Upload Process during my contribution period I think it could related to the retry logic we currently have where the app is Incorrectly mistaking a stuck upload with a failed upload.
- One good way to solve this is to Implement an upload anti-duplication logic in the UploadWorker , so even if we don't know the exact reason why duplicates are found we can be sure that no duplicates will be in the upload queue, I am interested in possibilities of using 'imageSHA' to uniquely Identify Contribution in UploadWorker and avoid duplicates.
====Modernize the app by replacing Kotlin Android Extensions and Butterknife with ViewBinding:
As most of this Migration is already complete, I believe this task is to be replaced with some other task for this GSOC, so I am waiting for the mentor's confirmation on this.
====Split Nearby into a fast query for coordinates + a details query for each pin [[ https://github.com/commons-app/apps-android-commons/issues/4560 | #4560 ]]
The current problem is that when users access the Nearby feature, especially in dense urban areas, the app attempts to load a comprehensive dataset for each POI(Points of Interest), including detailed information like name, description, class, and existence. This process is based on a single SPARQL request that fetches all these details simultaneously. Given the large number of POIs in such areas, this request becomes exceedingly complex and time-consuming, leading to long loading times or even timeouts.
As also suggested in the Issue description itself we have to divide the data retrieval process into two distinct phases - [[ https://github.com/commons-app/apps-android-commons/issues/4560#issuecomment-903519381 | Fast Query ]] for Coordinates and then a [[ https://github.com/commons-app/apps-android-commons/issues/4560#issuecomment-903238022 | second query ]] separate asynchronous requests for each pin to fetch the detailed information.
The following needs to be done to implement this:
- Designing a Simplified SPARQL Query For Initial Coordinates Retrieval and Separate queries for detailed Information. I think we already have a pretty good query for this [[ https://github.com/commons-app/apps-android-commons/issues/4560#issuecomment-903519381 | here ]]
- Asynchronous Loading Strategy for separate queries
- Implement the simplified query to fetch and display basic POI data quickly.
- Develop the logic for asynchronously fetching detailed POI information, including error handling and performance optimization.
- Fine-tune the asynchronous detail retrieval process, possibly by batching requests or prioritizing visible pins. (as suggested [[ https://github.com/commons-app/apps-android-commons/issues/4560#issuecomment-903519381 | here ]] )
- Test the new implementation in various scenarios, especially in densely populated areas, to assess improvements.
===Timeline
| Period | | Task Description |
|------------------------|--------------------------------------------------|------------------------------------------------------------------------------------------|
| May 4 to May 26 | Community bonding period | - Join community and connect with Mentors |
| | | - Introduction and connecting with other contributors |
| | | - Start working on taking feedback for the new UI for the Pending Uploads and Start working on Suggestions |
| | | - Create and Implement the new UI |
| | | - Final Review, Testing, and Feedback for the UI |
| May 27 to May 31 | | - Final Iteration on New UI Based on the Received Feedback |
| May 31 to June 2 | | - Test Issue [[ https://github.com/commons-app/apps-android-commons/issues/5603 | #5603 ]] and Reliably Reproduce, Analyse and Confirm the Underlying reason for this Issue |
| June 2 to June 16 | | - Based on the Results of the above task and current known Issues with Upload Queue Management, Modify and Implement Real Upload Queue Management |
| June 16 to June 18 | | - Test Upload with the newly updated Upload Logic and solve Bugs if found |
| June 18 to June 20 | | - Write tests for the new Implemented Methods and classes and add Java doc |
| June 20 to June 28 | | - Fix Prevent retries for genuinely failed uploads [[ https://github.com/commons-app/apps-android-commons/issues/5284 | #5284 ]] |
| June 28 to July 8 | | - Prevent duplicates [[ https://github.com/commons-app/apps-android-commons/issues/5608 | #5608 ]] |
| July 8 to July 12 | Mid Term Evaluations | - Code Cleanup, Testing and Progress Report/Blog |
| July 13 to July 20 | | - Fix Never show successfully uploaded images as "Failed": [[ https://github.com/commons-app/apps-android-commons/issues/5280 | #5280 ]] |
| July 20 to July 22 | | - Test and Analyse the Behaviour of the App After Fix, Write Tests and Java Doc |
| July 22 to August 1 | | - Fix Enqueue failed uploads, rather than uploading them simultaneously with the ongoing upload: [[ https://github.com/commons-app/apps-android-commons/issues/5283 | #5283 ]] |
| August 1 to August 4 | | - Test and Analyse Behavior of the app after the Changes, Wite Tests and Java Doc|
| August 4 to August 16 | | - Split Nearby into a fast query for coordinates + a details query for each pin: [[ https://github.com/commons-app/apps-android-commons/issues/4560 | #4560 ]]|
| August 16 to September 18| | - Test and Analyse the Behaviour of the App After Fix, Write Tests and Java Doc |
| August 18 to September 22| | - Finalise Changes , Code Quality Review and Improvements |
| August 22 to September 26| | - Update Documentation for changes, Write and Submit Report/Blog for all the Tasks Completed and Accomplishments, Learnings |
| August 26 to September 2| Final Evaluations | - Mentors submit final GSoC contributor evaluations |
===Participation
- I plan to communicate through GitHub, Zulip, and any other suggested mediums
- I plan to report the successful completion of tasks through detailed blogs on either Hashnode or Medium
- I am available online during my working hours and I am always available on my Email.
- I am also available during my working hours for Online meetings through Google Meet or Other Mediums if required.
===Previous Contributions to Commons
I started Contributing to Commons in December 2023 and have made several pull requests since then. You can look at those [[ https://github.com/commons-app/apps-android-commons/pulls?q=is%3Apr+author%3Ashashankiitbhu+is%3Aclosed | here ]]
**Pull Requests Created By Me**
**Total : 29** :: **`BUGs` : 16** **`Enhancements`: 5** **`Migrations`: 8**
**Merged: 24**
**Open: 5**
| S.No. | PR No. | Issue No. | Description | Status |
|-------|--------|------------------------------------------------------|-------------|--------|
| 1 | [PR #5544](https://github.com/commons-app/apps-android-commons/pull/5544) | [#5522](https://github.com/commons-app/apps-android-commons/issues/5522) | **BUG** Precise error message if the password has become invalid after password change | Merged |
| 2 | [PR #5466](https://github.com/commons-app/apps-android-commons/pull/5466) | [#5437](https://github.com/commons-app/apps-android-commons/issues/5437) | **BUG** Crash in Upload Wizard when changing Android font size | Merged |
| 3 | [PR #5618](https://github.com/commons-app/apps-android-commons/pull/5618) | [#5277](https://github.com/commons-app/apps-android-commons/issues/5277) | Custom picker: Show different pictures that are currently being uploaded | Merged |
| 4 | [PR #5468](https://github.com/commons-app/apps-android-commons/pull/5468) | [#5448](https://github.com/commons-app/apps-android-commons/issues/5448) | **BUG** Nearby banner shows Item without image| Merged |
| 5 | [PR #5576](https://github.com/commons-app/apps-android-commons/pull/5576) | [#5558](https://github.com/commons-app/apps-android-commons/issues/5558) | Do not reload everything after marking a picture as not for upload | Merged |
| 6 | [PR #5500](https://github.com/commons-app/apps-android-commons/pull/5500) | [#5474](https://github.com/commons-app/apps-android-commons/issues/5474) | **BUG** App Crashes when Switched Between Dark/Light Mode in Location Picker Activity | Merged |
| 7 | [PR #5510](https://github.com/commons-app/apps-android-commons/pull/5510) | [#5505](https://github.com/commons-app/apps-android-commons/issues/5505) | **BUG** Edit Category Crashes when Previous Button is Clicked | Merged |
| 8 | [PR #5525](https://github.com/commons-app/apps-android-commons/pull/5525) | [#5521](https://github.com/commons-app/apps-android-commons/issues/5521) | **BUG** Methods Usage Incompatible with Android API Level 21 | Merged |
| 9 | [PR #5590](https://github.com/commons-app/apps-android-commons/pull/5590) | [#4664](https://github.com/commons-app/apps-android-commons/issues/4664) | Migrate Upload Package To View Binding from Butterknife | Merged |
| 10 | [PR #5503](https://github.com/commons-app/apps-android-commons/pull/5503) | [#5473](https://github.com/commons-app/apps-android-commons/issues/5473) | **BUG** Changes Lost and App Crashes when Switched between Dark-Light Modes in Edit Description and Captions | Merged |
| 11 | [PR #5636](https://github.com/commons-app/apps-android-commons/pull/5636) | [#5630](https://github.com/commons-app/apps-android-commons/issues/5630) | Option to Remove Specific Images from Upload Wizard | Merged |
| 12 | [PR #5594](https://github.com/commons-app/apps-android-commons/pull/5594) | [#4664](https://github.com/commons-app/apps-android-commons/issues/4664) | Migrated Bookmarks Package From Butterknife to ViewBinding | Merged |
| 13 | [PR #5601](https://github.com/commons-app/apps-android-commons/pull/5601) | [#4664](https://github.com/commons-app/apps-android-commons/issues/4664) | Migrated Media Package to View Binding | Merged |
| 14 | [PR #5595](https://github.com/commons-app/apps-android-commons/pull/5595) | [#4664](https://github.com/commons-app/apps-android-commons/issues/4664) | Migrated CategoryDetailsActivity , MainActivity to View Binding | Merged |
| 15 | [PR #5593](https://github.com/commons-app/apps-android-commons/pull/5593) | [#4664](https://github.com/commons-app/apps-android-commons/issues/4664) | Migrated Contributions Package From Butterknife to ViewBinding | Merged |
| 16 | [PR #5592](https://github.com/commons-app/apps-android-commons/pull/5592) | [#4664](https://github.com/commons-app/apps-android-commons/issues/4664) | Migrated Explore Package From Butterknife to ViewBinding | Merged |
| 17 | [PR #5591](https://github.com/commons-app/apps-android-commons/pull/5591) | [#4664](https://github.com/commons-app/apps-android-commons/issues/4664) | Migrated Profile Package from Butterknife to View Binding | Merged |
| 18 | [PR #5478](https://github.com/commons-app/apps-android-commons/pull/5478) | [#5477](https://github.com/commons-app/apps-android-commons/issues/5477) | **BUG** Selected 18 pictures for multi-upload, but Upload Wizard only asks metadata for 1 picture| Merged |
| 19 | [PR #5550](https://github.com/commons-app/apps-android-commons/pull/5550) | [#5547](https://github.com/commons-app/apps-android-commons/issues/5547) | **BUG** App Crashes after clicking on Explore in bottom Navigation | Merged |
| 20 | [PR #5543](https://github.com/commons-app/apps-android-commons/pull/5543) | [#5537](https://github.com/commons-app/apps-android-commons/issues/5537) | **BUG** Unable to upload DNG / RAW images | Merged |
| 21 | [PR #5492](https://github.com/commons-app/apps-android-commons/pull/5492) | [#5470](https://github.com/commons-app/apps-android-commons/issues/5470) |Show Details About Icon Labels when long pressed | Merged |
| 22 | [PR #5493](https://github.com/commons-app/apps-android-commons/pull/5493) | [#5470](https://github.com/commons-app/apps-android-commons/issues/5470) | Show Details About Icon Labels when long pressed | Merged |
| 23 | [PR #5534](https://github.com/commons-app/apps-android-commons/pull/5534) | [#5532](https://github.com/commons-app/apps-android-commons/issues/5532) | **BUG** Can't Open Privacy Policy | Merged |
| 24 | [PR #5604](https://github.com/commons-app/apps-android-commons/pull/5604) | [#4664](https://github.com/commons-app/apps-android-commons/issues/4664) | Migrated Review Package to View Binding | Open |
| 25 | [PR #5519](https://github.com/commons-app/apps-android-commons/pull/5519) | [#5516](https://github.com/commons-app/apps-android-commons/issues/5516) | **BUG** Peer Review Buttons not get disabled after voting an Image for deletion | Open |
| 26 | [PR #5512](https://github.com/commons-app/apps-android-commons/pull/5512) | [#5482](https://github.com/commons-app/apps-android-commons/issues/5482) | **BUG** Fix Some pins disappear after switching apps | Open |
| 27 | [PR #5640](https://github.com/commons-app/apps-android-commons/pull/5640) | [#5627](https://github.com/commons-app/apps-android-commons/issues/5627) | **BUG** Custom picker: thumbnails sometimes blank | Merged |
| 28 | [PR #5643](https://github.com/commons-app/apps-android-commons/pull/5643) | [#5642](https://github.com/commons-app/apps-android-commons/issues/5642) | **BUG** No Precise Error Message After Error Due to Password Change | Open |
| 29 | [PR #5639](https://github.com/commons-app/apps-android-commons/pull/5639) | [#5628](https://github.com/commons-app/apps-android-commons/issues/5628) | **BUG** Custom picker sometimes crashing when marking many pictures as "not for upload" towards the bottom | Merged |
**Issues Created By Me**
| S.No. | Issue No. | Description | Status | Type |
|-------|------------------------------------------------------|-------------|--------|------|
| 1 | [#5547](https://github.com/commons-app/apps-android-commons/issues/5547) | App Crashes after clicking on Explore in bottom Navigation | Closed | BUG |
| 2 | [#5521](https://github.com/commons-app/apps-android-commons/issues/5521) | Methods Usage Incompatible with Android API Level 21 (Target SDK Version) | Closed | BUG |
| 3 | [#5505](https://github.com/commons-app/apps-android-commons/issues/5505) |Edit Category Crashes when Previous Button is Clicked | Closed | BUG |
| 4 | [#5474](https://github.com/commons-app/apps-android-commons/issues/5474) | App Crashes when Switched Between Dark/Light Mode in Location Picker Activity | Closed | BUG |
| 5 | [#5532](https://github.com/commons-app/apps-android-commons/issues/5532) | Can't Open Privacy Policy | Closed | BUG |
| 6 | [#5516](https://github.com/commons-app/apps-android-commons/issues/5516) | Peer Review Buttons are not disabled while the next image is Loading After Nominating it for deletion | Open | BUG |
| 7 | [#5473](https://github.com/commons-app/apps-android-commons/issues/5473) | Changes Lost and App Crashes when Switched between Dark-Light Modes in Edit Description and Captions | Open | BUG |
| 8 | [#5630](https://github.com/commons-app/apps-android-commons/issues/5630) |Option to Remove Specific Images from Upload Wizard | Open | Enhancement |
| 9 | [#5470](https://github.com/commons-app/apps-android-commons/issues/5470) | Show Details About Icon Labels when long pressed| Open | Enhancement |
**PR Reviews By Me: **
1. Reviewed Pull Request [[https://github.com/commons-app/apps-android-commons/pull/5575 | #5575 ]] and made this[[ https://github.com/commons-app/apps-android-commons/pull/5575#pullrequestreview-1911563193 | Comment ]]
2. Review Pull Request [[ https://github.com/commons-app/apps-android-commons/pull/5578 | #5578 ]] and added some suggestions.
===About Me
I am Shashank Kumar, a Sophomore at the Indian Institute of Technology (BHU), Varanasi, pursuing a B.Tech in Pharmaceutical Engineering & Technology. I have been programming since I was 12 and I have an immense love for building products and solving problems through programming.
> How did you hear about this program?
I got to know about this program from a fellow developer at the farewell event of Google's Appscale Academy.
> We advise all candidates eligible for Google Summer of Code and Outreachy to apply for both programs. Are you planning to apply to both programs and, if so, with what organization(s)?
I am only applying to Google Summer of Code.
===Past Experience
I have been coding since I was 12 and I have been working in Java since then and even got certified as [[ https://www.credly.com/badges/1ca32178-8bb9-4837-8632-f65d948b9bbc/linked_in_profile | Oracle Certified Associate, Java SE 8 Programmer ]] at 13. My Journey to Android App development started soon after and even became [[ https://www.credential.net/16d44ba2-72d0-4167-a786-6e16c252b190?key=591e05a203c3a3155dce6e9e54cfa3237c7f1a0c303e021e22ec8de75abd4ca7 | Google Certified Associate Android Developer ]] at 14. I have been developing Android Apps since then and I have worked on a few Android app projects since then, a notable one which I made when I was in High School [[ https://play.google.com/store/apps/details?id=programming.android.tutorial&hl=en_US&gl=US | Android-Java Tutorial App ]] which got more than 35000 Installs on Play Store.
One of the main Android App I built for - **Opined**, which is a Social Media Platform that I founded and where I handled all the tech ( Web and Backend in PHP - Laravel ) and
The Android App - [[ https://play.google.com/store/apps/details?id=com.app.weopined&hl=en_US&gl=US | Opined App ]] :
- Opined is an Anonymous Social Media Platform that eliminates the problem of biases created by personalization algorithms
- The app is Built on **//Java and Kotlin/Jetpack Compose//**
- Uses Sentiment Analysis to Rank User's Opinions
- Fetches Latest News & Headlines and allows users to put their opinions on them
- Got More than //**10000 Installs on the Play Store**//
- Got Selected in the 2022 Batch of [[ https://blog.google/intl/en-in/products/platforms/announcing-100-promising-startups-of-appscale-academys-class-of-2022-with-meity-startup-hub/ | Google Appscale Academy ]]
===Relevant Skills
- Android App Development with Java and Kotlin
- Jetpack Compose
- Git and GitHub
- Retrofit and REST APIs
- Room Database and SQL
- Unit Testing and Understanding of Robolectric
- RxJava and Multi-Threading
- Understanding of Wikimedia's APIs
===Volunteer Experience
- Core Team Member of Club of Programmers (Software Development Group), IIT (BHU) Varanasi
- Backend Lead at Tech Team of Training and Placement Cell, IIT (BHU) Varanasi
===Availability
>Are you eligible for Google Summer of Code?
Yes.
>Do you plan to submit any other proposal apart from this one?
No, I plan to submit only this proposal.
>Do you have any other plans during the period of GSoC?
No, I do not have any other plans during the contribution period.
>How many hours per week can you dedicate to this?
I can devote at least 40 hours per week and can extend it further if needed, I will have no major commitments during this period, and because of my end-of-semester breaks I won't have any academic commitments during this period either.
>Have you been accepted to GSoC before?
No. I am applying to the GSoC program for the first time.
===Post GSOC :
I like this project personally and I love how active and enthusiastic the whole contributors community in Commons Android. This community is something that I want to be part of for a long time and keep contributing to and improving this project even after GSOC and I'll be more than happy to be a part of major changes in this project. For example, transitioning to Kotlin or Migrating from RxJava (maybe), I have tons of ideas for this project and would love to discuss and implement those over a long period.