Application Boundaries and Transactions#

Domain Model ที่ดีอาจถูกทำลายได้ถ้า HTTP handler ตัดสิน policy, repository ส่ง ORM entity ให้ caller แก้ และ transaction commit ก่อน outbox Application boundary ทำให้ use case มีจุดประสาน actor, authorization, model, persistence และ external ports โดยไม่แย่ง business decision จาก domain

Application Service เป็น Use-case Boundary#

ตัวอย่าง ConfirmTransfer:

func (s Service) ConfirmTransfer(ctx context.Context, cmd ConfirmTransfer) error {
	if err := s.authorizer.CanConfirm(ctx, cmd.Principal, cmd.IntentID); err != nil {
		return err
	}

	return s.tx.Within(ctx, func(ctx context.Context) error {
		intent, err := s.intents.ByID(ctx, cmd.IntentID)
		if err != nil {
			return err
		}
		if err := intent.Confirm(cmd.TermsVersion); err != nil {
			return err
		}
		return s.intents.Save(ctx, intent)
	})
}

Application Service orchestrates แต่ intent.Confirm ปกป้อง invariant

Driving Adapter แปล Transport#

HTTP/CLI/message adapter:

• parse/shape validation
• authenticate และสร้าง Principal
• translate DTO เป็น application command
• call use case
• map errors/result เป็น protocol

Domain ไม่ parse JWT/header/status code และไม่รู้ framework

Authorization หลายชั้น#

แยก:

Domain rule maker cannot approve own request อาจอยู่ model/policy แต่ Principal mapping อยู่ adapter

Transaction Boundary#

Local transaction ครอบ changes ที่ต้อง atomic ตาม Aggregate/use case แต่ห้ามเปิด database transaction ค้างระหว่าง network call

Pattern:

Transaction A: record intent/outbox
External call: provider with stable identity/idempotency
Transaction B: record observed outcome
Repair loop: reconcile unknown/crash

Business transaction ยาวกว่าหนึ่ง ACID transaction ต้องมี states/identity/recovery

Ports ตาม Purpose#

Application-owned contracts เช่น:

type PaymentExecutor interface {
	Execute(ctx context.Context, request ExecutionRequest) (ExecutionOutcome, error)
}

Outcome แยก declined, rejected, indeterminate, accepted ไม่คืน vendor DTO/HTTP error ตรง ๆ Port ใช้เมื่อปกป้อง meaningful boundary ไม่สร้าง interface ทุก function เพื่อ mocking

Command และ Result#

Command สื่อ intent มี business identity และ caller context ไม่ใช่ HTTP payload copy:

ConfirmTransfer{IntentID, Principal, TermsVersion, RequestID}

Result สื่อ outcome ที่ caller ใช้ได้ แยก domain rejection จาก technical failure/unknown

แบบฝึกปฏิบัติ: Confirm Transfer Boundary#

วาดและเขียน skeleton:

HTTP DTO -> Principal/Command -> Application Service -> Aggregate -> Repository
                                      |
                                      -> Outbox/Port after correct boundary

ระบุ validation/authorization/domain decision/transaction/error owner และทดสอบ duplicate command, version conflict, unauthorized principal, outbox failure

รายการตรวจสอบ#

• Adapter แปล protocol และสร้าง Principal
• Application Service orchestrates ไม่ถือ hidden domain rule
• Domain model ไม่รู้ HTTP/JWT/SQL/vendor
• Transaction ครอบ atomic local changes
• Network call ไม่อยู่ใน long DB transaction
• Port/result ใช้ application language
• Authorization/domain policy/data isolation แยกชั้น

อ่านเพิ่มเติม#

• DDD Reference — Layered Architecture และ Application Layer
• Hexagonal Architecture — boundary/ports ต้นทาง
• Go Transactions — official transaction guidance