Implementing Data Subject Modules in Project-Sass-Lopdp

Architectural Overview

In our ongoing development of the project-sass-lopdp system, we have reached a milestone with the implementation of a dedicated module for managing data subjects. Adhering to our commitment to Hexagonal Architecture, we structured this feature to ensure business logic remains decoupled from infrastructure concerns.

Implementation Strategy

To manage data subjects effectively, we defined a clear domain boundary. By leveraging NestJS, we can enforce strict dependency injection, allowing our services to interact with repositories without knowing the underlying persistence details.

Defining the Domain Model

We started by creating a clean domain entity. In a hexagonal setup, this entity should focus purely on business constraints:

export class DataSubject {
  constructor(
    public readonly id: string,
    public readonly fullName: string,
    public readonly email: string
  ) {}
}

Repository Pattern with TypeORM

By implementing the repository pattern, we hide the database implementation behind an interface. This makes it easier to migrate or test our persistence layer using TypeORM or other Hibernate-like tools:

@Injectable()
export class TypeOrmDataSubjectRepository implements IDataSubjectRepository {
  constructor(private readonly repo: Repository<DataSubjectEntity>) {}

  async save(subject: DataSubject): Promise<void> {
    await this.repo.save(subject);
  }
}

Benefits of the Approach

The separation of concerns allows us to maintain a high level of testability. Since the core logic only knows about the IDataSubjectRepository interface, we can easily swap our database implementation for mocks during unit testing or change the underlying persistence technology without touching the business rules.

Next Steps

With the module infrastructure in place, the next step is to implement the validation layer to ensure all data subject inputs adhere to privacy regulations. I encourage you to define your repository interfaces clearly before wiring up your database entities to ensure your domain remains pure.

Generated with Gitvlg.com