Documentation

Everything you need to build

Quick start guides, core concepts, and API reference for Clinvio Nucleus.

Getting Started

Core Concepts

🗃️ Entities

BaseEntity, @SensitiveData, soft delete, audit fields.

⚙️ Services

CvBaseService, CRUD operations, search.

🌐 Controllers

CvBaseCrudController, HTMX responses.

🔄 Workflow

State machine, transitions, callbacks.

✅ Validation

CvValidation builder, field errors.

🔒 Security

JWT authentication, @Secured, RBAC.

Configuration Reference

# Database
spring.datasource.url=jdbc:sqlite:./data/app.db
spring.datasource.driver-class-name=org.sqlite.JDBC
spring.jpa.hibernate.ddl-auto=update

# Encryption (REQUIRED)
clinvio.persistence.encryption-key=${CLINVIO_ENCRYPTION_KEY}

# Security
clinvio.nucleus.security.jwt.secret=${JWT_SECRET}
clinvio.nucleus.security.jwt.expiration=86400000

# Observability
clinvio.nucleus.observability.enabled=true
management.endpoints.web.exposure.include=health,metrics,prometheus

# Cache
clinvio.nucleus.cache.enabled=true
clinvio.nucleus.cache.caffeine.maximum-size=1000

# DevTools
clinvio.nucleus.devtools.enabled=true
clinvio.nucleus.devtools.hot-reload=true