ToolNaka — Delivery & Handoff Report

Complete industrial procurement + billing platform · live on https://toolsnaka.store · 05 September 2026

Live ✅ 34 data models ~50 API endpoints All 26-point spec items delivered 6/6 test scenarios passed

1 · Platform status — LIVE

CheckStatusEvidence
Live site200 OKhttps://toolsnaka.store/api/health → {"status":"ok","db":"ok"}
Domain + HTTPStoolsnaka.store + wwwCloudflare named tunnel + watchdog auto-recovery
Data hygieneLegit0 test records · 16 real/demo users · 28 products (Moglix taxonomy)
Currency renderingFixed0 mojibake sequences remaining (60+ repaired)
Auto-recoveryRunningWatchdog restarts server + tunnel on every boot/wake

2 · The full feature set (live)

FeatureWhat it does
OTP registrationPhone verification (10-min codes, cooldown, single-use). Demo mode shows the code on-screen; email fallback active; real SMS activates when a provider key is set (2Factor/Fast2SMS/MSG91/Twilio layer built)
4 automated emailsWelcome (AI-era themed) · Order confirmation · Vendor new-order alert · Invoice ready — via toolsnaka@gmail.com
Procurement workflowRFQ → quotations → vendor selection → approval routing (auto ≤5k / Dept Mgr ≤50k / Plant Head >50k) → order → delivery
Challan systemSupply / service / repair / maintenance / fabrication / machining challans with linked order + quotation refs, receiver + department, remarks; factory receipt confirmation + verification
Billing configurationsPer factory+vendor: per-transaction or monthly, payment terms (immediate → 60 days / custom) — controlled by the factory
Monthly billingAutomatic DRAFT generation on the 1st (scheduled job) → vendor submits → factory reviews statement → disputes per challan → approves → consolidated invoice with terms-based due date
DisputesPer-challan disputes with reason; excluded from payable, visible in history, undo supported; status-based totals recompute
PaymentsFull and partial payments recorded (method + UTR); invoice status: pending → partially_paid → paid; monthly bill stays in sync
Procurement trace/api/trace assembles the complete chain per order: placed → approvals → challans → invoices → payments
Photo RequestsFactory uploads a part photo → sellers quote new items + repair providers quote repairs → factory awards
Emergency broadcastsCategory quick-select → broadcast to all sellers + real vendor list with search + WhatsApp (pre-filled) / Call buttons
PlannerPaper-planner style daily schedule: date header, mini month calendar with entry marks, time slots 8AM-7PM, done/delete — database-backed
Moglix categories18 categories + ~90 subcategories across all pickers; all products remapped
OtherQuick Bills with status actions · vendor product persistence · profile updates · RFQ discovery · customer support email in footer · Pocket App (offline single file)

3 · Test evidence (live API tests)

ScenarioResult
Same-day billing: config → order → delivery → challan → receipt+verify → invoice → immediate payment (PAID)8/8 ✅
Monthly billing: 3 challans received → DRAFT generated → submitted → approved → consolidated invoice with 30-day terms✅
Dispute: challan disputed → payable reduced exactly → history preserved → approved with exclusion → undo restores✅ exact math
Partial payment: 60% → PARTIALLY_PAID → rest → PAID✅
Procurement trace: full chain returned (order → approvals → challans → invoices → payments)✅
Photo Request: photo upload → 2 quotes (new item + repair) → award7/7 ✅
Planner: create → day view → done → month view → delete7/7 ✅

4 · Demo accounts (password: demo123)

EmailPanel
factory@toolnaka.comFactory buyer (Rajesh Industries)
vendor@toolnaka.comSeller (SK Industrial Supplies)
admin@toolnaka.comAdmin console (approves any tier)
deptmanager@toolnaka.comDept Manager (approves ₹5k-50k)
planthead@toolnaka.comPlant Head (approves >₹50k)
sharmakishan01157@gmail.comYour factory account (Demo@12345)

5 · Remaining items (need you)

  • 24/7 uptime — buy a VPS (₹500-1,200/mo), send IP + SSH → migration takes ~15 min with the included kit. Until then the site runs only while the laptop is on
  • Real SMS OTP — complete the 2factor.in signup manually (bot-guard blocked automation), paste the API key here → real SMS activates with zero code changes
  • Payments gateway — UPI/Razorpay so factories pay inside the app
  • Settings UI wiring — profile-update endpoint is live; the Settings form needs to call it (small task)
  • Domain renewal payment method — add one in hosting.com for the 2027 renewal

6 · Key links & files

ItemWhere
Live apphttps://toolsnaka.store
Full package (source + docs + VPS kit)https://toolsnaka.store/ToolNaka-Full-Package.tar.gz
Pocket App (offline)https://toolsnaka.store/ToolNaka-Pocket-App.html
Go-Live Guidehttps://toolsnaka.store/ToolNaka-GoLive-Guide.html
Earning Planshttps://toolsnaka.store/ToolNaka-Earning-Plans.html
Documentationhttps://toolsnaka.store/ToolNaka-Complete-Documentation.html
Auto-bill jobtoolnaka-ai/scripts/auto-generate-bills.cjs (scheduled task ToolNakaMonthlyBills)
DB backup (pre-cleanup)workspace/backups/dev-db-backup-20260901.db