Bạn Không Phải Đang Xây Dựng Netflix: Đừng Lập Trình Như Thể Bạn Đang Làm Vậy

Bạn biết điều gì buồn cười không?
Những sinh viên mới ra trường bootcamp viết code quá đơn giản.
Sáu tháng sau, khi phát hiện ra các design pattern, họ viết code cần bằng tiến sĩ mới hiểu nổi.
Hành trình của một developer về cơ bản là:
“Chờ đã, mình có thể dùng classes?” →“MỌI THỨ PHẢI LÀ FACTORY STRATEGY OBSERVER SINGLETON.”

Để tôi kể cho bạn nghe về lần tôi kế thừa một codebase mà có người đã “thiết kế kiến trúc” cho việc hiển thị tên đầy đủ của người dùng.

Mục Lục

• Tội Ác Chiến Tranh
• Cờ Đỏ #1:
  Ngụy Biện “Chống Lỗi Thời”
• Cờ Đỏ #2:
  Interface Chỉ Có Một Triển Khai
• Cờ Đỏ #3:
  Giải Pháp Tổng Quát Không Ai Đòi Hỏi
• Cờ Đỏ #4:
  Trừu Tượng Hóa Code Ổn Định, Ghép Nối Code Bất Ổn
• Cờ Đỏ #5:
  Tư Duy “Doanh Nghiệp”
• Cờ Đỏ #6:
  Sự Trừu Tượng Hóa Non
• Khi Nào Trừu Tượng Hóa Thực Sự Có Ý Nghĩa
  • 1. API Bên Ngoài SẼ Thay Đổi
  • 2. Nhiều Triển Khai THỰC TẾ
  • 3. Đường May Kiểm Thử
  • 4. Hệ Thống Plugin
• Danh Sách Kiểm Tra:
  Bạn Có Nên Trừu Tượng Hóa Cái Này?
• Phục Hồi:
  Xóa Các Trừu Tượng Hóa Tồi
• Sự Thật Về Code “Có Thể Mở Rộng”
• Triết Lý
• Kết Luận

Tội Ác Chiến Tranh

// user-name-display-strategy.interface.tsexportinterfaceIUserNameDisplayStrategy{formatName(context:UserNameContext):string;supports(type:DisplayType):boolean;}// user-name-context.interface.tsexportinterfaceUserNameContext{firstName:string;lastName:string;locale:string;preferences:UserDisplayPreferences;culturalNamingConvention:CulturalNamingConvention;titlePrefix?:string;suffixes?:string[];}// user-name-display-strategy.factory.ts@Injectable()exportclassUserNameDisplayStrategyFactory{constructor(@Inject("DISPLAY_STRATEGIES")privatereadonlystrategies:IUserNameDisplayStrategy[]){}create(type:DisplayType):IUserNameDisplayStrategy{conststrategy=this.strategies.find((s)=>s.supports(type));if(!strategy){thrownewUnsupportedDisplayTypeException(type);}returnstrategy;}}// standard-user-name-display.strategy.ts@Injectable()exportclassStandardUserNameDisplayStrategyimplementsIUserNameDisplayStrategy{supports(type:DisplayType):boolean{returntype===DisplayType.STANDARD;}formatName(context:UserNameContext):string{return`${context.firstName}${context.lastName}`;}}// Mô-đun kết nối kiến trúc tuyệt đẹp này lại với nhau@Module({providers:[UserNameDisplayStrategyFactory,StandardUserNameDisplayStrategy,FormalUserNameDisplayStrategy,InformalUserNameDisplayStrategy,{provide:"DISPLAY_STRATEGIES",useFactory:(...strategies)=>strategies,inject:[StandardUserNameDisplayStrategy,FormalUserNameDisplayStrategy,InformalUserNameDisplayStrategy,],},],exports:[UserNameDisplayStrategyFactory],})exportclassUserNameDisplayModule{}// Cách sử dụng (hít một hơi thật sâu):constcontext:UserNameContext={firstName:user.firstName,lastName:user.lastName,locale:"en-US",preferences:userPreferences,culturalNamingConvention:CulturalNamingConvention.WESTERN,};conststrategy=this.strategyFactory.create(DisplayType.STANDARD);constdisplayName=strategy.formatName(context);

