# Bunker Enquiry Desk — portal

The Ops and Trader portal for the **Bunker Enquiry Desk** demo (dev: org 900000130 /
app 900000230), standing in for Adani's Adobe enquiry portal. Spectrum-style layout
with Source Sans 3 (Adobe's open-source family; Adobe Clean is proprietary).

- **Enquiries**: every enquiry with state tabs and "Needs my action" per role, refreshed every 5 s.
- **Enquiry**: the eight touch points as read by the AI, the WhatsApp conversation,
  Ops input, the offer as sent, and the action for this user and state:
  Ops input / Regret, Send offer, Revise / Mark lost, Mark delivered.

Platform config: `sm2/custom-apps/adani-bunker-enquiry/`.

## Runtime contract

- `VITE_ZINO_API_URL` is read at runtime from `config.js` (frontgen writes it); `.env` for `npm run dev`.
- Router basename from the `<base href>` frontgen writes; `vite.config.ts` keeps `base: './'`.
- Every colour is a token in `src/styles.css`; dark mode redefines them.

## Data

| Need | Call |
|---|---|
| Sign in | `POST /usr/login` (org_id string), `GET /usr/me` for roles |
| Lists and detail | `POST /app/900000230/view/recordview` `abk-rv-enquiries` (detail filters `instance_id`) |
| Act | `POST /app/900000230/activity` with the activity's suffixed keys (`price_usd_mt__offer` …) |

## Run

```bash
npm install
cp .env.example .env     # VITE_ZINO_API_URL=https://dev.getzino.in
npm run dev              # http://localhost:5176
npm run build
```