Supply Pulse
Weekly, cited AI risk reports for the suppliers a business actually depends on — plus interim disruption alerts when public news looks severe.
Supply Pulse is a multi-tenant SaaS for importers, manufacturers, and distributors. A buyer adds supplier profiles. A background worker researches each one on a chosen weekday, emails a PDF, and shows P1 / P2 / P3 priorities on the dashboard.
The problem
A late shipment is usually old news by the time it shows up in a spreadsheet. Port congestion, strikes, plant shutdowns, sanctions, and export-control changes are published in public sources days earlier, but a small procurement team cannot read all of them for every supplier and lane.
Generic news alerts are noisy. What matters is whether an item can affect this supplier’s ability to deliver on time, at the agreed quality and price, given that supplier’s country, category, lead time, and share of cost of goods sold.
The solution
Supply Pulse keeps a profile for each monitored supplier and turns public information into a structured weekly report:
- The buyer records the supplier name, country, category, lead time, COGS share, and optional shipping route and dependencies.
- On the weekday and UTC hour chosen at signup, a worker generates one report per supplier.
- The report separates confirmed events, watch signals, and hypothetical scenarios, and it cites sources.
- The buyer gets an email with a PDF. The dashboard ranks suppliers by the top priority in that report.
- Between weekly reports, a daily news job can email a short alert when a headline scores as a likely disruption.
Plans are Free (1 supplier), Standard ($29.99, 5 suppliers), Plus ($79.99, 5 suppliers, deeper reports and a mid-week alert), Premium ($199.99, 15 suppliers, daily alerts), and Enterprise (custom supplier count, daily alerts). Billing runs through Polar.
Key features
- Supplier profiles with search, edit, and delete. Creating or updating a profile checks that the fields are internally consistent before they are saved.
- Weekly report runs on a per-user schedule. A scheduler checks every 15 minutes for users whose
nextReportAt is due.
- Consolidated PDF for the latest run, localized to the user’s language (English, Spanish, Portuguese, French, or German).
- Dashboard risk view that reads P1, P2, and P3 rows out of the generated report and labels them high, medium, or low.
- Daily supplier news from Google News RSS and GDELT, shared across customers who monitor the same supplier name and country.
- Interim email alerts for Plus (once mid-week) and Premium / Enterprise (each day a new severe item is waiting). Free and Standard keep those signals for the weekly report only.
- Admin news audit of each daily run: inserted items, skipped headlines, classifier scores, and whether the alert email was sent.
- Account controls: credentials login, password reset, terms consent, cookie consent, and an admin audit log of security-relevant actions.
- Registration CAPTCHA via Cloudflare Turnstile.
AI architecture
Three model calls are in the product. None of them run in the browser. API keys stay on the server and on the worker.
| Step | Model | When |
|---|
| Supplier profile check | Perplexity sonar | On create or update, unless SUPPLIER_VALIDATION_SKIP=true |
| Weekly report | Perplexity sonar-pro (Free, Standard) or sonar-deep-research (Plus, Premium, Enterprise) | Scheduled weekly run, and manual runs |
| Disruption score | TypeSafe JEV jev-latest at https://api.typesafe.ai/v1/systemone | Daily news job, after a keyword filter |
| Alert blurb | Perplexity sonar-deep-research | Only when a JEV score is high enough to escalate |
Profile check. validateSupplierProfile asks sonar whether the name, country, category, route, and dependencies are logically consistent (for example, a country that does not match the shipping lane). The prompt tells the model not to reject a supplier merely because it cannot find the company online. The response must be JSON (valid, summary, issues). A service failure returns an error; it does not silently save a bad profile.
Weekly report. generateSupplierReport posts to https://api.perplexity.ai/chat/completions with search_recency_filter: "week" and citations enabled. The prompt requires seven markdown sections: executive summary with a P1/P2/P3 table, confirmed risks from the past 7 days, watch signals, 30-day scenarios, supply alternatives, recommendations, and optional supporting detail. Collected news signals at or above a JEV score of 0.20 are appended. The user’s locale is the report language. The worker renders the markdown to PDF with PDFKit and sends it through Resend.
JEV news classifier. The daily job (06:00 UTC) fetches Google News RSS and GDELT for the last two days. No model is used for collection. Headlines that miss the disruption keyword list are stored as skipped candidates. The rest are scored with a fixed yes/no question: could this item materially disrupt delivery, quality, or price within 30 days? Routine corporate or marketing news counts as no. The probability is answers.p.noul.
Bands are fixed in code:
- below 0.20 — ignored
- 0.20 up to 0.60 — watch, folded into the next weekly report
- 0.60 and above — escalate: included in the weekly report, and eligible for an interim email
This is the beginning of the README. Read the rest at the original. Read the full README ↗
