1Getting started
- Open desire-collections.pages.dev in Chrome and sign in with your username and password.
- On the phone: Chrome menu → Add to Home screen — the dashboard then opens like a normal app.
- The bottom bar has just three buttons: 🏠 Home (dues to collect, all orders, monthly numbers), the gold ＋ (new entry), and ☰ Menu (batches, customers, expenses, reports, settings).
- Tap your name (top-right) for quick Log out and Settings. Your login stays active for 30 days per device.
| Role | Can do |
|---|
| 👑 System Admin | Everything. Protected — no one else can reset or remove this account. |
| 🛡️ Admin | Everything + add/remove users and reset their passwords. |
| 👤 Staff | All daily work (orders, customers, payments, reports). No user management. |
2The sales flow
① Inquiry → BookCustomer asks from FB · record it with photo · 50% advance = Booked
② PurchaseItem bought in Malaysia (RM price)
③ Batch arrivesGoods reach Dhaka together
④ CollectInside Dhaka: COD · Outside: pay first
⑤ DeliverHand over & close
Every entry moves through these statuses:
Inquiry→Booked→Purchased→Arrived Dhaka→Delivered (or Cancelled — the advance is kept as income, per the non-refundable rule). An Inquiry is not counted in sales or dues until it becomes Booked.
3Home
- Sales booked — value of orders taken this month. Cash collected — money actually received.
- Dues outstanding — everything customers still owe, across all open orders.
- Net margin — real profit on orders delivered this month, after every cost.
- 💰 To collect now — arrived/delivered orders with unpaid balance. Work this list daily.
- ⚠️ No advance — bookings without any advance received. Chase or cancel these.
4Orders
- 📷 Every entry must have at least one photo of the ornament — even a simple inquiry. The app will not save without a picture. Customer FB profile and FB post links are optional.
- Tap the gold ＋ → pick or create the customer → item, weight (grams/ana/bhori auto-convert), selling price. The 50% advance is pre-filled — adjust if needed. No advance yet? Untick the advance box and it saves as an Inquiry.
- Enter cost as RM × exchange rate — the ৳ cost fills in automatically (you can overwrite it).
- Open an order to add photos (camera or gallery — they compress automatically), receive payments, and move it forward with the big status button.
- Every payment records date, type, method (bKash/Nagad/bank/cash/COD) and TrxID.
Delete vs Cancel: Cancel keeps the record and the forfeited advance as income. Delete erases the order, its payments and photos permanently — use only for entry mistakes.
5Batches
- A batch = one Malaysia → Dhaka trip. Assign each order to its batch.
- Put travel, carriage and customs costs on the batch as batch expenses — they are split across its orders automatically in margin.
- When goods land, tap 📦 Mark batch arrived — all its pending orders jump to Arrived Dhaka in one tap, and the collect list fills up.
6Customers
- New customers are created in one place only — inside the gold ＋ entry form (choose "➕ New customer…" there). That way every customer always arrives with the item photo and a status.
- The Customers page (Menu → Customers) is for viewing: zone (Inside / Outside Dhaka — decides COD vs pay-first), full history, total due — and for editing details like phone or address.
- One-tap 📞 Call and 💬 WhatsApp buttons from the customer page.
7Money & margin
Net margin = Selling price − (RM cost × rate) − order expenses − share of batch costs
- Record courier/packaging on the order, travel/duty on the batch, boosts & other costs in More → Expenses.
- More → Reports gives the monthly picture: delivered margins per order, collections by method, expenses by category, net cash flow.
8Backup & safety
- More → Settings → Download full backup (JSON) — do this every week. The CSV export opens in Excel.
- Admins add users in Settings → Users. Give each person their own login — never share passwords.
- Change your password from Settings. Use the Show button to check what you typed.
Forgot a password? Any admin can reset staff passwords from Settings → Users. Only the System Admin can change the System Admin password — keep it written somewhere safe.
