Documentation
Network source of truth — intent & inventory
IntentCenter documentation
Guides and specifications for the planning repository and Phase 1 platform. Markdown sources live in the repo; these pages mirror the same structure with a persistent section menu for GitHub Pages.
Console
Documentation uses the same charcoal surfaces, Signal Amber accents, and JetBrains Mono labels as the React operator console—so what you read here matches what you run in production.
AI assistant
The in-app Intent Center copilot answers inventory questions with tool-grounded data and can show charts and maps in the chat (for example, aggregations by location and geo from the catalog). See design-llm-assistant.md on GitHub.
Topics
Getting started
Clone the repo, configure the API, run Postgres, Prisma migrations, seed data, and open the console.
REST & OpenAPI
Authentication, /docs/json, Swagger, GraphQL, and v1 endpoints used by the UI.
Data model
UUID tenancy, conventions, and an indexed list of every Prisma model with deep links.
Architecture
System context, logical containers, control vs data plane, deployment patterns, sequences, and plugin boundary.
Wishlist & future work
Backlog from design specs: SSO, plugin install, federation, GraphQL auth parity, copilot consent/RAG, MCP policy, validation extensions, and scale milestones.
Web UI & platform
Stack summary, in-app copilot and admin LLM, sign-in/identity, UI extensibility, connectors, jobs, optional MCP endpoint, REST touchpoints.
Deployment & API spec
OpenAPI discovery, production Docker image, Compose + Kubernetes sample manifests, and every environment variable (GitHub).
MCP server (GitHub) ↗
Optional /mcp for Cursor and other clients; API-token auth; role-scoped tools; off by default.
Auth & user management (GitHub) ↗
Local login, LDAP, Entra, OIDC, AUTH_* env, admin identity API, and public provider catalog.
LLM copilot (GitHub) ↗
Tool-grounded chat, preview for destructive work, next steps & skills, import & triage assist, §18 extensibility (async worker, connectors, federation, macros).
Validation (GitHub) ↗
OpenAPI + client AJV, referential checks, DCIM forms, object templates with visual custom-attribute rules and strict mode (see screenshot in doc).
Source files on GitHub
Authoritative Markdown includes README.md, platform/README.md, design-auth-user-management.md, design-extensibility-plugins-widgets.md, design-mcp-server.md, design-validation.md, deployment.md, environment-variables.md.
