generator-jhipster-entity-audit

JHipster blueprint, entity-audit blueprint for JHipster

Introduction

This is a JHipster blueprint, that is meant to be used in a JHipster application.

You can choose to enable audit for all entities or choose the entities to be audited from a list during generation.

The module will extend the selected entities and its DTOs with AbstractAuditingEntity and AbstractAuditingDTO class respectively to enable audits, hence make sure that your entities/DTOs doesn't have any super class.

This will also add new columns to the liquibase changeset for the entities, so it is ideal to recreate the tables if you are enabling this for existing entities.

The Audit log page is optional and can be added by choosing the option while running the generator

jhipster-entity-audit module will register itself as a hook for Jhipster and the question to enable audit will available during future entity generation as well

Javers integration

When using sql or mongodb you can use Javers for entity auditing.

The module will add spring-boot integration for javers. Each repository is annotated with the required @JaversSpringDataAuditable annotation. The new class JaversAuthorProvider provides javers with the correct user modifying an entity.

Prerequisites

As this is a JHipster blueprint, we expect you have JHipster and its related tools already installed:

• Installing JHipster

Installation

To install or update this blueprint:

npm install -g generator-jhipster-entity-audit

Usage

To use this blueprint, run the below command

jhipster --blueprints entity-audit

You can look for updated entity-audit blueprint specific options by running

jhipster app --blueprints entity-audit --help

And looking for (blueprint option: entity-audit) like

Pre-release

To use an unreleased version, install it using git.

npm install -g jhipster/generator-jhipster-entity-audit#main
jhipster --blueprints entity-audit --skip-jhipster-dependencies