Well Chemical Log

Every well, every gallon, every dollar.

Chemical tracking built for oilfield chemical companies and the operators they serve.

  • Log usage, deliveries, tank gauges and batch treatments from the field, even with no signal
  • See which wells need filling or treating today on one map
  • Spend by operator, office, well and chemical, ready to export

An RR Digital app

Almost ready

This copy of the app isn't connected to its database yet. Follow SETUP.md to add the Supabase address and key to www/cloud-config.js.

Choose a new password

How will you use it?

Company men: ask the chemical company to invite your email address, then sign in again.

Waiting for approval

Well Chemical Log

Connecting…

Owner console

Every company using the app, with counts only. To see a company's app, its admin turns on Allow RR Digital support to view in their Account panel. You can only look, and each look is shown to their admins.

Today

Every well on the map, colored by what needs attention: tanks to fill and batch treatments coming due. The list below is today's stops, most urgent first.

! Fill now or batch overdue • Coming due ✓ OK ? Not enough entries yet

Getting started

    📍 You're sharing your location with your manager while the app is open.

    Crew sharing location

    Requests

    Call-outs from the company man or the office. They show red on the map until someone marks them done.

    Stops

    Log chemical

    Record chemical used, delivered and gauged, batch treatments, and pump changes at each well or pipeline. It saves on your phone first, so you can log with no signal and it sends when you're back in service.

    Amount pumped into the well.

    Recent entries

    Totals

    Chemical used, delivered and billed for each operator and well, by week, month, or year. Pick an operator and export to send their company man a report.

    Month to month

    Selected period

    By yard

    By operator

    By office

    By chemical

    By well / line

    Entries in this period

    Tanks & notes

    What's in each tank on location, how fast it's being used, and when it needs filling. After a few gauges or entries the app averages the daily usage and flags tanks that are running low. Pump settings and comments are kept with each well.

    Needs fill

    Yard inventory

    Chemical on hand at the yard. Log what comes in from the supplier and count the tanks and totes now and then. Deliveries to wells and batch treatments logged in the field come out of the yard automatically, so the app knows when you’re getting low.

    On hand

    The book is what the yard should have: the last count, plus what came in, minus what went to wells and batches. "In totes" is what your totes add up to.

    Totes & containers

    Add a tote or container

    Match-up

    Start + received − to wells − batches − taken out ± count adjustments = end. A count that doesn’t match the book shows up as an adjustment.

    Log yard stock

    Chemical that came in from the supplier.

    Recent yard activity

    Upload a spreadsheet

    Totes, what came in from the supplier, or a yard count: upload your sheet and the app works out which it is from the column names, then shows you what it will save.

    Choose file

    Wells & chemicals

    Set up the wells you treat for each operator, and your chemicals and prices. Treaters pick from these lists when they log.

    Wells

    Chemicals

    Only an admin can add chemicals or change prices.

    Upload a spreadsheet

    Upload any Excel or CSV file, even one with several sheets. The app reads the column names to work out what each sheet is: well pins, tanks and levels, prices, totes, yard stock, or past chemical use at wells. It shows what it will do before saving anything, and uploading the same file twice never counts anything twice.

    Choose file

    Import well pins

    Upload a KMZ from Google Earth or the operator, or an Excel/CSV sheet with a well name, latitude and longitude (operator, lease and company man columns are picked up too). Pins are matched to your wells by name and put on the map; new ones can be added.

    Choose file

    Import tanks & starting levels

    Set up every tank at once from an Excel or CSV sheet: well, chemical, tank size and what’s in it now (plus fill point and daily target if you have them). Each tank gets its size and a starting gauge, and the map shows levels right away. Add your wells and chemicals first.

    Choose file

    Import price list

    Upload your price sheet (.xlsx, .xls or .csv). It needs a column for the chemical name and one for the price. A unit column is optional. Matching chemicals get the new price, and new ones are added.

    Choose file

    Offices

    Group wells and lines into offices (districts or cost centers) to see chemical spend per office on the Totals tab and in exports.

    Which office each well or line belongs to

    Team

    Add your treaters with the company code, and invite each operator's company man by email so they can see their own wells.

    Company code

    Text this to your treaters. They pick Join my company and enter it, then you approve them below.

    ······

    Asking to join

    Invite by email

    They sign up in the app with this email and are let in automatically. The app doesn't send the email: tell them to sign up.

    Yards

    Each yard has its own manager, treaters and wells. Everyone in the company can see every yard; people change only their own yard's things. New people pick their yard when they join.

    People

    Account

    No logo yet

    Any picture: PNG, JPG, SVG, a screenshot or a phone photo. It's shrunk to fit. It shows at the top of the app for your people and the company men you invite. Nobody outside your company sees it.

    Upload logo

    Your treaters and company men see these colors. Text switches between light and dark on its own so it stays readable.

    Lets your yard manager and admins see where you are on the map while the app is open, so they can see the crew. Only the latest spot is kept, your teammates can't see it, and you can turn it off any time.

    When a company man or anyone on the team sends a request on one of your wells, you get an email with the well and details.

    Lets the app's support team see your company's screens, read-only, to help with problems. They can't change anything. Turn it off any time.

    Company men: when another chemical company invites your email, it's added for you the next time you open the app.

    Deleting your account removes your sign-in. Entries you logged stay in the company's records.