Commit @67d58df61ead1812f955514f4cca4f20f7ed34e7

임동욱 08-21

fix: 가맹점에서 백엔드에 없는 항목을 화면에 되돌린다

기획 시안과 틀어져 지우면 안 되는 항목이었다(사용자 확정). 브랜드명·메모·등록일·
최종수정일을 목록·팝업·엑셀에 되살리고, 값이 없을 때 '-'가 나오게 한다.

등록 시 브랜드명·메모도 함께 보낸다 — 요청 VO에 없어 지금은 버려지지만 컬럼이
생기면 프론트 수정 없이 저장된다.

Co-Authored-By: Claude Opus 5

@67d58df61ead1812f955514f4cca4f20f7ed34e7

48276ee

67d58df

app/(protected)/(basic)/system/merchants/_actions.ts

--- app/(protected)/(basic)/system/merchants/_actions.ts

+++ app/(protected)/(basic)/system/merchants/_actions.ts


 
   const validation = validateMerchant({
     id: readString(formData, 'id'),
+    brandName: readString(formData, 'brandName'),
+    memo: readString(formData, 'memo'),
     name: readString(formData, 'name'),
     categoryCode: readString(formData, 'categoryCode'),
     businessNumber: readString(formData, 'businessNumber'),

48276ee

67d58df

app/(protected)/(basic)/system/merchants/_components/merchant-list.tsx

--- app/(protected)/(basic)/system/merchants/_components/merchant-list.tsx

+++ app/(protected)/(basic)/system/merchants/_components/merchant-list.tsx


       render: (_row, index) => (currentPage - 1) * query.pageSize + index + 1,
     },
     { key: 'code', header: '가맹점코드', width: 140 },
+    {
+      key: 'brandName',
+      header: '브랜드명',
+      width: 120,
+      render: (row) => formatOptionalValue(row.brandName),
+    },
     { key: 'name', header: '가맹점명', width: 240, emphasis: true },
     {
       key: 'categoryCode',

       ),
     },
     {
+      key: 'createdAt',
+      header: '등록일',
+      width: 140,
+      render: (row) => formatOptionalValue(row.createdAt),
+    },
+    {
       key: 'actions',
       header: '관리',
       width: 120,

48276ee

67d58df

app/(protected)/(basic)/system/merchants/excel/route.ts

--- app/(protected)/(basic)/system/merchants/excel/route.ts

+++ app/(protected)/(basic)/system/merchants/excel/route.ts


 const HEADERS = [
   '번호',
   '가맹점코드',
+  '브랜드명',
   '가맹점명',
   '업종',
   '사업자등록번호',

   '상세주소',
   '우편번호',
   '사용여부',
+  '메모',
+  '등록일',
 ];
 
 /** 쉼표·따옴표·줄바꿈이 든 값은 따옴표로 감싸고 내부 따옴표는 두 번 쓴다(RFC 4180). */

     [
       String(index + 1),
       merchant.code,
+      merchant.brandName,
       merchant.name,
       formatCategoryLabel(merchant.categoryCode),
       merchant.businessNumber,

       merchant.addressDetail,
       merchant.postalCode,
       formatVisibilityLabel(merchant.isVisible),
+      merchant.memo,
+      merchant.createdAt,
     ]
       .map(toCsvCell)
       .join(',')

48276ee

67d58df

lib/data/repositories/merchant-repository.ts

--- lib/data/repositories/merchant-repository.ts

+++ lib/data/repositories/merchant-repository.ts


  *    뒤집어 오래된 가맹점부터 나온다.
  * 5. `USE_YN`을 select하지 않는다 — 검색 조건에는 쓰면서 응답에는 없어 사용여부를 알 수 없다.
  *    화면은 노출로 보인다.
- * 6. 브랜드명·메모·등록일 컬럼이 없다 — 기획에 있으나 담을 자리가 없어 화면에서 뺐다.
+ * 6. 브랜드명·메모·등록일·최종수정일 컬럼이 없다 — 기획에 있는 항목이라 화면은 그대로 두고
+ *    값만 비워 `-`로 보인다. 등록 시 보내는 브랜드명·메모도 요청 VO에 없어 버려진다.
  */
 
 const VOC_PATH = '/api/v1/mngr/voc';

     {
       id: code,
       code,
+      // 백엔드에 컬럼이 없다(⚠️ 6) — 응답에 있으면 쓰고, 없으면 빈 값으로 두어 화면이 `-`를 낸다.
+      brandName: readString(raw, 'brandNm'),
+      memo: readString(raw, 'memo'),
+      createdAt: readString(raw, 'frstRegDtStr'),
+      updatedAt: readString(raw, 'lastMdfcnDtStr'),
       name: readString(raw, 'frcsNm'),
       categoryCode: readString(raw, MERCHANT_CATEGORY_READ_FIELD),
       businessNumber: readString(raw, 'brno'),

       lat: values.latitude,
       lng: values.longitude,
       useYn: values.isVisible ? 'Y' : 'N',
+      // 요청 VO에 없어 무시된다. 컬럼이 생기면 그대로 저장되도록 미리 싣는다.
+      brandNm: values.brandName,
+      memo: values.memo,
     },
     accessToken: accessToken ?? undefined,
     cache: 'no-store',

48276ee

67d58df

lib/domain/merchant-form.ts

--- lib/domain/merchant-form.ts

+++ lib/domain/merchant-form.ts


-// 이슈: 브랜드명·메모는 백엔드 TB_COM_VOUCHER에 컬럼이 없어 화면에서 뺐다(기획에는 있다).
 export const NAME_MAX_LENGTH = 100;
+export const BRAND_MAX_LENGTH = 100;
 export const OWNER_MAX_LENGTH = 50;
 export const ADDRESS_DETAIL_MAX_LENGTH = 200;
+export const MEMO_MAX_LENGTH = 500;
 
 export interface MerchantValues {
   id: string;
+  /** 백엔드에 컬럼이 없어 저장되지 않는다 — 기획 시안 유지를 위해 화면에는 남긴다. */
+  brandName: string;
+  memo: string;
   name: string;
   categoryCode: string;
   businessNumber: string;

     values: {
       ...values,
       name,
+      brandName: values.brandName.trim().slice(0, BRAND_MAX_LENGTH),
+      memo: values.memo.trim().slice(0, MEMO_MAX_LENGTH),
       ownerName: values.ownerName.trim().slice(0, OWNER_MAX_LENGTH),
       phoneNumber,
       businessNumber,

48276ee

67d58df

lib/domain/merchant.ts

--- lib/domain/merchant.ts

+++ lib/domain/merchant.ts


   id: string;
   /** `frcsNo` — 서버가 만든다. 수정 불가(기획 MCH_003_p ①). */
   code: string;
+  /**
+   * 아래 넷은 백엔드 `TB_COM_VOUCHER`에 컬럼이 없어 **항상 빈 값**이다. 기획 시안에 있는
+   * 항목이라 화면에서는 지우지 않고 값이 없을 때 `-`로 보여준다(사용자 확정).
+   */
+  brandName: string;
+  memo: string;
+  createdAt: string;
+  updatedAt: string;
   name: string;
   categoryCode: string;
   businessNumber: string;

Add a comment

Open 0
Closed 0

List

...	...	@@ -13,11 +13,14 @@
13	13	import { useFeedback } from '@/app/_hooks/use-feedback';
14	14	import {
15	15	MERCHANT_CATEGORY_OPTIONS,
	16	+ formatOptionalValue,
16	17	type Merchant,
17	18	} from '@/lib/domain/merchant';
18	19	import {
19	20	ADDRESS_DETAIL_MAX_LENGTH,
	21	+ BRAND_MAX_LENGTH,
20	22	INITIAL_MERCHANT_FORM_STATE,
	23	+ MEMO_MAX_LENGTH,
21	24	NAME_MAX_LENGTH,
22	25	OWNER_MAX_LENGTH,
23	26	} from '@/lib/domain/merchant-form';
...	...	@@ -114,6 +117,19 @@
114	117	/>
115	118	</div>
116	119	)}
	120	+
	121	+ {/* 브랜드명·메모·등록일은 백엔드에 컬럼이 없어 저장되지 않는다. 기획 시안에 있는
	122	+ 항목이라 화면에서는 지우지 않고, 값이 없으면 `-`로 보여준다(사용자 확정). */}
	123	+ <div className={styles.field}>
	124	+ <FoxInput
	125	+ size="md"
	126	+ name="brandName"
	127	+ label="브랜드명"
	128	+ defaultValue={merchant?.brandName ?? ''}
	129	+ placeholder="브랜드명을 입력하세요."
	130	+ maxLength={BRAND_MAX_LENGTH}
	131	+ />
	132	+ </div>
117	133
118	134	<div className={styles.field}>
119	135	<FoxInput
...	...	@@ -256,6 +272,39 @@
256	272	</FoxRadioGroup>
257	273	</div>
258	274
	275	+ <div className={styles.field}>
	276	+ <FoxInput
	277	+ size="md"
	278	+ name="memo"
	279	+ label="메모"
	280	+ defaultValue={merchant?.memo ?? ''}
	281	+ placeholder="관리자 메모 (사용자에게 노출되지 않음)"
	282	+ maxLength={MEMO_MAX_LENGTH}
	283	+ />
	284	+ </div>
	285	+
	286	+ {isEdit && (
	287	+ <div className={styles.field}>
	288	+ <FoxFormLabel as="span">등록일 / 최종수정일</FoxFormLabel>
	289	+ <div className={styles.pair}>
	290	+ <FoxInput
	291	+ size="md"
	292	+ aria-label="등록일"
	293	+ value={formatOptionalValue(merchant?.createdAt)}
	294	+ readOnly
	295	+ state="view"
	296	+ />
	297	+ <FoxInput
	298	+ size="md"
	299	+ aria-label="최종수정일"
	300	+ value={formatOptionalValue(merchant?.updatedAt)}
	301	+ readOnly
	302	+ state="view"
	303	+ />
	304	+ </div>
	305	+ </div>
	306	+ )}
	307	+
259	308	{state.status === 'error' && state.message && (
260	309	<FoxHelperText type="danger" message={state.message} />
261	310	)}

...	...	@@ -66,6 +66,12 @@
66	66	render: (_row, index) => (currentPage - 1) * query.pageSize + index + 1,
67	67	},
68	68	{ key: 'code', header: '가맹점코드', width: 140 },
	69	+ {
	70	+ key: 'brandName',
	71	+ header: '브랜드명',
	72	+ width: 120,
	73	+ render: (row) => formatOptionalValue(row.brandName),
	74	+ },
