DeathAudit MVP

DeathAudit is a forensic risk engine that ingests one or multiple business files and returns a 90-day threat assessment.

Quick start

npm install
npm run dev:server
npm run dev:client

• API: http://localhost:4000/api
• Frontend: http://localhost:5173

Core flow

1. Upload files from the React app.
2. Express receives multipart files in memory (single or multi-file).
3. Parser service extracts tabular/text summaries per file.
4. Signal detector computes high-risk patterns.
5. LLM step creates a strict JSON threat report using schema-constrained output.
6. Scoring service computes the final threat score.
7. UI renders top kill shots, recommendations, and chart suggestions.

Code architecture

deathaudit/
├── client/                         # React/Vite frontend
│   ├── src/
│   │   ├── api/
│   │   │   └── deathauditApi.js    # API client for backend communication
│   │   ├── components/
│   │   │   ├── ChartSuggestionList.jsx
│   │   │   ├── FileDropzone.jsx
│   │   │   ├── KillShotList.jsx
│   │   │   └── ThreatScoreCard.jsx
│   │   ├── pages/
│   │   │   ├── HomePage.jsx        # File upload entry point
│   │   │   └── ReportPage.jsx      # Threat report display
│   │   ├── styles/
│   │   │   └── app.css
│   │   ├── App.jsx
│   │   └── main.jsx
│   ├── index.html
│   └── vite.config.js
│
├── server/                         # Express REST API
│   └── src/
│       ├── config/
│       │   └── env.js              # Environment variable validation
│       ├── controllers/
│       │   └── analysis.controller.js
│       ├── middleware/
│       │   └── error.middleware.js
│       ├── routes/
│       │   └── analysis.routes.js
│       ├── schemas/
│       │   └── analysis.schema.js  # JSON schema for LLM output constraints
│       ├── services/
│       │   ├── analysis.service.js     # Orchestrates the full pipeline
│       │   ├── llm.service.js          # Claude threat report generation
│       │   ├── parser.service.js       # File extraction and summarization
│       │   ├── scoring.service.js      # Final threat score computation
│       │   └── signal-detector.service.js  # High-risk pattern detection
│       ├── utils/
│       │   └── statistics.js
│       ├── app.js
│       └── server.js
│
├── .env.example
└── package.json

MVP API

• GET /api/health
• POST /api/analyze with multipart files[]