# Rawxel

Rawxel is a buyer-led raw-materials sourcing platform. The dependable workflow is still human-in-the-loop sourcing execution: agents may prepare work, but humans approve launch, supplier invites, live bidding, awards, and post-award commitments.

## Current Product Capability

- Create structured raw-material sourcing auctions.
- Run reverse buyer auctions and forward seller auctions.
- Choose bid visibility: rank-only, public, or sealed; extract required documents from abbreviated, certificate-analysis, BOL/bill-lading/BL trade-logistics-doc, or long-form quality specs, with MSDS normalized to SDS.
- Extract inspection, insurance, weight, phytosanitary, and health certificates from auction, material-intake, and document-evidence text.
- Publish auctions, invite suppliers, and manage supplier participation.
- Run Q&A before live bidding.
- Accept live bids from qualified suppliers.
- Extend auctions during anti-sniping windows.
- Close auctions, move them award-pending, and award supplier bids.
- Parse messy buyer/RFQ/source/quote-me/need-a-quote/seeking-offers/supplier-offer requests at `/material-intake` into material, approximate/range quantity including pallets/tonnes, packaging including big bags/IBC totes/drums, destination/location and Incoterms-place, pickup/ex-stock/bonded/free-zone/partial-shipment/freight-responsibility logistics, trial/monthly/annual-contract terms, sealed/public/rank-only bid visibility, ISO/deadline/lead-time delivery dates, budget/target/bare currency price including per-ton/per-tonne/per-kg wording, bounded origin/Made-in/CAS/purity, GMP/FDA/USP/EP, and UN/HS/hazard-class compliance, broad Incoterms/payment terms including COD/CAD/D/P/D/A, supplier status, payment risk, abbreviated, trade/logistics-doc, or long-form document requirements including certificate-analysis phrasing, and recommended workflow.
- Recognize please-quote, can-you-quote, need-pricing, looking-to-buy, requirement, wanted, can-you-source, and spot-buy phrasing in material intake.
- Recognize ICPO/LOI buyer requests and FCO/soft-offer/firm-offer/available-stock supplier offers in material intake.
- Preserve LC, escrow, prepayment, advance payment, upfront, and cash-in-advance wording as material-intake payment terms.
- Normalize CNF and C&F Incoterm aliases to CFR in material intake.
- Parse ETA, ETD, ASAP, and urgent delivery shorthand in material intake.
- Parse bare trade-hub destinations such as Rotterdam, Hamburg, and Jebel Ali when buyers or suppliers omit "to" or an Incoterm.
- Parse US$, PMT, per-tonne, and per-metric-ton price wording in material intake.
- Parse amount-first prices such as 400 USD/MT, 2.5 EUR/kg, and 400 dollars per metric ton in material intake.
- Parse FCL, LCL, 20ft/40ft containers, ISO tanks, isotanks, and truckload quantities as quantity and packaging in material intake.
- Parse COA/SDS/TDS/spec text, including long-form document names, certificate-analysis phrasing, optional trade/logistics-doc evidence, issue/date-of-issue/MFD/DOM labels, expiry/expiration/retest-date/best-before/use-before/use-by labels, pH/density/viscosity/specific-gravity/color/ash/chloride/iron quantitative specs, UN/HS/hazard identifiers, storage conditions, shelf-life, non-GMO, allergen statements, and pending/missing markers that stay out of present-doc evidence, at `/document-evidence` into structured evidence, supplier/manufacturer, ops risk flags, and next-action CSV exports with review rank.
- Extract active-content, concentration, and water-content percentage specs from document evidence.
- Extract volatile matter, non-volatile matter, residue on ignition, insoluble matter, and sulphated/sulfated ash percentage specs from document evidence.
- Extract microbiology specs including total plate count, yeast/mold, coliforms, E. coli, and salmonella from document evidence.
- Keep certificate terms like REACH, ISO, Halal, Kosher, GMP, FDA, USP, and EP out of supplier/manufacturer names in document evidence.
- Capture supplier verification identifiers from trade license, VAT, TRN, company registration, registration number, and DUNS labels in document evidence.
- Review supplier verification, missing-doc, parsed present/missing-doc and supplier/manufacturer evidence, approval, and auction-risk queues at `/admin/ops`, with filtered next-action CSV exports and numeric review rank from ops and supplier views; supplier exports include verification review rank.
- Inspect awarded orders at `/deal-room` with terms, documents, payment, dispatch-gated delivery, messages, evidence timeline, and next-action CSV exports with blocker count and ops escalation.
- Carry supplier/payment/docs/compliance/terms/bid-visibility material-intake handoffs into `/messages`.
- Populate `/admin/simulation` with tagged tester companies that also appear in normal marketplace, auctions, and dashboard surfaces: 200/300/500-agent presets, 80-company normal-surface fixture data, one-minute high-stakes seeded auctions, bids, awards, messages, actions, severity/role/behavior-filtered event logs, event IDs, raw-minute timestamps, and sortable CSVs.

## Company-Agent Authority Levels

- `watch`: monitor markets and raise alerts only.
- `chat`: monitor and draft counterparty messages, but do not draft or place bids.
- `draft_bid`: draft bids inside policy limits; human approval still required.
- `auto_bid`: place bids inside delegated limits; award or contract acceptance still requires human approval.

## Smoke Checks

From `rawxel-core`:

```sh
uv run python -m app.auction_smoke
```

Expected result:

```text
state=awarded
winner=demo_supplier_beta
bids=2
```

Frontend useful surfaces:

- `/agents`
- `/material-intake`
- `/document-evidence`
- `/messages`
- `/admin/simulation`
- `/admin/ops`
- `/deal-room`

## Agent Guidance

Agents should act as sourcing copilots, not autonomous counterparties.

Allowed without extra human confirmation:

- Draft auction inputs from messy buyer specs.
- Suggest supplier invite lists.
- Draft Q&A answers.
- Compare bids and supplier verification signals.
- Draft award recommendations.
- Draft supplier follow-up messages.
- Flag missing documents or expired evidence for ops review.

Ask before:

- Publishing an auction.
- Inviting suppliers.
- Starting live bidding.
- Placing or submitting a bid.
- Closing Q&A or closing an auction.
- Awarding suppliers.
- Accepting contract terms.
- Sending PO/payment/dispatch commitments.

Suggested persona: Rawxel Buyer Sourcing Agent. It prepares sourcing work, explains evidence, and routes risky decisions to humans.