Phân tích luồng sau chuyển — rsinoutward/html-preview — vòng 1

logic-reviewer viết dựa trên code đã implement (không phải thiết kế trong spec), đối chiếu với code cũ. Viết tắt: S = easyposbackend1:src/main/java/vn/softdreams/easypos/service/impl/RsInoutWardManagementServiceImpl.java; đường dẫn mới tính từ src/main/java/com/softdreams/easypos/warehouse/.

F-01 Kiểm, đọc phiếu, mẫu, separator, trả kết quả

• Điểm vào: cũ easyposbackend1:src/main/java/vn/softdreams/easypos/web/rest/RsInoutWardManagementResource.java:144-153 → mới presentation/web/rsinoutward/RsInoutwardQueryController.java:115-130
• Quy tắc: R-01, R-02, R-03, R-04, R-05, R-06, R-13, R-14

Sơ đồ luồng mới (theo code thực tế)

sequenceDiagram
    participant C as Client
    participant Ctl as RsInoutwardQueryController.getHtmlPreview
    participant S as RsInoutwardHtmlPreviewQueryService.getHtmlPreview (readOnly tx)
    participant U as CurrentUserPort
    participant D as RsInoutwardDetailRepository
    participant P as PrintTemplateRelationalAdapter
    participant K as CompanyConfigRelationalAdapter
    participant UP as UserProfileRelationalAdapter
    C->>Ctl: GET /api/page/rs-inoutward/html-preview/{id}
    Ctl->>S: getHtmlPreview(id) (try: RuntimeException → SystemException EXCEPTION_ERROR)
    S->>U: findCompanyId() (rỗng → COMPANY_NOT_EXISTS_CODE)
    S->>D: findHeader(id, comId) (rỗng → RS_INOUT_WARD_ID_NOT_FOUND)
    S->>D: findLines(id, comId)
    S->>P: findSelected(comId, 9) — SELECT TOP 1 content, page_size (rỗng → PRINT_TEMPLATE_NULL)
    S->>K: findSeparatorRawValue(comId) (≥2 dòng / value NULL → EXCEPTION_ERROR)
    S->>S: PrintSeparatorParser.parse | PrintSeparator.defaults()
    S->>U: findUserId()
    S->>UP: findFullName(userId) (không có → "")
    S->>S: RsInoutwardPrintDataBuilder.build (F-02)
    S->>S: PrintTemplateRenderer.render (F-03)
    S-->>Ctl: RsInoutwardHtmlPreviewResult(reviewContent, pageSize)
    Ctl-->>C: 200 BaseResponseDTO.ok(RsInoutwardPrintTemplateResponse, SUCCESS_LOAD_DATA)

Đối chiếu từng bước

Dữ liệu và side effect

Transaction, khoá, idempotency, tenant

• Ranh giới transaction: cũ @Transactional(readOnly = true) + @ReadQuery ở S:8127-8130 → mới @Transactional(readOnly = true) ở RsInoutwardHtmlPreviewQueryService.java:69; controller bọc lỗi ngoài proxy nên lỗi mở/commit cũng ra EXCEPTION_ERROR.
• Khoá / cập nhật nguyên tử: không có (chỉ đọc).
• Idempotency, thời điểm phát event: không có event.
• Lọc comId: header, dòng, print_template, config đều lọc theo comId trong token; ep_user lọc theo id user trong token (cũ theo username — không theo công ty ở cả hai).

Lệch so với luồng mới đã duyệt (spec mục 6)

không — thêm bước UserProfilePort/PrintSeparatorParser nằm trong "comId, phiếu + dòng, mẫu, separator, tên NV" của sơ đồ spec.

Dev cần chú ý khi review

F-02 Dựng dữ liệu in

• Điểm vào: cũ S:7775 buildPrintData → mới application/rsinoutward/RsInoutwardPrintDataBuilder.java:117 build
• Quy tắc: R-07, R-08

Sơ đồ luồng mới (theo code thực tế)

sequenceDiagram
    participant S as RsInoutwardHtmlPreviewQueryService
    participant B as RsInoutwardPrintDataBuilder
    participant L as LegacyAmount
    participant W as VietnameseNumberWords
    S->>B: new(employeeName, printTime=now(clock, Asia/Ho_Chi_Minh)).build(header, rows)
    B->>B: 50 key = null; gán đầu phiếu (orElse như Optional.ofNullable)
    B->>B: putParty (type 1 NCC, type 2 KH ?: NCC, khác "")
    B->>L: scaleOrZero(amount / discountAmount / quantity)
    B->>B: putLines: sort ổn định theo position (>1 dòng), bỏ dòng rỗng
    B->>L: scaleOrZero, vatAmount cho từng dòng
    B->>W: toWords(total) (IOOBE → "")
    B-->>S: Map tên thuộc tính → giá trị

Đối chiếu từng bước

Dữ liệu và side effect

Transaction, khoá, idempotency, tenant

• Ranh giới transaction: trong transaction readOnly của F-01 ở cả hai.
• Khoá / cập nhật nguyên tử: không.
• Idempotency, thời điểm phát event: không.
• Lọc comId: không truy vấn.

Lệch so với luồng mới đã duyệt (spec mục 6)

không

Dev cần chú ý khi review

F-03 Thay biến mẫu

• Điểm vào: cũ S:7961 updateContentForRs → mới domain/rsinoutward/model/PrintTemplateRenderer.java:45 render
• Quy tắc: R-09, R-10, R-11, R-12

Sơ đồ luồng mới (theo code thực tế)

sequenceDiagram
    participant S as RsInoutwardHtmlPreviewQueryService
    participant R as PrintTemplateRenderer
    participant V as PrintTemplateVariables
    participant T as PrintTableRenderer
    participant L as PrintTableLookup
    participant F as LegacyNumberFormat
    S->>R: render(content, data, separator)
    R->>V: defaults() (121 mục, parse 1 lần)
    loop mục không isTable
        R->>F: formatNumber (BigDecimal) / formatDate / String.valueOf
        R->>R: replaceOutsideRow = replaceAll("(?s)(?!<tr.*?)"+quote(var), value)
    end
    R->>T: render(html, data)
    loop billProducts, toppings, surcharges
        T->>L: findRowTemplate(probe, html), tableList(data, table)
        alt không phải List
            T->>T: xoá dòng mẫu nếu có
        else không có dòng mẫu
            T->>T: joinWithoutRowTemplate (", ")
        else danh sách rỗng
            T->>T: xoá dòng mẫu
        else
            T->>T: expandRows (stt, quantity strip, #,##0)
        end
    end
    R-->>S: reviewContent

Đối chiếu từng bước

Dữ liệu và side effect

Transaction, khoá, idempotency, tenant

• Ranh giới transaction: trong transaction readOnly của F-01 ở cả hai.
• Khoá / cập nhật nguyên tử: không.
• Idempotency, thời điểm phát event: không.
• Lọc comId: không truy vấn.

Lệch so với luồng mới đã duyệt (spec mục 6)

không

Dev cần chú ý khi review