Nextralume

Map any workflow, flag bottlenecks, and generate fixes you can share in minutes.

Nextralume is a workflow-analysis web app that turns messy operational knowledge into a clear, risk-ranked process map with actionable recommendations and exportable reports.

What it does

• Template-driven analysis: start from a known workflow pattern (e.g. shift handover) to get consistent results.
• Workflow map (timeline): steps are visualized as a sequence with risk indicators.
• Bottlenecks and risks: clear "what" and "why" explanations in plain language.
• Recommendations: concrete next steps tied to specific workflow steps.
• Export: share results as HTML/Markdown and optionally send a webhook payload.
• Session history: save analyses as sessions and revisit them later (browser-isolated via an anonymous client key).

Demo

1. Start the app and open the demo page: http://localhost:3000/clinic/demo
2. Select a template (example: Shift Handover).
3. Use Sample Mode to generate a deterministic result quickly (no upload required).

Tech stack

• Next.js (App Router) + React + TypeScript
• Tailwind CSS + shadcn/ui
• Prisma + PostgreSQL
• Zod (schema validation for structured AI outputs)
• Vitest + React Testing Library
• i18n: en, zh-TW, zh-CN

Repository map

• app/ - Next.js routes (pages + API routes)
  • app/clinic/demo - main demo page
  • app/clinic/sessions - session history and detail pages
  • app/api/clinic/analyze - analysis API (supports sample mode)
  • app/api/clinic/sessions - list/read/delete sessions
  • app/api/clinic/webhook/send - send a test webhook payload
• components/ - UI components (workflow timeline, issue list, coach panel, etc.)
• lib/ - core logic (templates, i18n, LLM/OCR clients, helpers)
• prisma/ - schema and migrations
• docs/ - deployment and connector docs
  • docs/db-deploy.md
  • docs/connectors/google-sheets-appsscript.md
  • docs/connectors/webhook-receiver-test.md
  • docs/smoke-tests.md (manual integration checks)
  • docs/product/ - product documentation (e.g., local-assistant-data-spec.md)

Repository layout and archives

This repository is now focused on the 2026 product direction: operations workflow insight + local data assistant for Excel-heavy SMEs.

Historical materials from the 2025 hackathon/contest period (SUMW 2025 AIGC Developer Competition) have been archived and are no longer required for current product development:

• docs/archive/hackathon-2025/ - Archived hackathon materials
  • Competition requirements and review pack
  • Implementation summaries and plans
  • Presentation generation scripts and artifacts
  • Submission packages

These archived documents are preserved for reference but are not required to run, develop, or deploy the current product.

API endpoints (selected)

• POST /api/clinic/analyze
  • Optional sample mode for deterministic demos
• GET /api/clinic/sessions
• GET /api/clinic/sessions/[id]
• DELETE /api/clinic/sessions/[id]
• POST /api/clinic/webhook/send

Local development

Prerequisites

• Node.js 20+
• pnpm
• PostgreSQL

Setup

pnpm install
cp .env.example .env

Update DATABASE_URL in .env, then run migrations:

pnpm db:migrate:dev

Start the dev server:

pnpm dev

Open:

• http://localhost:3000/clinic/demo

Environment variables

See .env.example for the full list. Common variables:

• DATABASE_URL - PostgreSQL connection string
• ERNIE_API_BASE, ERNIE_API_KEY, ERNIE_MODEL - ERNIE LLM configuration
• PADDLE_OCR_API_BASE, PADDLE_OCR_API_KEY, PADDLE_OCR_MODEL - OCR configuration

Quality gates

Run all checks locally:

pnpm lint
pnpm typecheck
pnpm test
pnpm build

Manual smoke tests (real integration checks)

If your branch includes the ERNIE smoke test script, run:

pnpm smoke:ernie

Notes:

• Requires real ERNIE_API_BASE, ERNIE_API_KEY, and ERNIE_MODEL
• Intended for local or staging verification (not run in CI by default)

See:

• docs/smoke-tests.md

Connectors

• Google Sheets Apps Script template:
  • docs/connectors/google-sheets-appsscript.md
• Webhook receiver testing guide:
  • docs/connectors/webhook-receiver-test.md

Data handling

Nextralume persists structured analysis JSON (sessions). Raw uploads are processed transiently for extraction and are not stored in the database by default.

Deployment

This repo is designed to run CI checks (lint/typecheck/test/build) and deploy on pushes to main (workflow files may vary by branch).

License

Private repository. No license is granted unless explicitly added.