Feat/basic domain layer

[theveenrok]

Summary

Summary

Add base classes for DDD patterns: BaseEntity, BaseValueObject, BaseUseCase.

Changes

• Added DomainError, InvariantViolationError and ValidationError.
• Added abstract BaseValueObject, BaseEntity.
• Added EntityIdUUID6ValueObject.
• Allowed unused self in test classes.
• Added hack for hook ty-check by specifying the python virtual environment: pre-commit hook for ty astral-sh/ty#269.
• Added ApplicationError.
• Added abstract BaseUseCase.

Verification

• just check

Docs

• Docs added/updated

Tests

• Tests added for BaseValueObject
• Tests added for BaseEntity
• Tests added for EntityIdUUID6ValueObject
• Tests added for BaseUseCase

Changelog

• Added changelog fragment in changelog.d/

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 6b53642f-b9ce-416d-8f89-0e7927a560d3

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/basic-domain-layer

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[theveenrok]

@ShavrinAleksei, Check the tests for Entity, I have a question. Should entities be compared and hashed only by id? or all fields?

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 352fe89a5f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Copy incoming value to preserve value-object immutability

The constructor stores _normalize(value) by reference, so if a mutable input is passed and normalization returns that object, later external mutations change internal state after validation. This undermines value-object immutability and can silently change equality/hash behavior over time; defensively copying at construction avoids aliasing with caller-owned data.

Useful? React with 👍 / 👎.