Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/JaiderT/CoffeePrice/llms.txt

Use this file to discover all available pages before exploring further.

The productor role is designed for Colombian coffee farmers (caficultores) who need a single place to track the daily FNC reference price, see AI-generated next-day predictions, discover what local buyers are paying, and receive email notifications when prices cross their target threshold. After completing email verification, a producer’s account is immediately active — no admin approval required.

​
Registration

1

Create an account

Navigate to /register and fill in your name, surname, email, and password. Select Productor / Caficultor as your role, or leave the default (the model defaults rol to "productor").
2

Verify your email

A 6-digit verification code is sent to your email address. Enter it on the /verify-email screen. The code expires after a set period; use Resend if needed.
3

Access your dashboard

Once verified your account estado is set to activo and you are redirected to /dashboard. No further action is required.
Producers can also register or log in via Google OAuth. When using Google, email verification is skipped because the identity is already confirmed by Google.

​
Dashboard Features

Your producer dashboard at /dashboard brings together everything you need to make informed selling decisions:
FeatureDescription
Live FNC price tableCurrent official FNC purchase price per carga and per kg
Next-day prediction widgetAI forecast for tomorrow’s FNC price with confidence indicator
Buyer map accessInteractive map of approved local compradores and their offered prices
Price history chartsHistorical FNC price trend charts filterable by date range
Active alert managementSummary of your configured price alerts and their current status

​
Price Alerts

Price alerts let you define a minimum price threshold. When the FNC price meets or exceeds your target, CoffePrice sends you an email notification so you never miss a selling opportunity.

​
Creating an Alert

Send a POST request to /api/alertas with your target price: 
{
  "precioMinimo": 1050000,
  "activa": true
}

​
Managing Existing Alerts

GET    /api/alertas/usuario/:usuarioId   — list your alerts
PUT    /api/alertas/:id                  — update threshold or toggle active
DELETE /api/alertas/:id                  — remove an alert
Set your alert the evening before the trading day starts. The FNC publishes the new reference price early in the morning; having your threshold already configured means you will receive the notification the moment the price is refreshed — before most buyers have updated their own offers.

​
Account Management

All profile operations are available from the /perfil screen.
PUT /api/usuario/perfil — update your nombre, apellido, and celular.
{
  "nombre": "Carlos",
  "apellido": "Muñoz",
  "celular": "3101234567"
}
Names must contain letters only (including accented Spanish characters and spaces). Numbers and special characters are rejected.

​
Frontend Routes

The following application routes are accessible to authenticated producers:
RouteComponentDescription
/dashboardDashboardCaficultorMain producer dashboard
/perfilPerfilProductorProfile and account settings
/alertasAlertasCreate and manage price alerts
/historialHistorialHistorical FNC price charts
/preciosPreciosLive FNC and buyer price table
/prediccionesPrediccionesNext-day price predictions
/mapaMapaCompradoresRegional buyer map

​
API Endpoints

EndpointMethodAuth requiredDescription
/api/preciosGETPublicLive FNC and buyer prices
/api/prediccionesGETPublicNext-day FNC price prediction
/api/alertas/usuario/:usuarioIdGET✅ Owner onlyList your own alerts
/api/alertasPOST✅ productor or adminCreate a new price alert
/api/alertas/:idPUT✅ productor or adminUpdate alert threshold
/api/alertas/:idDELETE✅ productor or adminDelete an alert
/api/historial-preciosGET✅ AuthenticatedHistorical price records
/api/noticiasGETPublicCoffee news articles
/api/comprador/mapaGETPublicApproved buyer locations

Build docs developers (and LLMs) love

Get started for freeTalk to us