Yarning — Dynamic Readjustment Engine

Prototype for live urgency score readjustment after community support is delivered.

Concept

This engine models the Living Scores, Not Static Numbers flow:

• Each completed project or engagement triggers a readjustment review.
• The system recalculates need categories that were addressed, using scope and impact.
• Category scores decrease proportionally to reflect improved conditions.
• Overall urgency updates automatically, helping redirect funding to more pressing needs.
• The same flow can also increase scores later if conditions worsen again.

Stack

• React + Vite frontend in client/
• Express backend in server/
• Tailwind CSS is not required for this prototype; simple CSS is included.
• No database: in-memory community state is used for demo purposes.

Quick Start

1. Install dependencies from the repo root:

npm install

2. Start the client and server from the repo root:

npm run dev

3. Open the frontend at http://localhost:5173.

API

• GET /api/reference-data — returns community urgency and category score data.
• POST /api/readjust — accepts completed support changes and returns updated scores.

Demo flow

1. Select a community.
2. Choose a category addressed by a completed engagement.
3. Provide impact and scope ratings.
4. Submit to see the category score decrease and the overall urgency update.