update document

This commit is contained in:
Shihaam Abdul Rahman 2024-11-09 01:12:22 +05:00
parent 9b97c029b5
commit 785c8c9ab6
Signed by: shihaam
GPG Key ID: 6DA2E87EBC227636

View File

@ -3,7 +3,40 @@
Find tracking number and # from Maldives Post Domestic Letter Bill.
![demo_ss.png](demo_ss.png)
### The Problem
Maldives Post delivery process currently faces an efficiency bottleneck:
1. Each mail bag comes with a printed delivery sheet containing multiple tracking numbers
2. Recipients need to locate their tracking number on this sheet to sign for their package
3. This is time-consuming because:
- Tracking numbers are long (e.g., UV743594518UZ)
- Multiple tracking numbers look very similar
- The format mixes letters and numbers
- The search process is prone to errors
### The Solution
This tool simplifies the delivery process by:
1. Converting the printed sheet lookup into a digital search
2. Allowing barcode scanning of tracking numbers
3. Instantly showing the corresponding sequence number (#)
4. Making it easy to find the right row on the printed sheet since sequence numbers are:
- Short (1, 2, 3, etc.)
- In numerical order
- Easy for human eyes to scan quickly
## How to use
1. Upload spreadsheet provided by Maldives Post
1. Upload spreadsheet provided by Maldives Post (contact Maldives Post for it)
2. Scan item bar code or manually enter tracking number
3. Find the Mail bag and # from printed sheet to sign
Requirements
- python 3.12+
Usage
`pip install -r requirements.txt`
`streamlit run app.py`
OR with docker
`docker compose up --build`