Data Entry App

Initial MVP implementation of the costing platform described in CLAUDE.MD.

Structure

backend/   FastAPI API, SQLAlchemy models, costing engine, seed data, tests
frontend/  SvelteKit UI scaffold for dashboard and core modules

Backend

Create a virtual environment, install dependencies, then run:

cd backend
pip install -e .
uvicorn app.main:app --reload

API docs will be available at http://localhost:8000/docs.

Useful commands:

python -m app.seed
pytest

The backend defaults to SQLite for the prototype and can be switched with the DATABASE_URL environment variable.

Frontend

Install dependencies and start the dev server:

cd frontend
npm install
npm run dev

Set PUBLIC_API_BASE_URL if the backend is not running on http://localhost:8000.

Delivered in this MVP

• Raw materials with versioned prices
• Mixes with ingredient rows and calculated cost per kg
• Products with transparent cost breakdowns
• Scenario runs with override support
• Power BI-style reporting endpoints
• SvelteKit dashboard and module pages aligned to the API contract