Project Description
# Freelancer Brief — Field Payments App (Finish & Deploy)
## Project in one line
Finish, deploy, and ship a working Android cash-payments app for my field staff. The codebase already exists; I need it polished, hosted, and installed on staff phones.
## What the app does
Field employees record cash they receive from admin (inward), pay to vendors/labourers (outward), transfer to each other (transfer), and return unspent cash (return). Every transaction is confirmed by the receiver via an OTP SMS. Each employee has a live cashbook that auto-syncs to a Dropbox folder as an Excel file.
## Tech stack (already chosen — please use it)
- **Backend**: Node.js + Express + SQLite (better-sqlite3), JWT auth, ExcelJS, Dropbox SDK, MSG91 SMS API.
- **Mobile**: React Native (Expo, SDK 51), TypeScript optional.
- **Admin dashboard**: Vanilla JS + Tailwind-style CSS (served by the backend), already partially built.
## What's done
- Backend with full data model: users, recipients (with Aadhar/PAN/GST/address fields, phone unique), payments ledger with 4 directions (inward/outward/transfer/return), overdraft flow with admin OTP, balance computation, Excel cashbook generator, Dropbox sync, pincode lookup via India Post API.
- Admin web dashboard skeleton with login, staff CRUD, bulk recipient import from Excel, live balances, payments view.
- Mobile app skeleton with login, home, outward payment flow, OTP verify, history.
## What I need you to do (deliverables)
1. **Finish the mobile app screens**
- Transfer screen (employee → employee), with overdraft confirmation flow.
- Return-cash screen.
- Add-recipient form covering all new fields: phone, name, Aadhar (+ photo), PAN (+ photo), address with **pincode lookup auto-fill state/district/area**, company name, GST.
- Receipt/document photo capture using device camera.
- Pull live balance and show it on home screen.
2. **DLT-compliant SMS setup (India)**
- Sign up MSG91 with my company details (I'll provide).
- Get DLT-approved OTP template + sender ID.
- Wire credentials into backend `.env`.
3. **Dropbox app setup**
- Create Dropbox app, configure scoped access with `files.content.write`.
- Generate long-lived OAuth refresh token (not the deprecated short-lived token).
- Plug into backend.
4. **Backend deployment**
- Deploy to a small VPS or PaaS (DigitalOcean / Railway / Render — your call, justify it).
- HTTPS via Let's Encrypt or platform-provided cert.
- Set up daily SQLite backup to S3 or Dropbox.
- Give me admin credentials + a runbook.
5. **Android APK build**
- Configure EAS Build, ship a signed APK.
- Walk me through installing on 3–5 test phones.
6. **Acceptance testing**
- Demo every flow end-to-end with real SMS on real phones.
- Fix bugs found during this round.
## Out of scope (for now)
iOS build, payment-gateway/UPI integration, biometric login, offline mode. Quote separately if interested.
## Budget & timeline
Fixed-price quote preferred. Looking to ship in **2–3 weeks**.
## What to send me
1. Your quote (lump sum, or split per deliverable).
2. Timeline with milestones.
3. Links to 2 similar React Native or Node.js projects you've shipped.
4. One question you have about this brief (helps me see how you think).
## Repository access
I'll share the existing codebase (Node.js backend + Expo mobile app) once we agree to work together.