`${user.firstName}${user.lastName}`;

// "Chúng ta có thể cần nhiều nhà cung cấp thanh toán một ngày nào đó!"exportinterfaceIPaymentGateway{processPayment(request:PaymentRequest):Promise<PaymentResult>;refund(transactionId:string):Promise<RefundResult>;validateCard(card:CardDetails):Promise<boolean>;}exportinterfaceIPaymentGatewayFactory{create(provider:PaymentProvider):IPaymentGateway;}@Injectable()exportclassStripePaymentGatewayimplementsIPaymentGateway{// Triển khai duy nhất trong 3 năm qua// Có lẽ sẽ là duy nhất trong 3 năm tới// Nhưng này, chúng ta đã "sẵn sàng" cho PayPal!}@Injectable()exportclassPaymentGatewayFactoryimplementsIPaymentGatewayFactory{create(provider:PaymentProvider):IPaymentGateway{switch(provider){casePaymentProvider.STRIPE:returnnewStripePaymentGateway();default:thrownewError("Nhà cung cấp thanh toán không được hỗ trợ");}}}

@Injectable()exportclassPaymentService{constructor(privatestripe:Stripe){}asynccharge(amount:number,token:string):Promise<string>{constcharge=awaitthis.stripe.charges.create({amount,currency:"usd",source:token,});returncharge.id;}}

