Skip to content

revisium/revisium-core

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

441 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

@revisium/core

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

Your schema. Your data. Full control.

License Quality Gate Status Coverage npm Docker

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 LICENSING.md for details. Code in ee/ directories is licensed under the Revisium Enterprise License.

Contributors

Languages