Skip to content

๐Ÿ”Œ[API] ์ •์‚ฐ ๋ฆฌํฌํŠธ ๊ต์œก๋น„ ์•ˆ๋‚ด์— ์ž…๊ธˆ ๊ณ„์ขŒ ยท ์ธ์ • ํšŒ์ฐจ ์ถ”๊ฐ€ (#39) - #40

Merged
kkangmen merged 2 commits into
devfrom
api/39-report-invoice-account
Nov 16, 2026

Conversation

@chjpooh2002

@chjpooh2002 chjpooh2002 commented Nov 15, 2026 •

Copy link
Copy Markdown
Contributor

1. ๐Ÿ“– ๊ฐœ์š”

  • UT(T-13 โ†’ T-14 โ†’ T-15) ํ๋ฆ„ ์žฌํ˜„์„ ์œ„ํ•ด Hi-fi์™€ API๋ฅผ ๋Œ€์กฐํ•œ ๊ฒฐ๊ณผ, T-14 ๊ต์œก๋น„ ์•ˆ๋‚ด ์นด๋“œ์˜ ์ž…๊ธˆ ๊ณ„์ขŒ ์ค„(๊ตญ๋ฏผ ****1492 ํ•œ์„œ์œค)์„ ๊ทธ๋ฆด ํ•„๋“œ๊ฐ€ ์‘๋‹ต์— ์—†์–ด ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค. '์ธ์ • ํšŒ์ฐจ ร— ํšŒ๋‹น ๋‹จ๊ฐ€' ์ค„์— ์“ธ ์ธ์ • ํšŒ์ฐจ๋„ ํ•จ๊ป˜ ๋‚ด๋ ค์ค๋‹ˆ๋‹ค.

2. โœ… ๋ณ€๊ฒฝ ์‚ฌํ•ญ

  • API: GET /api/v1/reports/{reportId}/invoice ์‘๋‹ต ๋งจ ๋’ค์— recognizedCount, bankCode, bankName, accountLast4, accountHolder ์ถ”๊ฐ€
    • POST /api/v1/invoices/{invoiceId}/adjustments๋„ ๊ฐ™์€ ์‘๋‹ต DTO๋ฅผ ์จ์„œ ํ•จ๊ป˜ ์ถ”๊ฐ€๋จ
    • ๊ธฐ์กด ํ•„๋“œ ์ด๋ฆ„ ยท ์ˆœ์„œ๋Š” ๊ทธ๋Œ€๋กœ๋ผ ํ•˜์œ„ ํ˜ธํ™˜
  • ๊ฐ’์€ ๋ชจ๋‘ ์ฒญ๊ตฌ ์‹œ์  ์Šค๋ƒ…์ƒท(invoices ์ปฌ๋Ÿผ)์—์„œ ๊ฐ€์ ธ์˜ค๋ฉฐ, ์ „์ฒด ๊ณ„์ขŒ๋ฒˆํ˜ธ(accountNumber)๋Š” ๋‚ด๋ ค์ฃผ์ง€ ์•Š์Œ
  • recognizedCount๋Š” ์ •์‚ฐ ์—†์ด ๋งŒ๋“  ์„ ๋ถˆ ์ฒซ ์ฒญ๊ตฌ(FIRST)๋งŒ null. ์„ ๋ถˆ NEXT ์ฒญ๊ตฌ๋Š” ๋ฐฉ๊ธˆ ๋‹ซ์€ ์‚ฌ์ดํด์˜ ์ธ์ • ํšŒ์ฐจ
  • bankCode๋Š” ๊ธˆ์œต๊ฒฐ์ œ์› 3์ž๋ฆฌ, '๊ธฐํƒ€' ์€ํ–‰์ด๋ฉด null (์งง์€ ์ด๋ฆ„ ยท ๋กœ๊ณ ๋Š” ํ”„๋ก ํŠธ๊ฐ€ ์ฝ”๋“œ๋กœ ๋งคํ•‘)
  • ๋ฌธ์„œ: docs/api-spec.md ๊ต์œก๋น„ ์•ˆ๋‚ด ์กฐํšŒ ์‘๋‹ต ์˜ˆ์‹œ ยท ํ•„๋“œ ์„ค๋ช… ๊ฐฑ์‹ 
  • DB ๋ณ€๊ฒฝ ์—†์Œ

3. ๐Ÿงช ํ…Œ์ŠคํŠธ

  • ๋กœ์ปฌ์—์„œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์‹คํ–‰ ๋ฐ ๊ธฐ๋ณธ ํ”Œ๋กœ์šฐ ํ™•์ธ
  • ๋‹จ์œ„ ํ…Œ์ŠคํŠธ ์‹คํ–‰ (./gradlew test)
  • ์ถ”๊ฐ€๋กœ ์ˆ˜ํ–‰ํ•œ ํ…Œ์ŠคํŠธ๊ฐ€ ์žˆ๋‹ค๋ฉด ์•„๋ž˜์— ์ž‘์„ฑ

์ถ”๊ฐ€ ํ…Œ์ŠคํŠธ ๋‚ด์—ญ:

  • ./gradlew test --tests "com.sudam.domain.invoice.*" ํ†ต๊ณผ (invoice ๋„๋ฉ”์ธ ์ „์ฒด, ์‹คํŒจ 0)
  • ReportInvoiceResponseTest 3๊ฑด ์ถ”๊ฐ€: ๊ณ„์ขŒ ยท ์ธ์ • ํšŒ์ฐจ ์Šค๋ƒ…์ƒท ๋งคํ•‘ / ์„ ๋ถˆ ์ฒซ ์ฒญ๊ตฌ(FIRST) recognizedCount null / '๊ธฐํƒ€' ์€ํ–‰ bankCode null
  • ์ปจํŠธ๋กค๋Ÿฌ ์Šฌ๋ผ์ด์Šค ํ…Œ์ŠคํŠธ์— ์ƒˆ ํ•„๋“œ ์‘๋‹ต ๊ฒ€์ฆ, ์กฐํšŒ ์‘๋‹ต์— accountNumber๊ฐ€ ์—†์Œ์„ ๊ฒ€์ฆ
  • ์ „์ฒด ./gradlew test: 214๊ฐœ ํ†ต๊ณผ (SudamApplicationTests ํฌํ•จ, ๋กœ์ปฌ MySQL ยท Redis)
  • ๋กœ์ปฌ bootRun(์‹œ๋“œ ์ผฌ)์œผ๋กœ ์ˆ˜๋™ ํ™•์ธ
    • GET /invoices โ†’ T-15 Hi-fi์™€ ๊ฐ™์€ ํ•ฉ๊ณ„ ยท ์นด๋“œ
    • ๊น€์„œ์•„ ์˜ค๋Š˜ ์ˆ˜์—… ๊ธฐ๋ก(8/8) โ†’ ์ •์‚ฐ์œผ๋กœ ๋ฆฌํฌํŠธ ยท ์ฒญ๊ตฌ ์ƒ์„ฑ
    • GET /reports/{id}/invoice โ†’ INVOICE200_2, recognizedCount: 8, bankCode: "004", bankName, accountLast4, accountHolder ํฌํ•จ
    • POST /invoices/{id}/adjustments(375,000์›) โ†’ INVOICE200_3, amount 375000 ยท calculatedAmount 360000, ๊ณ„์ขŒ ํ•„๋“œ ํฌํ•จ. ์žฌ์กฐํšŒ์—๋„ ๋ฐ˜์˜
    • ์—†๋Š” ๋ฆฌํฌํŠธ โ†’ INVOICE404_1, ๋‘ ์‘๋‹ต ๋ชจ๋‘ accountNumber ์—†์Œ

4. ๐Ÿ”— ๊ด€๋ จ ์ด์Šˆ

5. ๐Ÿ“‚ ๋ณ€๊ฒฝ ํŒŒ์ผ/์˜ํ–ฅ ๋ฒ”์œ„

  • ์˜ํ–ฅ ๋„๋ฉ”์ธ(์˜ˆ: ํšŒ์›, ์ธ์ฆ, ์ฃผ๋ฌธ ๋“ฑ): ๊ต์œก๋น„(invoice)
  • ์ฃผ์š” ๋ณ€๊ฒฝ ํŒŒ์ผ:
    • com.sudam.domain.invoice.dto.response.ReportInvoiceResponse
    • docs/api-spec.md
    • src/test/java/com/sudam/domain/invoice/ (ReportInvoiceResponseTest, ReportInvoiceControllerTest, InvoiceAdjustmentControllerTest)

6. ๐Ÿ™‹ ๋ฆฌ๋ทฐ ์š”์ฒญ

  • ๊ณ„์ขŒ๋Š” ๋งˆ์Šคํ‚น์šฉ ๋ 4์ž๋ฆฌ๋งŒ ๋‚ด๋ ค์ฃผ๋Š” ๊ฒƒ์œผ๋กœ ์ถฉ๋ถ„ํ•œ์ง€
  • bankName์„ ์ €์žฅ๊ฐ’(์˜ˆ: ๊ตญ๋ฏผ์€ํ–‰) ๊ทธ๋Œ€๋กœ ๋‚ด๋ ค์ฃผ๊ณ  ํ™”๋ฉด์šฉ ์งง์€ ์ด๋ฆ„('๊ตญ๋ฏผ') ยท ๋กœ๊ณ ๋Š” ํ”„๋ก ํŠธ๊ฐ€ bankCode๋กœ ๋งคํ•‘ํ•˜๋Š” ๋ฐฉ์‹์ด ๊ดœ์ฐฎ์€์ง€ (UT ์ „์—๋Š” Bank enum ยท S3 ์—†์ด ์ง„ํ–‰)

7. โš ๏ธ ์ฃผ์˜ ์‚ฌํ•ญ / ๊ธฐํƒ€

  • .env ยท ์Šคํ‚ค๋งˆ ยท ์„ค์ • ๋ณ€๊ฒฝ ์—†์Œ
  • ๋…ธ์…˜ API ๋ช…์„ธ ๋‘ ํŽ˜์ด์ง€๋ฅผ ์ฝ”๋“œ์™€ ๊ฐ™๊ฒŒ ์ˆ˜์ • ์™„๋ฃŒ: ๊ต์œก๋น„ ์•ˆ๋‚ด ์กฐํšŒ(์„ฑ๊ณต ์ฝ”๋“œ INVOICE200_2, ์ƒˆ ํ•„๋“œ, ์—๋Ÿฌ ํ‘œ), ๊ต์œก๋น„ ์ˆ˜์ •(200 INVOICE200_3 ยท ๊ต์œก๋น„ ์•ˆ๋‚ด์™€ ๊ฐ™์€ ์‘๋‹ต ๊ตฌ์กฐ, ์—๋Ÿฌ 409_1/409_2/409_4)

@chjpooh2002 chjpooh2002 added the api API ์„ค๊ณ„ ๋ฐ ๊ตฌํ˜„ label Nov 15, 2026
@chjpooh2002 chjpooh2002 self-assigned this Nov 15, 2026
@chjpooh2002

Copy link
Copy Markdown
Contributor Author

@kkangmen ๋ฆฌ๋ทฐ ๋ถ€ํƒํ•ด~~

@kkangmen kkangmen left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

์˜ค์ผ€์ด~ ๊ณ ์ƒํ–ˆ์–ด!

@kkangmen
kkangmen merged commit 6c300f6 into dev Nov 16, 2026
1 check passed
@kkangmen
kkangmen deleted the api/39-report-invoice-account branch November 16, 2026 04:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

api API ์„ค๊ณ„ ๋ฐ ๊ตฌํ˜„

Projects

None yet

2 participants