69	75	{ key: 'name', header: '가맹점명', width: 240, emphasis: true },
70	76	{
71	77	key: 'categoryCode',
...	...	@@ -97,6 +103,12 @@
97	103	),
98	104	},
99	105	{
	106	+ key: 'createdAt',
	107	+ header: '등록일',
	108	+ width: 140,
	109	+ render: (row) => formatOptionalValue(row.createdAt),
	110	+ },
	111	+ {
100	112	key: 'actions',
101	113	header: '관리',
102	114	width: 120,

...	...	@@ -27,7 +27,8 @@
27	27	* 뒤집어 오래된 가맹점부터 나온다.
28	28	* 5. `USE_YN`을 select하지 않는다 — 검색 조건에는 쓰면서 응답에는 없어 사용여부를 알 수 없다.
29	29	* 화면은 노출로 보인다.
30		- * 6. 브랜드명·메모·등록일 컬럼이 없다 — 기획에 있으나 담을 자리가 없어 화면에서 뺐다.
	30	+ * 6. 브랜드명·메모·등록일·최종수정일 컬럼이 없다 — 기획에 있는 항목이라 화면은 그대로 두고
	31	+ * 값만 비워 `-`로 보인다. 등록 시 보내는 브랜드명·메모도 요청 VO에 없어 버려진다.
31	32	*/
32	33
33	34	const VOC_PATH = '/api/v1/mngr/voc';
...	...	@@ -65,6 +66,11 @@
65	66	{
66	67	id: code,
67	68	code,
	69	+ // 백엔드에 컬럼이 없다(⚠️ 6) — 응답에 있으면 쓰고, 없으면 빈 값으로 두어 화면이 `-`를 낸다.
	70	+ brandName: readString(raw, 'brandNm'),
	71	+ memo: readString(raw, 'memo'),
	72	+ createdAt: readString(raw, 'frstRegDtStr'),
	73	+ updatedAt: readString(raw, 'lastMdfcnDtStr'),
68	74	name: readString(raw, 'frcsNm'),
69	75	categoryCode: readString(raw, MERCHANT_CATEGORY_READ_FIELD),
70	76	businessNumber: readString(raw, 'brno'),
...	...	@@ -167,6 +173,9 @@
167	173	lat: values.latitude,
168	174	lng: values.longitude,
169	175	useYn: values.isVisible ? 'Y' : 'N',
	176	+ // 요청 VO에 없어 무시된다. 컬럼이 생기면 그대로 저장되도록 미리 싣는다.
	177	+ brandNm: values.brandName,
	178	+ memo: values.memo,
170	179	},
171	180	accessToken: accessToken ?? undefined,
172	181	cache: 'no-store',

...	...	@@ -24,6 +24,8 @@
24	24
25	25	const validation = validateMerchant({
26	26	id: readString(formData, 'id'),
	27	+ brandName: readString(formData, 'brandName'),
	28	+ memo: readString(formData, 'memo'),
27	29	name: readString(formData, 'name'),
28	30	categoryCode: readString(formData, 'categoryCode'),
29	31	businessNumber: readString(formData, 'businessNumber'),

...	...	@@ -12,6 +12,7 @@
12	12	const HEADERS = [
13	13	'번호',
14	14	'가맹점코드',
	15	+ '브랜드명',
15	16	'가맹점명',
16	17	'업종',
17	18	'사업자등록번호',
...	...	@@ -21,6 +22,8 @@
21	22	'상세주소',
22	23	'우편번호',
23	24	'사용여부',
	25	+ '메모',
	26	+ '등록일',
24	27	];
25	28
26	29	/** 쉼표·따옴표·줄바꿈이 든 값은 따옴표로 감싸고 내부 따옴표는 두 번 쓴다(RFC 4180). */
...	...	@@ -37,6 +40,7 @@
37	40	[
38	41	String(index + 1),
39	42	merchant.code,
	43	+ merchant.brandName,
40	44	merchant.name,
41	45	formatCategoryLabel(merchant.categoryCode),
42	46	merchant.businessNumber,
...	...	@@ -46,6 +50,8 @@
46	50	merchant.addressDetail,
47	51	merchant.postalCode,
48	52	formatVisibilityLabel(merchant.isVisible),
	53	+ merchant.memo,
	54	+ merchant.createdAt,
49	55	]
50	56	.map(toCsvCell)
51	57	.join(',')

...	...	@@ -1,10 +1,14 @@
1		-// 이슈: 브랜드명·메모는 백엔드 TB_COM_VOUCHER에 컬럼이 없어 화면에서 뺐다(기획에는 있다).
2	1	export const NAME_MAX_LENGTH = 100;
	2	+export const BRAND_MAX_LENGTH = 100;
3	3	export const OWNER_MAX_LENGTH = 50;
4	4	export const ADDRESS_DETAIL_MAX_LENGTH = 200;
	5	+export const MEMO_MAX_LENGTH = 500;
5	6
6	7	export interface MerchantValues {
7	8	id: string;
	9	+ /** 백엔드에 컬럼이 없어 저장되지 않는다 — 기획 시안 유지를 위해 화면에는 남긴다. */
	10	+ brandName: string;
	11	+ memo: string;
8	12	name: string;
9	13	categoryCode: string;
10	14	businessNumber: string;
...	...	@@ -77,6 +81,8 @@
77	81	values: {
78	82	...values,
79	83	name,
	84	+ brandName: values.brandName.trim().slice(0, BRAND_MAX_LENGTH),
	85	+ memo: values.memo.trim().slice(0, MEMO_MAX_LENGTH),
80	86	ownerName: values.ownerName.trim().slice(0, OWNER_MAX_LENGTH),
81	87	phoneNumber,
82	88	businessNumber,

...	...	@@ -7,6 +7,14 @@
7	7	id: string;
8	8	/** `frcsNo` — 서버가 만든다. 수정 불가(기획 MCH_003_p ①). */
9	9	code: string;
	10	+ /**
	11	+ * 아래 넷은 백엔드 `TB_COM_VOUCHER`에 컬럼이 없어 항상 빈 값이다. 기획 시안에 있는
	12	+ * 항목이라 화면에서는 지우지 않고 값이 없을 때 `-`로 보여준다(사용자 확정).
	13	+ */
	14	+ brandName: string;
	15	+ memo: string;
	16	+ createdAt: string;
	17	+ updatedAt: string;
10	18	name: string;
11	19	categoryCode: string;
12	20	businessNumber: string;

Delete comment