0Pricing
TypeScript Academy · Pelajaran

Pemodelan domain — agregat, invarian & layanan

Modelkan agregat seperti Cart dengan ID ber-brand dan tegakkan invarian melalui factory serta layanan.

Pemodelan domain — agregat, invarian & layanan adalah pelajaran TypeScript Academy gratis di CoddyKit. Ini adalah pelajaran 3 dari 3. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar TypeScript Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus TypeScript Academy mencakup 3 pelajaran total.

Pengantar

Tujuan: Modelkan agregat Cart menggunakan ID bertanda dan pastikan aturan seperti qty > 0 ditegakkan dalam pabrik dan layanan.

  • ID bertanda membedakan batas entitas
  • Pabrik mengembalikan union Result
  • Fungsi layanan menghindari transisi yang tidak valid

Entitas & Penanda

ID bertanda membuat CartId dan ProductId tidak kompatibel meskipun keduanya berupa string. Ini mencegah kekeliruan pertukaran.

type Brand<Tag extends string, T> = T & { readonly __brand: Tag }

type CartId = Brand<"CartId", string>
type ProductId = Brand<"ProductId", string>

type Result<T> = { ok: true; value: T } | { ok: false; error: string }

const cartId = (s: string): CartId => s as CartId
const productId = (s: string): ProductId => s as ProductId

Agregat & Invarian

Pabrik memvalidasi aturan: qty harus > 0. Hanya objek Line yang valid yang dapat dibuat.

type Money = number & { readonly __brand: "Money" }
const money = (n: number): Money => n as Money

interface Line { productId: ProductId; qty: number; price: Money }
interface Cart { id: CartId; lines: Line[]; total: Money }

function makeLine(productId: ProductId, qty: number, price: Money): Result<Line> {
  if (!Number.isInteger(qty) || qty <= 0) return { ok: false, error: "qty must be > 0" }
  return { ok: true, value: { productId, qty, price } }
}

function makeCart(id: CartId): Cart { return { id, lines: [], total: money(0) } }

Layanan: addItem

Fungsi layanan melakukan transisi yang aman dan menghitung ulang total. Jika total tidak valid, fungsi mengembalikan kesalahan alih-alih merusak status.

function addItem(cart: Cart, line: Line): Result<Cart> {
  const lines = [...cart.lines, line]
  const totalNum = lines.reduce((s, x) => s + (x.qty * (x.price as number)), 0)
  if (!Number.isFinite(totalNum) || totalNum < 0) return { ok: false, error: "invalid total" }
  return { ok: true, value: { ...cart, lines, total: (totalNum as unknown) as Money } }
}

// Usage
const c0 = makeCart(cartId("c1"))
const l = makeLine(productId("p1"), 2, money(10))
const c1 = l.ok ? addItem(c0, l.value) : { ok: false, error: "bad line" }

Pemetaan Batas

Pada batas sistem (misalnya, API), konversikan ke DTO dan validasikan saat menguraikannya kembali. Pabrik memastikan data sudah benar.

type CartDTO = { id: string; lines: { productId: string; qty: number; price: number }[]; total: number }

function serialize(c: Cart): CartDTO {
  return {
    id: c.id as unknown as string,
    lines: c.lines.map(x => ({ productId: x.productId as unknown as string, qty: x.qty, price: x.price as unknown as number })),
    total: c.total as unknown as number
  }
}

function parse(dto: CartDTO): Result<Cart> {
  const id = cartId(dto.id)
  const lines: Line[] = []
  for (const raw of dto.lines) {
    const l = makeLine(productId(raw.productId), raw.qty, money(raw.price))
    if (!l.ok) return { ok: false, error: l.error }
    lines.push(l.value)
  }
  const totalNum = lines.reduce((s, x) => s + (x.qty * (x.price as number)), 0)
  return { ok: true, value: { id, lines, total: money(totalNum) } }
}

Ringkasan Praktik Terbaik

Praktik terbaik:

  • Sentralisasikan validasi dalam pabrik.
  • Jaga fungsi layanan tetap murni dan deterministik.
  • Lakukan konversi penanda hanya pada batas sistem.

Pemeriksaan Invarian

Pemeriksaan singkat: Bagaimana seharusnya Anda menegakkan invarian seperti qty > 0?

Ringkasan

Ringkasan: ID bertanda yang dipadukan dengan pabrik dan layanan menegakkan invarian. Status yang tidak valid tidak dapat dibuat karena semua titik masuk memvalidasi masukan.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Pemodelan domain — agregat, invarian & layanan” gratis?

Ya — teks lengkap “Pemodelan domain — agregat, invarian & layanan” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus TypeScript Academy, upgrade ke CoddyKit PRO. Kursus TypeScript Academy mencakup 3 pelajaran total.

Apa yang akan aku pelajari di “Pemodelan domain — agregat, invarian & layanan”?

Modelkan agregat seperti Cart dengan ID ber-brand dan tegakkan invarian melalui factory serta layanan. Kamu berlatih TypeScript Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai TypeScript Academy?

Tidak diperlukan pengalaman sebelumnya. TypeScript Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 3 dari 3.

Berapa lama pelajaran “Pemodelan domain — agregat, invarian & layanan” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran TypeScript Academy ini?

Ya. Setiap pelajaran TypeScript Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

  1. Tipe brand/opaque untuk mencegah kekeliruan satuan
  2. ID bertag dan pola pemodelan domain
  3. Pemodelan domain — agregat, invarian & layanan
← Kembali ke TypeScript Academy