exportinterfaceIUserService{findById(id:string):Promise<User>;create(dto:CreateUserDto):Promise<User>;update(id:string,dto:UpdateUserDto):Promise<User>;}@Injectable()exportclassUserServiceimplementsIUserService{// Triển khai duy nhất// Sẽ là triển khai duy nhất cho đến khi vũ trụ kết thúcasyncfindById(id:string):Promise<User>{returnthis.userRepository.findOne({where:{id}});}}

@Injectable()exportclassUserService{constructor(privateuserRepository:UserRepository){}asyncfindById(id:string):Promise<User>{returnthis.userRepository.findOne({where:{id}});}}

// "Điều này sẽ tiết kiệm RẤT NHIỀU thời gian!"exportabstractclassBaseService<T,ID=string>{constructor(protectedrepository:Repository<T>){}asyncfindById(id:ID):Promise<T>{constentity=awaitthis.repository.findOne({where:{id}});if(!entity){thrownewNotFoundException(`${this.getEntityName()}không tìm thấy`);}returnentity;}asyncfindAll(query?:QueryParams):Promise<T[]>{returnthis.repository.find(this.buildQuery(query));}asynccreate(dto:DeepPartial<T>):Promise<T>{this<s

@Injectable()exportclassUserService{constructor(privateuserRepository:UserRepository,privatepasswordService:PasswordService){}asynccreate(dto:CreateUserDto):Promise<User>{if(awaitthis.emailExists(dto.email)){thrownewConflictException("Email đã tồn tại");}consthashedPassword=awaitthis.passwordService.hash(dto.password);returnthis.userRepository.save({...dto,password:hashedPassword,});}// Chỉ những phương thức người dùng thực sự cần}

// Lập trình viên:
"Để tôi trừu tượng hóa phép tính này!"exportinterfaceIDiscountCalculator{calculate(context:DiscountContext):number;}@Injectable()exportclassPercentageDiscountCalculatorimplementsIDiscountCalculator{calculate(context:DiscountContext):number{returncontext.price*(context.percentage/100);}}@Injectable()exportclassFixedDiscountCalculatorimplementsIDiscountCalculator{calculate(context:DiscountContext):number{returncontext.price-context.fixedAmount;}}// Factory, strategy pattern, đủ cả bộ sưu tập// Cho...
toán học cơ bản chưa thay đổi từ thời Babylon cổ đại

@Injectable()exportclassOrderService{asyncprocessPayment(order:Order):Promise<void>{// Gọi API Stripe cứngconstcharge=awaitfetch("https://api.stripe.com/v1/charges",{method:"POST",headers:{Authorization:`Bearer${process.env.STRIPE_KEY}`,},body:JSON.stringify({amount:order.total,currency:"usd",source:order.paymentToken,}),});// Phân tích định dạng phản hồi đặc thù của Stripeconstresult=awaitcharge.json();order.stripeChargeId=result.id;}}

// Toán học là toán học, giữ nó đơn giảnexportclassDiscountCalculator{calculatePercentage(price:number,percent:number):number{returnprice*(percent/100);}calculateFixed(price:number,amount:number):number{returnMath.max(0,price-amount);}}// Các phụ thuộc bên ngoài cần trừu tượng hóaexportinterfacePaymentProcessor{charge(amount:number,token:string):Promise<PaymentResult>;}@Injectable()exportclassStripeProcessorimplementsPaymentProcessor{asynccharge(amount:number,token:string):Promise<PaymentResult>{// Các phần cụ thể của Stripe được cô lập ở đây}}

// preference-persistence-strategy.interface.tsexportinterfaceIPreferencePersistenceStrategy{persist(context:PreferencePersistenceContext):Promise<void>;}// preference-persistence-context-builder.interface.tsexportinterfaceIPreferencePersistenceContextBuilder{build(params:PreferencePersistenceParameters):PreferencePersistenceContext;}// preference-persistence-orchestrator.service.ts@Injectable()exportclassPreferencePersistenceOrchestrator{constructor(privatecontextBuilder:IPreferencePersistenceContextBuilder,privatestrategyFactory:IPreferencePersistenceStrategyFactory,privatevalidator:IPreferencePersistenceValidator){}asyncorchestrate(params:PreferencePersistenceParameters):Promise<void>{constcontext=awaitthis.contextBuilder.build(params);constvalidationResult=awaitthis.validator.validate(context);if(!validationResult.isValid){thrownewValidationException(validationResult.errors);}conststrategy=this.strategyFactory.create(context.persistenceType);awaitstrategy.persist(context);}}

awaitthis.userRepository.update(userId,{darkMode:true});

// First API endpoint@Controller("users")exportclassUserController{@Get(":id")asyncgetUser(@Param("id")id:string){returnthis.userService.findById(id);}}// Developer brain:
"I should make a base controller for all resources!"@Controller()exportabstractclassBaseResourceController<T,CreateDto,UpdateDto>{constructor(protectedservice:BaseService<T>){}@Get(":id")asyncget(@Param("id")id:string):Promise<T>{returnthis.service.findById(id);}@Post()asynccreate(@Body()dto:CreateDto):Promise<T>{returnthis.service.create(dto);}@Put(":id")asyncupdate(@Param("id")id:string,@Body()dto:UpdateDto):Promise<T>{returnthis.service.update(id,dto);}@Delete(":id")asyncdelete(@Param("id")id:string):Promise<void>{returnthis.service.delete(id);}}// Now every controller that doesn't fit this pattern is a special case// Users need password reset endpoint// Products need image upload// Orders need status transitions// Everything is fighting the abstraction

// Write the first one@Controller("users")exportclassUserController{// Full implementation}// Write the second one@Controller("products")exportclassProductController{// Copy-paste, modify as needed}// On the third one, IF there's a clear pattern:// Extract only the truly common parts

// You're literally switching from Stripe to PayPal next quarterexportinterfacePaymentProvider{charge(amount:number):Promise<string>;}// This abstraction will save your ass

// You have all of these in production RIGHT NOWexportinterfaceStorageProvider{upload(file:Buffer):Promise<string>;}@Injectable()exportclassS3StorageimplementsStorageProvider{// Used for production files}@Injectable()exportclassLocalStorageimplementsStorageProvider{// Used in development}@Injectable()exportclassCloudinaryStorageimplementsStorageProvider{// Used for images}

// Makes mocking way easierexportinterfaceTimeProvider{now():Date;}// Test with frozen time, run in prod with real time

// Được thiết kế cho các tiện ích mở rộng bên thứ baexportinterfaceWebhookHandler{handle(payload:unknown):Promise<void>;supports(event:string):boolean;}// Nhà phát triển có thể thêm Slack, Discord, các trình xử lý tùy chỉnh

// 6 files, 300 linesexportinterfaceIUserValidator{}exportclassUserValidationStrategy{}exportclassUserValidationFactory{}exportclassUserValidationOrchestrator{}// ...

// 1 file, 20 lines@Injectable()exportclassUserService{asynccreate(dto:CreateUserDto):Promise<User>{if(!dto.email.includes("@")){thrownewBadRequestException("Invalid email");}returnthis.userRepository.save(dto);}}