@volontariapp/domain-post 3.6.11 → 3.6.12

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 3.6.12
+
+### Patch Changes
+
+- README bump
+
+- Updated dependencies []:
+  - @volontariapp/contracts@4.3.2
+  - @volontariapp/database@3.4.4
+  - @volontariapp/errors@0.6.1
+  - @volontariapp/errors-nest@0.13.1
+  - @volontariapp/logger@0.2.6
+  - @volontariapp/messaging@2.10.1
+  - @volontariapp/outbox@0.9.41
+
 ## 3.6.11
 
 ### Patch Changes

package/README.md

@@ -0,0 +1,75 @@
+# @volontariapp/domain-post
+
+## Overview & Domain Driven Design (DDD)
+
+Le package `domain-post` contient la **logique métier absolue** relative aux **Actualités (Posts)**. 
+Tout comme les autres packages de domaine, il est construit autour des principes de la **Clean Architecture**. Il garantit une isolation parfaite entre les règles de gestion d'un Post et la tuyauterie de l'infrastructure (serveur HTTP, bases de données, Kafka/Redis).
+
+Ce package est partagé entre :
+- `ms-post` (API)
+- Les Workers asynchrones de traitement d'images/posts
+- Les Post-Processors (Notifications, Flux)
+
+## Architecture du Domaine
+
+```mermaid
+graph TD
+    subgraph "Domain Layer (Pure TypeScript)"
+        PS[PostService]
+        PE[PostEntity]
+        VO[ContentValueObject]
+        IR[IPostRepository]
+        
+        PS -->|Manipule| PE
+        PE -->|Contient| VO
+        PS -->|Persiste via| IR
+    end
+    
+    subgraph "Infrastructure Layer"
+        PGR[PostgresPostRepository]
+        API[NestJS PostController]
+        
+        PGR -.->|Implémente| IR
+        API -->|Invoque| PS
+    end
+```
+
+## Structure des Dossiers
+
+```text
+src/
+├── entities/           # PostEntity, CommentEntity, LikeEntity
+├── value-objects/      # PostContent (validation de longueur, profanité)
+├── services/           # FeedGenerationService, PostModerationService
+├── repositories/       # Interfaces (IPostRepository) et Implémentations SQL
+└── test/               # Stubs et Factories
+```
+
+## Exemples d'Implémentation
+
+### L'Entité Post et l'encapsulation
+
+```typescript
+// entities/post.entity.ts
+export class PostEntity {
+  private constructor(
+    public readonly id: string,
+    public readonly authorId: string,
+    public content: PostContent, // Value Object
+    public isPublished: boolean
+  ) {}
+
+  // Constructeur statique pour forcer la validation à la création
+  public static create(authorId: string, contentText: string): PostEntity {
+    const content = new PostContent(contentText);
+    return new PostEntity(uuidv4(), authorId, content, false);
+  }
+
+  public publish(): void {
+    if (this.content.isEmpty()) {
+      throw new DomainError('POST_EMPTY', 'Cannot publish an empty post');
+    }
+    this.isPublished = true;
+  }
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volontariapp/domain-post",
-  "version": "3.6.11",
+  "version": "3.6.12",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -43,7 +43,7 @@
     "@nestjs/typeorm": "^11.0.1",
     "@types/jest": "^30.0.0",
     "@types/node": "^22.10.7",
-    "@volontariapp/testing": "1.0.1",
+    "@volontariapp/testing": "1.0.2",
     "jest": "^30.3.0",
     "pg": "^8.20.0",
     "reflect-metadata": "^0.2.2",
@@ -54,13 +54,13 @@
   },
   "dependencies": {
     "@nestjs/common": "^11.0.1",
-    "@volontariapp/contracts": "4.3.1",
-    "@volontariapp/database": "3.4.3",
-    "@volontariapp/errors": "0.6.0",
-    "@volontariapp/errors-nest": "0.13.0",
-    "@volontariapp/logger": "0.2.5",
-    "@volontariapp/messaging": "2.10.0",
-    "@volontariapp/outbox": "0.9.40",
+    "@volontariapp/contracts": "4.3.2",
+    "@volontariapp/database": "3.4.4",
+    "@volontariapp/errors": "0.6.1",
+    "@volontariapp/errors-nest": "0.13.1",
+    "@volontariapp/logger": "0.2.6",
+    "@volontariapp/messaging": "2.10.1",
+    "@volontariapp/outbox": "0.9.41",
     "class-transformer": "^0.5.1"
   }
 }