This is a code generator for SuperOffice CRM. It generates n number of entities and pushes them to the CRM online.
This repository currently contains two application surfaces:
src: the original .NET console generatorwebsrc: the Next.js web application for browser-based provisioning
- Clone the repository and navigate to the src directory.
- Update the
appsettings.jsonfile with your application client id and secret. See Developer Portal for more details: https://dev.superoffice.com
- Must have one RedirectUri defined as
^http://127.0.0.1\:\d{4,10}$
- Build the project using the command:
dotnet build - Run the application using the command:
dotnet run
The web application in websrc is a Next.js 14 App Router application that authenticates with SuperOffice, stores templates and job manifests in a local SQLite database (Prisma), and executes provisioning jobs through the SuperOffice Web API.
flowchart TD
User[Browser User] --> Login[SuperOffice OIDC Login]
Login --> App[Next.js App Router]
App --> Actions[Server Actions]
App --> Stream[Job SSE Route]
Actions --> DB[(SQLite via Prisma)]
Stream --> Exec[Provisioning Executor]
Exec --> SO[SuperOffice Web API]
Key runtime characteristics:
- templates and jobs are stored in a local SQLite database via Prisma
- queued jobs execute when the job detail page opens the SSE stream
- provisioning supports entity-agent mode and bulk mass-operations mode
- entities are executed in topological order based on
dependsOndeclarations - custom (non-builtin) database tables are supported alongside the five builtin entity types
cd websrc
npm install
npx prisma migrate dev
npm run devOpen http://localhost:3000 and sign in with a SuperOffice account.
See websrc/README.md for full setup, configuration, and how-to guides.
- websrc/README.md — setup, template configuration, and job execution guide
- docs/websrc-application-specification.md
- docs/websrc-prd-gap-checklist.md