NewHeap Platform Het open-source fundament onder onze .NET- en Angular-software.
Het NewHeap Platform is een set herbruikbare .NET- en Angular-bibliotheken voor zakelijke applicaties die jaren meegaan. Inloggen, rechten, data, achtergrondwerk, media en AI met goedkeuringen zitten erin, als losse pakketten. Wij bouwen er onze klantsoftware en eigen producten op, en de code staat open source op GitHub.
Open source onder de Apache 2.0-licentie
NewHeap Platform
Zo werkt het
Kies wat je nodig hebt
Het platform is geen alles-of-niets-framework. Je voegt alleen de pakketten toe die je nodig hebt, gewoon van nuget.org en npm, zonder account of token.
Bouw je eigen domein
Je entiteiten, rechten, workflows en migraties blijven in je eigen applicatie. Het platform levert het gedrag dat elke zakelijke applicatie nodig heeft.
Volg een werkend voorbeeld
Elke mogelijkheid staat werkend in een voorbeeldapplicatie, met tests en uitleg. Coding agents krijgen dezelfde richtlijnen als je team.
Blijf eenvoudig bij
Elk onderdeel heeft zijn eigen versienummer. Bij een brekende wijziging staat in de release notes precies wat je moet aanpassen.
Zo ziet het eruit
Werk dat een request overleeft
Een analyse over alle projecten draait als duurzame achtergrondtaak: opgesplitst in onderliggende taken, met live voortgang, nieuwe pogingen bij fouten en een logboek van elke stap.
Schermafbeelding uit de voorbeeldapplicatie van het platform, met voorbeelddata.
Wat het platform kan
Inloggen en rechten
Passkeys, tweestapsverificatie en een eigen sessie per aanmelding. Rechten op drie niveaus: de applicatie, de divisie en het object zelf. De backend dwingt ze af; de interface toont alleen wat mag.
SQL Server en PostgreSQL
Beide databases zijn gelijkwaardig en worden getest tegen echte databases. Filteren, sorteren en pagineren gebeurt op de server, met gedeeltelijke updates, bulkimport en transacties.
Werk op de achtergrond
Duurzame taken met nieuwe pogingen, annuleren, geneste voortgang en live updates. Events gaan in dezelfde transactie als je data, en een event dat twee keer binnenkomt, wordt één keer verwerkt.
Angular-bouwstenen
API-services, lijsten met filters op de server, formulieren in modals, meldingen en de voortgang van achtergrondtaken. Herbruikbaar in elk beheerportaal.
AI met goedkeuringen
Een assistent en agents in je eigen applicatie, met tools, MCP, modelprofielen en budgetten. Hieronder lees je hoe de AI-module werkt.
Gemaakt voor coding agents
Het platform levert skills voor Codex en Claude Code, gemaakt uit dezelfde gevalideerde voorbeelden als de documentatie. Zo bouwt een agent zoals het platform het bedoelt.
AI-module
AI die nooit de beveiligingsgrens wordt
De AI-module brengt een assistent en zelfstandige agents naar je eigen applicatie. Het uitgangspunt: beleid beslist, context informeert. Wat een model mag zien en doen, bepaalt vertrouwde code, niet de prompt.
Zo zetten wij AI in
Een assistent in je applicatie
Een chatpaneel voor Angular met gedeelde gesprekken, eigen voorkeuren en Nederlandse en Engelse teksten. Elke actie draait met de rechten van de ingelogde gebruiker.
Agents die zelf aan de slag gaan
Agents starten bij een gebeurtenis, volgens een schema of via een webhook. Ze bereiden werk voor en doen voorstellen, die mensen later beoordelen volgens een goedkeuringsbeleid dat jij kiest.
Eerst een exact voorstel
Een akkoord geldt alleen voor precies dat voorstel, door die persoon en binnen een termijn. Vlak voor uitvoering wordt opnieuw gecontroleerd, en een agent keurt nooit zijn eigen voorstel goed.
Je eigen API’s als tools
Methodes en bestaande controllers worden tools met een vast contract en een verklaard effect. Het model krijgt precies de tools die het mag aanroepen, met dezelfde rechten als een gebruiker.
MCP, in twee richtingen
Publiceer je tools als MCP-server, of koppel externe MCP-servers. Die gelden als onbetrouwbaar: hun tools staan uit tot een beheerder ze aanzet, en zo’n wijziging vraagt zelf om goedkeuring.
Elk model, met grenzen
Je applicatie kiest de aanbieder. Een modelprofiel legt per toepassing vast welke gegevensklassen en regio’s zijn toegestaan, met budgetten voor tokens, aanroepen en kosten.
Nieuw
Agents die op je eigen objecten werken
Gebouwd en getest, op weg naar de volgende release. Agents werken op de dingen waar je applicatie om draait, zoals projecten, orders of dossiers.
- Kies waaraan een agent werkt: bepaalde objecten, per divisie of de hele applicatie
- ‘Nu uitvoeren’ vanaf een bord, het beheer of de pagina van een object
- Voorstellen wachten bij het object zelf, op de goedkeurders van dat object
- MCP-koppelingen met OAuth, voor de organisatie of per persoon
De AI-module in de voorbeeldapp
Een agent die zelf voorbereidt
Zodra er een project bijkomt, beoordeelt de intake-reviewer het en stelt hij de volgende status voor. Het voorstel wacht op de goedkeurders van het project, met de runs, het werkgeheugen en de bestanden van de agent ernaast.
Agents op een bord
Een bord toont per groep agents waar ze aan werken, hun laatste resultaat en wat nieuw is sinds je vorige bezoek. Wie dat mag, start een agent direct met ‘Nu uitvoeren’.
Elke agent in één oogopslag
Waaraan een agent werkt, wanneer, hoe, namens wie en wie zijn voorstellen goedkeurt, in zes stappen op één scherm. Hier de eerste drie.
Met het voorbeeldmodel van de voorbeeldapp. Het bord en het overzicht komen uit de ontwikkelversie en kunnen nog veranderen.
Gemaakt om jaren mee te gaan
De ontwerpregels van het platform gelden voor elk pakket, ook voor de AI-module.
- Beleid beslist, context informeert
- Wat iemand mag, bepaalt vertrouwde code. De interface en een prompt zijn nooit de grens: rechten, tenant, goedkeuringen en budgetten worden in de backend afgedwongen.
- Uitkomsten zijn expliciet
- Validatie, rechten, conflicten en herstelbare fouten zijn gewone resultaten. Excepties zijn er alleen voor wat echt uitzonderlijk is.
- Jouw domein blijft van jou
- Het platform bezit het herbruikbare gedrag. Je applicatie bezit haar entiteiten, rechten, workflows, migraties en bedrijfsregels.
- Pas af met een voorbeeld
- Een mogelijkheid is pas klaar als de voorbeeldapp hem laat zien, gerichte tests hem bewijzen en de richtlijnen uitleggen hoe je hem gebruikt.
- Eerlijk over wat er gebeurt
- Duurzame status, idempotentie, audit, veilige foutcodes en zichtbare voortgang zitten er vanaf het begin in, niet pas na het eerste incident.
- Bij twijfel dicht
- Een ontbrekende of te korte sleutel stopt het opstarten. De AI-assistent staat standaard uit, en tools van externe MCP-servers staan uit tot een beheerder ze aanzet.
Gebouwd met het platform
Het platform komt uit ons eigen werk. Deze applicaties zijn ermee gebouwd, en ze gebruiken ook de AI-module.
Online Plastics Group
Centraal commerceplatform voor Online Plastics Group
CompanistJe bedrijf opbouwen en runnen vanuit één omgeving.
Merk, website, marketing, klanten en werk op één plek, met AI-agents die het werk voorbereiden. Jij ziet vooraf wat er verandert en beslist.
Voor technische lezers Architectuur en specificaties
Voor technische lezers: hoe een applicatie op het platform is opgebouwd, en wat er gebeurt als een AI-agent iets wil veranderen.
Een applicatie op het platform
Front-end
Angular 20
- Beheerportaal of app Met @newheap/platform-common: API-services, lijsten, modals en meldingen.
- AI-chat Met @newheap/platform-ai-chat: chatpaneel, goedkeuringen, agentbeheer en borden.
Back-end
.NET 10 en ASP.NET Core
- API Contracten met OpenAPI, inloggen, rechten en foutmeldingen als ProblemDetails.
- Jouw domein Entiteiten, regels, workflows en migraties. Van jou, niet van het platform.
- Processen Events met een outbox, achtergrondtaken, notificaties en media.
- AI Modelprofielen, tools, context, agents en goedkeuringen.
Infrastructuur
Jouw keuze
- Database SQL Server of PostgreSQL, via EF Core.
- Berichten RabbitMQ via CAP.
- Bestanden Op schijf of in S3-compatibele opslag.
- AI-model Elke aanbieder met een client voor Microsoft.Extensions.AI.
- Elk pakket is los te gebruiken. De database, de opslag en de AI-aanbieder kies je in je eigen applicatie.
- De voorbeeldapplicatie start alles samen met .NET Aspire: PostgreSQL, RabbitMQ, de API en twee Angular-apps.
- Logs, metrics en traces gaan via OpenTelemetry. Een OTLP-endpoint instellen is genoeg om ze te verzamelen.
Wat er gebeurt als een agent iets wil veranderen
Aanleiding
- Een vraag in de chat Van een ingelogde gebruiker, met diens rechten.
- Een trigger Een gebeurtenis, een schema, een webhook of een handmatige start.
Agent-run
Bewaakt door het platform
- Context Alleen gegevens die deze persoon mag zien, binnen de grenzen van het modelprofiel.
- Tools Het model krijgt precies de tools die het mag aanroepen, binnen een budget.
- Voorstel Een wijziging wordt een exact voorstel, met doel, invoer en verloopdatum.
- Akkoord Een bevoegde mens keurt precies dit voorstel goed. Vlak voor uitvoering wordt opnieuw gecontroleerd.
- Uitvoeren Eén keer, als duurzame taak, en vastgelegd: wie voorstelde, wie akkoord gaf en wat er gebeurde.
Je applicatie
- Eigen API’s en data Aangeroepen met dezelfde rechten en via dezelfde pijplijn als een gebruiker.
- MCP-servers Extern en dus onbetrouwbaar: hun tools staan uit tot een beheerder ze aanzet.
- Elke tool verklaart vooraf wat hij doet. Wijzigingen, externe acties en verwijderingen vragen om een akkoord; verwijderingen worden na uitvoering ook nog gecontroleerd.
- Een agent keurt nooit zijn eigen voorstel goed. Is het object intussen veranderd, dan wordt het voorstel standaard gesloten in plaats van uitgevoerd.
- Meer rechten dan de persoon namens wie hij werkt, krijgt een agent alleen als de tool dat toestaat én de code van de applicatie het expliciet toekent.
- Gespreksinhoud blijft in de database van je applicatie. Logs en telemetrie bevatten geen inhoud.
- Licentie
- Apache 2.0. Gebruiken, aanpassen en commercieel inzetten mag; de naam en het logo van NewHeap vallen er niet onder.
- Pakketten
- 30 NuGet-pakketten en 3 npm-pakketten onder @newheap, zonder account te installeren van nuget.org en npm.
- Techniek
- .NET 10, ASP.NET Core en EF Core, met Angular 20 aan de voorkant.
- Databases
- SQL Server en PostgreSQL, allebei getest tegen echte databases in containers.
- Processen
- CAP met RabbitMQ voor events, Hangfire voor geplande taken en eigen duurzame achtergrondtaken met live updates via SignalR.
- AI
- Microsoft.Extensions.AI, de officiële C#-SDK voor MCP en Microsoft Agent Framework.
- Kwaliteit
- Ruim 1.200 backendtests en ruim 500 Angular-tests. Bij elke pull request wordt gecontroleerd of de publieke API onbedoeld verandert.
- Releases
- Alleen via een beschermde workflow op GitHub, met trusted publishing en SHA-256-controlesommen. Nooit vanaf een werkplek.
- Ondersteuning
- Vragen en problemen via GitHub-issues. Hulp bij implementatie, ondersteuning en een SLA via NewHeap.
Aan de slag
De pakketten staan op nuget.org en npm; je hebt geen account of token nodig. Op GitHub vind je de code, de voorbeeldapplicatie en de handleiding.
- Back-end
dotnet add package NewHeap.Platform.AspNet.Common- Front-end
npm install @newheap/platform-common- AI-assistent
dotnet add package NewHeap.Platform.AI.Chat.AspNet
Veelgestelde vragen
Wat is het NewHeap Platform?
Een set open-source .NET- en Angular-bibliotheken voor zakelijke applicaties: inloggen en rechten, data, achtergrondwerk, media, Angular-bouwstenen en AI met goedkeuringen. Wij bouwen er onze klantsoftware en eigen producten op.
Wat mag ik ermee onder de Apache 2.0-licentie?
Je mag de pakketten gebruiken, aanpassen en verspreiden, ook commercieel. De licentie geldt niet voor de naam en het logo van NewHeap: je mag zeggen dat je software met het NewHeap Platform is gebouwd, maar niet suggereren dat NewHeap hem aanbeveelt.
Wat betekent het platform voor software die NewHeap voor ons bouwt?
Je software staat op een fundament dat openbaar is, gedocumenteerd en getest. Een ander team kan die basis dus lezen en gebruiken, en verbeteringen in het platform neem je met een update op in je eigen applicatie.
Welke AI-modellen kan ik gebruiken?
Het platform is niet gebonden aan één aanbieder: je applicatie koppelt een model via Microsoft.Extensions.AI. Per toepassing leg je in een modelprofiel vast welke gegevens en regio’s zijn toegestaan en welk budget geldt. De voorbeeldapp werkt met elk OpenAI-compatibel endpoint, zoals OpenAI, Azure OpenAI of een lokale server.
Kan een AI-agent zelf iets in mijn data veranderen?
Alleen binnen grenzen die je zelf vastlegt. Een agent werkt met de rechten van de persoon of het account namens wie hij werkt, en alleen met de tools die je hem geeft. Een wijziging, een externe actie of een verwijdering wordt een voorstel dat een bevoegde mens goedkeurt. Een agent die namens zichzelf werkt, doet zonder akkoord niets anders dan lezen.
Waar krijg ik hulp?
Vragen en problemen meld je als issue op GitHub; daar helpen we naar beste kunnen. Wil je hulp bij de implementatie, ondersteuning of afspraken in een SLA, neem dan contact met ons op.
Bouwen op het NewHeap Platform?
Wil je weten of het platform past bij je team of je applicatie, of wil je dat wij erop bouwen? We denken graag mee, van de eerste opzet tot AI-agents.