Crealcs Development DokuWiki

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

====== Sprint 7-A.1 — Distribution Core & Channel Management ======

===== Objectif =====

Mettre en place le socle de distribution multi-canaux Enterprise.

Cette couche permet de connecter les propriétés aux différents canaux de vente :

<code>
OTA

Site Web

Application Mobile

Partenaires

Marketplaces

Channel Managers
</code>

afin de centraliser la gestion :

<code>
Inventaire

Tarification

Disponibilités

Synchronisation

Distribution
</code>

À l'issue de cette étape :

<code>
✓ Channel

✓ ChannelConnection

✓ ChannelMapping

✓ DistributionRule

✓ ChannelInventory

✓ ChannelPricing

✓ Distribution Core Platform
</code>

----

====== Architecture cible ======

<code>
Properties

↓

Distribution Core

├── Channels
├── Connections
├── Mapping
├── Inventory
├── Pricing
└── Rules Engine

↓

OTA / Marketplace

↓

Reservations
</code>

----

====== Sprint 7-A.1-A ======

===== Extension Prisma =====

----

====== Étape 1 — Channel ======

===== Ajouter dans schema.prisma =====

<code prisma>
model Channel {

id                    String
                        @id
                        @default(uuid())

code                  String
                        @unique

name                  String

category              ChannelCategory

provider              String

active                Boolean
                        @default(true)

supportsInventory     Boolean
                        @default(true)

supportsPricing       Boolean
                        @default(true)

supportsReservations  Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

connections           ChannelConnection[]

@@index([category])

@@index([active])
}
</code>

----

====== Étape 2 — ChannelConnection ======

===== Ajouter =====

<code prisma>
model ChannelConnection {

id                    String
                        @id
                        @default(uuid())

tenantId              String

channelId             String

portfolioId           String?

connectionName        String

externalAccountId     String?

status                ChannelConnectionStatus

credentials           Json?

lastSyncAt            DateTime?

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

channel               Channel
                        @relation(
                          fields:[channelId],
                          references:[id]
                        )

@@index([tenantId])

@@index([channelId])

@@index([status])
}
</code>

----

====== Étape 3 — ChannelMapping ======

===== Ajouter =====

<code prisma>
model ChannelMapping {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String

channelConnectionId   String

externalPropertyId    String

externalListingId     String?

active                Boolean
                        @default(true)

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

@@index([tenantId])

@@index([propertyId])

@@index([channelConnectionId])
}
</code>

----

====== Étape 4 — DistributionRule ======

===== Ajouter =====

<code prisma>
model DistributionRule {

id                    String
                        @id
                        @default(uuid())

tenantId              String

propertyId            String?

portfolioId           String?

name                  String

priority              Int
                        @default(100)

enabled               Boolean
                        @default(true)

conditions            Json

actions               Json

createdAt             DateTime
                        @default(now())

updatedAt             DateTime
                        @updatedAt

@@index([tenantId])

@@index([enabled])

@@index([priority])
}
</code>

----

====== Étape 5 — ChannelInventory ======

===== Ajouter =====

<code prisma>
model ChannelInventory {

id                    String
                        @id
                        @default(uuid())

propertyId            String

channelMappingId      String

inventoryDate         DateTime

availableUnits        Int

blockedUnits          Int
                        @default(0)

syncedAt              DateTime?

createdAt             DateTime
                        @default(now())

@@unique([
    channelMappingId,
    inventoryDate
  ])

@@index([propertyId])

@@index([inventoryDate])
}
</code>

----

====== Étape 6 — ChannelPricing ======

===== Ajouter =====

<code prisma>
model ChannelPricing {

id                    String
                        @id
                        @default(uuid())

propertyId            String

channelMappingId      String

pricingDate           DateTime

basePrice             Decimal
                        @db.Decimal(12,2)

adjustedPrice         Decimal?
                        @db.Decimal(12,2)

currency              String

syncedAt              DateTime?

createdAt             DateTime
                        @default(now())

@@unique([
    channelMappingId,
    pricingDate
  ])

@@index([propertyId])

@@index([pricingDate])
}
</code>

----

====== Étape 7 — Enums ======

===== Ajouter =====

<code prisma>
enum ChannelCategory {

OTA

DIRECT

MARKETPLACE

WHOLESALER

CORPORATE

CHANNEL_MANAGER
}

enum ChannelConnectionStatus {

PENDING

CONNECTED

ERROR

DISCONNECTED
}
</code>

----

====== Étape 8 — Migration ======

<code bash>
npx prisma migrate dev \
--name distribution_core
</code>

----

====== Sprint 7-A.1-B ======

===== Distribution Module =====

----

====== Étape 9 — Structure ======

<code>
src/modules/distribution

├── channels
├── connections
├── mappings
├── inventory
├── pricing
├── rules
└── distribution.module.ts
</code>

----

====== Étape 10 — Services ======

<code>
ChannelService

ChannelConnectionService

ChannelMappingService

DistributionRuleService

ChannelInventoryService

ChannelPricingService
</code>

----

====== Sprint 7-A.1-C ======

===== Gestion des Canaux =====

----

====== Étape 11 — ChannelService ======

===== Créer =====

<code>
channel.service.ts
</code>

----

===== Canaux supportés =====

<code>
Airbnb

