@revisium/core

Backend API for Revisium — unopinionated data platform with referential integrity.

Your schema. Your data. Full control.

Referential integrity with foreign keys at any depth. Git-like versioning: branches, revisions, drafts. Schema evolution: migrations with data transformations.

Part of the Revisium ecosystem. Available on npm | Docker Hub.

Architecture

┌─────────────────────────────────────────────────────────┐
│                      API Layer                          │
├─────────────────┬─────────────────┬─────────────────────┤
│    GraphQL      │    REST API     │        MCP          │
│  (Apollo Server)│                 │  (Model Context     │
│                 │                 │   Protocol)         │
├─────────────────┴─────────────────┴─────────────────────┤
│                   Application Layer                     │
│              CQRS: Commands & Queries                   │
├─────────────────────────────────────────────────────────┤
│                    Domain Layer                         │
│         Business Logic, Validation, Events              │
├─────────────────────────────────────────────────────────┤
│                 Infrastructure Layer                    │
├───────────┬─────────┬───────────┬───────────────────────┤
│ PostgreSQL│  Redis  │    S3     │        SMTP           │
│ (Prisma)  │ (Cache) │ (Files)   │       (Email)         │
└───────────┴─────────┴───────────┴───────────────────────┘

API Layer

| Interface | Description | |-----------|-------------| | GraphQL | Primary API. Apollo Server with subscriptions | | REST | HTTP endpoints for integrations | | MCP | Model Context Protocol for AI agents (Claude, etc.) |

Application Layer

CQRS pattern separates read and write operations:

• Commands — mutations (create, update, delete)
• Queries — data retrieval with filtering and pagination

Domain Layer

• JSON Schema validation
• Foreign key integrity checks
• Revision and branch management
• Schema migration engine

Infrastructure

| Component | Purpose | |-----------|---------| | PostgreSQL | Primary data storage (via Prisma ORM) | | Redis | Caching and pub/sub | | S3 | File storage | | SMTP | Email notifications |

Documentation

• ENV.md — Environment variables
• docs/ — Technical documentation

Related Packages

| Package | Description | |---------|-------------| | @revisium/endpoint | Dynamic GraphQL/REST API generator | | @revisium/schema-toolkit | JSON Schema utilities, validation, and transformation helpers | | @revisium/formula | Formula expression parser and evaluator for computed fields | | revisium-cli | CLI for migrations — save and apply schema & data changes across environments |

License

Apache 2.0 — See Revisium for full license.