MixMaster

MixMaster is a concrete mix design and AI optimization platform for ready-mix companies, contractors, material labs, consultants, and concrete engineers. It combines a multi-tenant SaaS backend, an engineering workflow frontend, simulation and reporting tools, and an AI service boundary for mix optimization.

The product helps engineering teams calculate mix proportions, compare alternatives, track material prices, estimate cost and CO2 impact, generate reports, and use AI-assisted recommendations before lab validation.

AI recommendations require engineering review and lab validation before real production use.

Key Features

• Multi-tenant SaaS model for companies, engineers, tenant admins, and platform admins
• Project workspace for mix designs, versions, simulations, AI jobs, reports, and materials
• Concrete mix calculator with cost, strength, material quantity, and risk outputs
• Simulation and scenario comparison for alternative mix designs
• AI optimization boundary using BOxCrete-compatible model services and Ollama-backed chat flows
• Material catalog, pricing history, countries, cities, currencies, and tenant-specific data
• JWT authentication, role-based authorization, audit-friendly domain entities, and seed data
• Billing/subscription boundary with PayPal checkout integration points
• HTML/CSV report generation and Postman API collections
• Responsive Vite frontend with application screens for dashboard, projects, calculator, simulations, AI, billing, materials, reports, and admin tools

Architecture

MixMaster
├── backend
│   ├── src/Domain          # Entities, enums, and framework-free domain model
│   ├── src/Application     # DTOs, abstractions, calculation, simulation, and AI services
│   ├── src/Infrastructure  # EF Core PostgreSQL persistence, Identity, integrations
│   ├── src/WebApi          # ASP.NET Core API, JWT auth, Swagger, controllers
│   └── src/AiService       # Separate .NET AI service boundary and model orchestration
├── frontend                # Vite single-page application
└── docs                    # PRD, UX spec, prototypes, Postman collections, assets

Technical Tools

Backend

• .NET 10, ASP.NET Core Web API, C#
• Clean Architecture, Domain-Driven Design style layering, CQRS-friendly application services
• Entity Framework Core 10 with PostgreSQL through Npgsql
• ASP.NET Core Identity, JWT Bearer authentication, role-based policies
• Swagger / OpenAPI through Swashbuckle

AI and Optimization

• Separate .NET AI service for optimization jobs, prompt workflows, long polling, and chat
• BOxCrete-compatible Python model service boundary
• FastAPI and Uvicorn for the Python model runtime
• Ollama integration for local LLM-backed assistant workflows
• Docker Compose for local AI service, model service, and Ollama runtime

Frontend

• Vite 7
• Vanilla JavaScript modules
• HTML/CSS application shell
• API client with JWT bearer support and response normalization

Data, DevOps, and Integration

• PostgreSQL
• Docker and Docker Compose
• PayPal checkout integration boundary
• Postman collections and environment files
• Local HTML/CSV report generation

Repository Documentation

• Backend README
• Technical Overview
• GitHub Publication Notes
• Product Requirements Document
• UX Specification
• Postman Collection

Run Locally

Prerequisites

• .NET SDK 10
• Node.js 20+
• PostgreSQL
• Docker Desktop, optional but recommended for the AI stack
• Ollama, optional when running the AI assistant locally outside Docker

Backend API

Update the local connection string in backend/src/WebApi/appsettings.Development.json, then run:

cd backend
dotnet restore
dotnet run --project .\src\WebApi\WebApi.csproj --urls http://localhost:5088

Swagger:

http://localhost:5088/swagger

AI Service

cd backend
dotnet run --project .\src\AiService\AiService.csproj --urls http://localhost:5091

Or run the local AI stack with Docker:

cd backend
docker compose -f .\src\AiService\docker-compose.yml up --build

Frontend

cd frontend
npm install
npm run dev

The frontend currently points at:

https://localhost:7230/api

Update frontend/src/app/state.js if your API is running on another URL.

Suggested GitHub Description

Concrete mix design SaaS platform with .NET 10 Clean Architecture, PostgreSQL, Vite frontend, AI optimization service, BOxCrete/FastAPI model boundary, Ollama assistant workflows, simulations, reports, billing, and multi-tenant engineering tools.

Suggested GitHub Topics

dotnet aspnetcore clean-architecture postgresql vite saas multi-tenant concrete-mix-design ai fastapi ollama docker engineering-software

Status

This repository is an active product prototype/MVP codebase. Production deployment requires secure configuration, real payment credentials, infrastructure hardening, and engineering validation of AI recommendations.