Booking.com

Expedia

Abritel

Direct Website

Mobile App
</code>

----

====== Étape 12 — Méthodes ======

<code ts>
getChannels()

createChannel()

activateChannel()

deactivateChannel()
</code>

----

====== Sprint 7-A.1-D ======

===== Gestion des Connexions =====

----

====== Étape 13 — ChannelConnectionService ======

===== Créer =====

<code>
channel-connection.service.ts
</code>

----

===== Méthodes =====

<code ts>
connectChannel()

disconnectChannel()

refreshConnection()

validateCredentials()
</code>

----

====== Étape 14 — Sécurité ======

===== Stocker =====

<code>
API Keys

OAuth Tokens

Secrets
</code>

dans le coffre-fort sécurisé existant.

----

====== Sprint 7-A.1-E ======

===== Mapping =====

----

====== Étape 15 — ChannelMappingService ======

===== Créer =====

<code>
channel-mapping.service.ts
</code>

----

===== Méthodes =====

<code ts>
mapProperty()

unmapProperty()

validateMapping()

syncExternalListing()
</code>

----

====== Étape 16 — Objectif ======

Associer :

<code>
Property

↓

External Listing
</code>

sur chaque canal.

----

====== Sprint 7-A.1-F ======

===== Distribution Rules =====

----

====== Étape 17 — DistributionRuleService ======

===== Créer =====

<code>
distribution-rule.service.ts
</code>

----

===== Supporter =====

<code>
Inventory Rules

Pricing Rules

Channel Restrictions

Priority Rules
</code>

----

====== Étape 18 — Exemples ======

<code>
Si Occupancy > 90%

↓

+15% prix
</code>

----

<code>
Si Channel = OTA

↓

Min Stay = 2 nuits
</code>

----

====== Sprint 7-A.1-G ======

===== Inventory Distribution =====

----

====== Étape 19 — ChannelInventoryService ======

===== Créer =====

<code>
channel-inventory.service.ts
</code>

----

===== Méthodes =====

<code ts>
syncInventory()

pushAvailability()

pullAvailability()

resolveInventoryConflict()
</code>

----

====== Étape 20 — Synchronisation ======

===== Supporter =====

<code>
Temps réel

Batch

Webhook
</code>

----

====== Sprint 7-A.1-H ======

===== Pricing Distribution =====

----

====== Étape 21 — ChannelPricingService ======

===== Créer =====

<code>
channel-pricing.service.ts
</code>

----

===== Méthodes =====

<code ts>
syncPricing()

pushRates()

pullRates()

applyChannelMarkup()
</code>

----

====== Étape 22 — Gestion ======

<code>
Prix base

Prix OTA

Prix Corporate

Prix Promotion
</code>

----

====== Sprint 7-A.1-I ======

===== API Distribution =====

----

====== Étape 23 — Endpoints ======

<code http>
GET    /distribution/channels

POST   /distribution/channels/connect

GET    /distribution/mappings

POST   /distribution/mappings

GET    /distribution/inventory

GET    /distribution/pricing

POST   /distribution/rules
</code>

----

====== Étape 24 — Réponse ======

<code json>
{
  "channel":"Booking.com",
  "status":"CONNECTED",
  "mappedProperties":124
}
</code>

----

====== Étape 25 — Multi-Propriété ======

===== Supporter =====

<code>
Portfolio

Property Group

Property
</code>

comme niveau de distribution.

----

====== Sprint 7-A.1-J ======

===== Gouvernance =====

----

====== Étape 26 — Permissions ======

<code>
distribution.read

distribution.connect

distribution.mapping

distribution.inventory

distribution.pricing

distribution.admin
</code>

----

====== Étape 27 — Audit ======

<code>
CHANNEL_CONNECTED

CHANNEL_DISCONNECTED

PROPERTY_MAPPED

INVENTORY_SYNCED

PRICING_SYNCED

DISTRIBUTION_RULE_CREATED
</code>

----

====== Étape 28 — Jobs ======

<code>
Toutes les 5 minutes

Inventory Sync

Pricing Sync

Connection Health Check
</code>

----

====== Préparation Sprint 7-A.2 ======

Compatible avec :

<code>
OTA APIs

Webhook Sync

Channel Intelligence

Rate Optimization
</code>

----

====== Définition de terminé ======

Le Sprint 7-A.1 est terminé lorsque :

<code>
✓ Channel créé

✓ ChannelConnection créé

✓ ChannelMapping créé

✓ DistributionRule créé

✓ ChannelInventory créé

✓ ChannelPricing créé

✓ Distribution Core opérationnel
</code>

----

====== Livrables ======

<code>
Channel

ChannelConnection

ChannelMapping

DistributionRule

ChannelInventory

ChannelPricing

ChannelService

ChannelConnectionService

ChannelMappingService

DistributionRuleService

ChannelInventoryService

ChannelPricingService

Distribution Core Platform
</code>

----

====== Étape suivante ======

===== Sprint 7-A.2 =====

OTA Integrations & Synchronisation Temps Réel

Objectif :

Implémenter :

<code>
Airbnb API

Booking.com API

Expedia API

Webhook Engine

Rate Sync

Availability Sync
</code>

afin de connecter la plateforme aux principaux canaux de distribution.

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International