From 785c8c9ab6261d76c9c070337f1162cf2de5de6f Mon Sep 17 00:00:00 2001 From: Shihaam Abdul Rahman Date: Sat, 9 Nov 2024 01:12:22 +0500 Subject: [PATCH] update document --- README.md | 35 ++++++++++++++++++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 5286392..1547174 100644 --- a/README.md +++ b/README.md @@ -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`