Compare commits
369
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
a87f887635 | ||
|
|
153f3b7fa7 | ||
|
|
aa213ceead | ||
|
|
50bc502251 | ||
|
|
f952f8c262 | ||
|
|
44edac8fbb | ||
|
|
0e8e646547 | ||
|
|
21dab0ef1f | ||
|
|
da8f66fca1 | ||
|
|
31ee840072 | ||
|
|
e3d022fcd7 | ||
|
|
09d4750a67 | ||
|
|
8ab63870d4 | ||
|
|
d3434060ba | ||
|
|
28bd0cbbf0 | ||
|
|
df4208d4e1 | ||
|
|
ad13875ce8 | ||
|
|
9673ee0ed2 | ||
|
|
d864cf73b9 | ||
|
|
9dec42a584 | ||
|
|
9e7dea7e9f | ||
|
|
6938c1e96f | ||
|
|
0ef375310f | ||
|
|
24c446b880 | ||
|
|
ab3c4e77ee | ||
|
|
3c0a16ea67 | ||
|
|
a6da87837a | ||
|
|
21533c8c0e | ||
|
|
3f75d2751a | ||
|
|
c5a5b3bde3 | ||
|
|
1e3a2fea8d | ||
|
|
a4e73284ed | ||
|
|
c94d9019d3 | ||
|
|
86566c7692 | ||
|
|
51204e2ec1 | ||
|
|
25affc06b9 | ||
|
|
b0dbd78410 | ||
|
|
ea9bd64088 | ||
|
|
758d5e7fac | ||
|
|
658a20f587 | ||
|
|
91116ccdf7 | ||
|
|
2bcc49e090 | ||
|
|
c013759869 | ||
|
|
bdbba42616 | ||
|
|
a84b233435 | ||
|
|
4340a57180 | ||
|
|
20aa1b37d0 | ||
|
|
87b5a5739a | ||
|
|
de4c2d6dbd | ||
|
|
49e31134b6 | ||
|
|
9c5c533db8 | ||
|
|
25320d43c4 | ||
|
|
f75fd342a3 | ||
|
|
1cde3b0998 | ||
|
|
c1cab1455f | ||
|
|
c04e754345 | ||
|
|
cec0701087 | ||
|
|
c121698713 | ||
|
|
1cc6b4b565 | ||
|
|
4a6cfed9bb | ||
|
|
dd2ab3cbfd | ||
|
|
5214819a1b | ||
|
|
d0babd838b | ||
|
|
f94b18a64d | ||
|
|
9604e4591b | ||
|
|
31b885a497 | ||
|
|
cc24a16c77 | ||
|
|
0b441494ba | ||
|
|
afabf9b79a | ||
|
|
0e067bb5fc | ||
|
|
26b98717f5 | ||
|
|
202fbc0c6b | ||
|
|
016b074c84 | ||
|
|
715dec5fe5 | ||
|
|
dc6f50dae9 | ||
|
|
8d8b010717 | ||
|
|
49026af708 | ||
|
|
b58b1f91c8 | ||
|
|
4928778b02 | ||
|
|
39a0b4b5d1 | ||
|
|
d07c5fab1a | ||
|
|
c35017d05c | ||
|
|
0fd2466f67 | ||
|
|
446bd83210 | ||
|
|
e8b851e75a | ||
|
|
435fa3b7c1 | ||
|
|
b0a35d6832 | ||
|
|
09c9bee457 | ||
|
|
f98348173e | ||
|
|
b8a1dad2b7 | ||
|
|
94130bdec2 | ||
|
|
21048e5acb | ||
|
|
8c180c0116 | ||
|
|
a24bb15990 | ||
|
|
262a443fec | ||
|
|
bc4d200021 | ||
|
|
4189fae701 | ||
|
|
28a16ffff8 | ||
|
|
61f433e899 | ||
|
|
675a16a294 | ||
|
|
e10ebf4219 | ||
|
|
679ea8a6b4 | ||
|
|
291b4a3a0a | ||
|
|
18b552f491 | ||
|
|
62494eba30 | ||
|
|
edc2fd5720 | ||
|
|
addd4579e8 | ||
|
|
9b8d48d395 | ||
|
|
bd1e1e3d1f | ||
|
|
02655510bd | ||
|
|
b12b76da3b | ||
|
|
0be504f3fa | ||
|
|
083bda1752 | ||
|
|
4a38adb20e | ||
|
|
83e6db06b1 | ||
|
|
cdc3542ff9 | ||
|
|
f344ff50d7 | ||
|
|
7dbaf755b3 | ||
|
|
b38dfd261b | ||
|
|
9fff1f2f25 | ||
|
|
3c8ef48ee5 | ||
|
|
1bfd1cfe46 | ||
|
|
9898251563 | ||
|
|
852fe5375b | ||
|
|
e41c9975af | ||
|
|
b6d7e47aeb | ||
|
|
f2e68af1b3 | ||
|
|
aed61e464d | ||
|
|
0bb2b4d052 | ||
|
|
9ac72c111b | ||
|
|
0b11a50765 | ||
|
|
638c99ac90 | ||
|
|
2d044750ae | ||
|
|
5f04e775b4 | ||
|
|
4d23e07be0 | ||
|
|
c2f8bd5a83 | ||
|
|
920922e21b | ||
|
|
c66a0be0ea | ||
|
|
74f14dec37 | ||
|
|
2e3998976a | ||
|
|
2fcd735d18 | ||
|
|
0b300a2f0e | ||
|
|
c06c97bdd5 | ||
|
|
a5e50c0db7 | ||
|
|
8daaec291d | ||
|
|
a644e80191 | ||
|
|
3302f7e8e0 | ||
|
|
ef3c32045b | ||
|
|
31ce13397e | ||
|
|
ab170a2b92 | ||
|
|
935c51562f | ||
|
|
718fc9fca3 | ||
|
|
a0a523f9bf | ||
|
|
9f9c6f30cb | ||
|
|
52d41166be | ||
|
|
29f6b7f765 | ||
|
|
d1885c1589 | ||
|
|
2a4d159aef | ||
|
|
4a57b363eb | ||
|
|
1b8c6f7586 | ||
|
|
33d8447851 | ||
|
|
262c386e2e | ||
|
|
260c1105e2 | ||
|
|
5515a98749 | ||
|
|
d81952810f | ||
|
|
2cbe84d874 | ||
|
|
d015432fc6 | ||
|
|
9b4d373f7d | ||
|
|
3637d09d03 | ||
|
|
109c5b14e6 | ||
|
|
7baf877528 | ||
|
|
062e26c6d9 | ||
|
|
9ad2f3944a | ||
|
|
7e241f964c | ||
|
|
6d5ebdc739 | ||
|
|
5f56e9a207 | ||
|
|
871e488216 | ||
|
|
216cec8cc7 | ||
|
|
de1d6f9e43 | ||
|
|
54f834ceff | ||
|
|
2f7f128a48 | ||
|
|
aca72fa4e0 | ||
|
|
f2aaf9696e | ||
|
|
d6d2900142 | ||
|
|
4cd2aee92e | ||
|
|
9fc2fc8942 | ||
|
|
3f63cc915b | ||
|
|
3b170b0992 | ||
|
|
73e1499583 | ||
|
|
697ce8a7c0 | ||
|
|
5cef8dc664 | ||
|
|
d6a049758e | ||
|
|
f21e902edd | ||
|
|
d98003b3ec | ||
|
|
54bd38ae5f | ||
|
|
c6575a8182 | ||
|
|
78defdd050 | ||
|
|
47b582c5cc | ||
|
|
4644c0ba3a | ||
|
|
945d182651 | ||
|
|
5dae10af6f | ||
|
|
3293893b7f | ||
|
|
8689b0a8a6 | ||
|
|
0b7a264f06 | ||
|
|
06131c8821 | ||
|
|
a72e4ae4bd | ||
|
|
af5bbbd56e | ||
|
|
d462c50684 | ||
|
|
e0a6410c37 | ||
|
|
9d573e6ad1 | ||
|
|
3da3b88d05 | ||
|
|
f507afdfe9 | ||
|
|
86467ada6d | ||
|
|
c36e3946bb | ||
|
|
c7a6509221 | ||
|
|
10eb78fc6c | ||
|
|
1715c8c88b | ||
|
|
0bb227d147 | ||
|
|
2e858dc901 | ||
|
|
91263b77dd | ||
|
|
983075e4d0 | ||
|
|
84beab1f4e | ||
|
|
6cb654a4b5 | ||
|
|
a5e50fc576 | ||
|
|
9c7e71e65a | ||
|
|
d0a808882d | ||
|
|
67b3d978a4 | ||
|
|
e30d62b429 | ||
|
|
663fc7cdc8 | ||
|
|
8f9469e8ae | ||
|
|
34a0324124 | ||
|
|
e8de6d66f8 | ||
|
|
79cf19d023 | ||
|
|
1f1c5bd603 | ||
|
|
237ec3bc88 | ||
|
|
9cf9081efc | ||
|
|
723cb3139a | ||
|
|
c9a73889f1 | ||
|
|
16c8fe716d | ||
|
|
dbcbd5f8b2 | ||
|
|
c950652f34 | ||
|
|
1d3272f836 | ||
|
|
8dd2bf6eb4 | ||
|
|
b5bcdb168f | ||
|
|
1120112fa8 | ||
|
|
3d2dcb4ead | ||
|
|
f88b4dfc7e | ||
|
|
75eaaa81ac | ||
|
|
c164b02081 | ||
|
|
c7a05cc77d | ||
|
|
f10157c178 | ||
|
|
3641a21fc5 | ||
|
|
24f377e048 | ||
|
|
4a26dae6b4 | ||
|
|
2ced8d9b5c | ||
|
|
b1beff9ef0 | ||
|
|
5376757f0f | ||
|
|
cf6df58e7a | ||
|
|
0075c720dc | ||
|
|
3bfbc698fe | ||
|
|
4805f8ebe3 | ||
|
|
8b11f65d8f | ||
|
|
a5092087db | ||
|
|
10d8658dc7 | ||
|
|
5f954c0a9d | ||
|
|
6f3f431761 | ||
|
|
44431a7905 | ||
|
|
3141777447 | ||
|
|
11b0070fe1 | ||
|
|
0e81ed1c07 | ||
|
|
4dacfdaadc | ||
|
|
89891c6bda | ||
|
|
2fddc9194c | ||
|
|
812293b4fa | ||
|
|
e3cd2592a4 | ||
|
|
041694e161 | ||
|
|
97ae53ad5d | ||
|
|
b56a291512 | ||
|
|
d54399a2d0 | ||
|
|
0e57bbc4e8 | ||
|
|
0411b2a894 | ||
|
|
2040984be9 | ||
|
|
ea5db79bb6 | ||
|
|
7359f19e7d | ||
|
|
a2b0469275 | ||
|
|
6a3124ed60 | ||
|
|
f9b3b367fc | ||
|
|
1279efbd75 | ||
|
|
13219b7d4e | ||
|
|
77dc0905b6 | ||
|
|
5a59b3f0eb | ||
|
|
68f77151bf | ||
|
|
43fe3a1a99 | ||
|
|
4d778af385 | ||
|
|
5777f000d4 | ||
|
|
9d18ef7527 | ||
|
|
2de065ceb0 | ||
|
|
a1f02d3717 | ||
|
|
6f0f03f83b | ||
|
|
d976e5fdfa | ||
|
|
207268b7fc | ||
|
|
c5df40a9ef | ||
|
|
8965a62d94 | ||
|
|
8ae9cfe050 | ||
|
|
1d4329e058 | ||
|
|
85304447b2 | ||
|
|
dcdee0f758 | ||
|
|
5cbe57aa8d | ||
|
|
6dc42ae4b1 | ||
|
|
5e0d1b8b63 | ||
|
|
6422b3013a | ||
|
|
7bf86e8619 | ||
|
|
36b4393134 | ||
|
|
ed5971aed7 | ||
|
|
ee65714d01 | ||
|
|
d817292955 | ||
|
|
6ea99e47d8 | ||
|
|
07e842ecb2 | ||
|
|
c6838839e6 | ||
|
|
e808e79391 | ||
|
|
9bbc3f521b | ||
|
|
f73901c78c | ||
|
|
6c17c12384 | ||
|
|
68f2aec5f1 | ||
|
|
b42d518ecf | ||
|
|
cb8cc460f9 | ||
|
|
bc577e488f | ||
|
|
51b1daf083 | ||
|
|
f7c7305ba0 | ||
|
|
dd5ff0f7f8 | ||
|
|
bd85a3c3aa | ||
|
|
ff0eeb2e40 | ||
|
|
c9378a0048 | ||
|
|
bf95161243 | ||
|
|
bd31f9c6f8 | ||
|
|
c111aaa54f | ||
|
|
09de176d16 | ||
|
|
e130e92376 | ||
|
|
1489fdc664 | ||
|
|
046b2c0553 | ||
|
|
0e5ec20c58 | ||
|
|
1c60f0f51b | ||
|
|
4c4c031e03 | ||
|
|
a606afef2f | ||
|
|
2f7d860b89 | ||
|
|
011a68e5f2 | ||
|
|
86d899d708 | ||
|
|
4dce22a30f | ||
|
|
c8391fe8eb | ||
|
|
c79c484c1b | ||
|
|
9c323e6b5d | ||
|
|
43fc4bbcb3 | ||
|
|
fdb3b23165 | ||
|
|
620f4275ae | ||
|
|
f769c508ad | ||
|
|
b7e343b24f | ||
|
|
bd53c17fec | ||
|
|
240311e540 | ||
|
|
f788a1ae08 | ||
|
|
98d53fb4bd | ||
|
|
43e59b869e | ||
|
|
717732aad3 | ||
|
|
b34d131c1a | ||
|
|
26d01a7032 | ||
|
|
6e7b3dd539 | ||
|
|
947751431e | ||
|
|
355e0ef1e4 | ||
|
|
c9b2ef35b7 | ||
|
|
8491d0243a |
@@ -0,0 +1,33 @@
|
|||||||
|
name: Deploy Frontend
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches:
|
||||||
|
- deploy
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
deploy:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v3
|
||||||
|
|
||||||
|
- name: Setup SSH
|
||||||
|
run: |
|
||||||
|
mkdir -p ~/.ssh
|
||||||
|
echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/deploy_key
|
||||||
|
chmod 600 ~/.ssh/deploy_key
|
||||||
|
ssh-keyscan -p 28 -H 192.168.0.4 >> ~/.ssh/known_hosts
|
||||||
|
|
||||||
|
- name: Deploy
|
||||||
|
run: |
|
||||||
|
ssh -i ~/.ssh/deploy_key -p 28 onasys@192.168.0.4 << 'EOF'
|
||||||
|
cd ~/frontend
|
||||||
|
git restore .
|
||||||
|
git clean -fd
|
||||||
|
git pull origin deploy
|
||||||
|
pnpm install
|
||||||
|
pnpm turbo build
|
||||||
|
pm2 reload all
|
||||||
|
EOF
|
||||||
Vendored
+88
@@ -0,0 +1,88 @@
|
|||||||
|
{
|
||||||
|
// IntelliSense를 사용하여 가능한 특성에 대해 알아보세요.
|
||||||
|
// 기존 특성에 대한 설명을 보려면 가리킵니다.
|
||||||
|
// 자세한 내용을 보려면 https://go.microsoft.com/fwlink/?linkid=830387을(를) 방문하세요.
|
||||||
|
"version": "0.2.0",
|
||||||
|
"configurations": [
|
||||||
|
{
|
||||||
|
"type": "node",
|
||||||
|
"request": "launch",
|
||||||
|
"name": "dev:as 디버그",
|
||||||
|
"runtimeExecutable": "pnpm",
|
||||||
|
"runtimeArgs": [
|
||||||
|
"run",
|
||||||
|
"dev:as"
|
||||||
|
],
|
||||||
|
"skipFiles": [
|
||||||
|
"<node_internals>/**"
|
||||||
|
],
|
||||||
|
"cwd": "${workspaceFolder}",
|
||||||
|
"console": "integratedTerminal",
|
||||||
|
"sourceMaps": true,
|
||||||
|
"env": {
|
||||||
|
"NODE_OPTIONS": "--inspect"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "node",
|
||||||
|
"request": "launch",
|
||||||
|
"name": "dev:cs 디버그",
|
||||||
|
"runtimeExecutable": "pnpm",
|
||||||
|
"runtimeArgs": [
|
||||||
|
"run",
|
||||||
|
"dev:cs"
|
||||||
|
],
|
||||||
|
"skipFiles": [
|
||||||
|
"<node_internals>/**"
|
||||||
|
],
|
||||||
|
"cwd": "${workspaceFolder}",
|
||||||
|
"console": "integratedTerminal",
|
||||||
|
"sourceMaps": true,
|
||||||
|
"env": {
|
||||||
|
"NODE_OPTIONS": "--inspect"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "node",
|
||||||
|
"request": "attach",
|
||||||
|
"name": "dev:cs 서버 연결 (attach)",
|
||||||
|
"port": 9229,
|
||||||
|
"restart": true,
|
||||||
|
"skipFiles": [
|
||||||
|
"<node_internals>/**"
|
||||||
|
],
|
||||||
|
"sourceMaps": true,
|
||||||
|
"resolveSourceMapLocations": [
|
||||||
|
"${workspaceFolder}/apps/cs/**",
|
||||||
|
"!**/node_modules/**"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "chrome",
|
||||||
|
"request": "launch",
|
||||||
|
"name": "dev:cs 클라이언트 디버그 (Chrome)",
|
||||||
|
"url": "http://localhost:3000",
|
||||||
|
"webRoot": "${workspaceFolder}/apps/cs",
|
||||||
|
"sourceMaps": true
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "node",
|
||||||
|
"request": "launch",
|
||||||
|
"name": "dev:st 디버그",
|
||||||
|
"runtimeExecutable": "pnpm",
|
||||||
|
"runtimeArgs": [
|
||||||
|
"run",
|
||||||
|
"dev:st"
|
||||||
|
],
|
||||||
|
"skipFiles": [
|
||||||
|
"<node_internals>/**"
|
||||||
|
],
|
||||||
|
"cwd": "${workspaceFolder}",
|
||||||
|
"console": "integratedTerminal",
|
||||||
|
"sourceMaps": true,
|
||||||
|
"env": {
|
||||||
|
"NODE_OPTIONS": "--inspect"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
Vendored
+5
@@ -0,0 +1,5 @@
|
|||||||
|
{
|
||||||
|
"chat.tools.terminal.autoApprove": {
|
||||||
|
"pnpm": true
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,8 +1,8 @@
|
|||||||
# apps/as/shared/config/env.ts 참고
|
# src/shared/config/env.ts 참고
|
||||||
NEXT_PUBLIC_PORT=
|
NEXT_PUBLIC_PORT=
|
||||||
NEXT_PUBLIC_PROXY_HOST=
|
NEXT_PUBLIC_PROXY_HOST=
|
||||||
NEXT_PUBLIC_SITE_ID=
|
NEXT_PUBLIC_SITE_ID=
|
||||||
NEXT_PUBLIC_SERVER_API_URL=
|
SERVER_API_URL=
|
||||||
|
|
||||||
# 401 시 브라우저 리다이렉트 대상
|
# 401 시 브라우저 리다이렉트 대상
|
||||||
NEXT_PUBLIC_AUTH_LOGIN_REDIRECT_URL=/auth/login
|
NEXT_PUBLIC_AUTH_LOGIN_REDIRECT_URL=/auth/login
|
||||||
|
|||||||
+44
-105
@@ -1,4 +1,4 @@
|
|||||||
# AS Application
|
# Template Application
|
||||||
|
|
||||||
Next.js 애플리케이션 with FSD(Feature Sliced Design) 아키텍처
|
Next.js 애플리케이션 with FSD(Feature Sliced Design) 아키텍처
|
||||||
|
|
||||||
@@ -13,46 +13,40 @@ Next.js 애플리케이션 with FSD(Feature Sliced Design) 아키텍처
|
|||||||
- **HTTP 클라이언트**: Axios
|
- **HTTP 클라이언트**: Axios
|
||||||
- **날짜 처리**: Day.js
|
- **날짜 처리**: Day.js
|
||||||
|
|
||||||
## 프로젝트 구조 (FSD)
|
## 프로젝트 구조 (FSD + Next.js App Router)
|
||||||
|
|
||||||
이 프로젝트는 **Feature-Sliced Design v2.1**을 따르며, 계층적 아키텍처로 구성되어 있습니다.
|
이 프로젝트는 **Feature-Sliced Design v2.1**과 **FSD 공식 Next.js 가이드**에 맞춰 구성되어 있습니다. Next.js `app/`은 라우트만 담당하고, 실제 레이어는 `src/` 아래에 있습니다.
|
||||||
|
|
||||||
```
|
```
|
||||||
as/
|
_template/
|
||||||
├── app/ # App 레이어 (Next.js App Router)
|
├── app/ # Next.js App Router (루트) — 라우트·레이아웃 진입점만
|
||||||
│ ├── (routes)/ # 라우트 구조
|
│ ├── layout.tsx # 루트 레이아웃 (src/app에서 providers, styles import)
|
||||||
│ ├── layout.tsx # 루트 레이아웃
|
│ └── (with-base-layout)/
|
||||||
│ ├── page.tsx # 홈 페이지
|
│ ├── layout.tsx # BaseLayout 래퍼 (src/app/layouts에서 import)
|
||||||
│ ├── globals.css # 글로벌 스타일
|
│ └── page.tsx # re-export: export { MainPage as default } from '@/pages/home'
|
||||||
│ └── providers.tsx # 전역 providers
|
|
||||||
│
|
│
|
||||||
├── widgets/ # Widgets 레이어
|
├── pages/ # 빈 폴더 + README (Next.js가 src/pages를 Pages Router로 쓰지 않도록)
|
||||||
│ └── [widget-name]/ # 큰 독립적 UI 블록 (여러 페이지에서 재사용)
|
│ └── README.md
|
||||||
│ ├── ui/
|
|
||||||
│ ├── model/
|
|
||||||
│ └── index.ts
|
|
||||||
│
|
│
|
||||||
├── features/ # Features 레이어
|
└── src/ # FSD 레이어 (실제 코드)
|
||||||
│ └── [feature-name]/ # 사용자 상호작용 기능 (여러 페이지에서 재사용)
|
├── app/ # App 레이어 (슬라이스 없음, 세그먼트만)
|
||||||
│ ├── ui/
|
│ ├── providers/ # 전역 Providers (QueryClient 등)
|
||||||
│ ├── api/
|
│ ├── styles/ # 글로벌 스타일 (globals.css)
|
||||||
│ ├── model/
|
│ └── layouts/ # 공통 레이아웃 컴포넌트 (BaseLayoutWrapper)
|
||||||
│ └── index.ts
|
│
|
||||||
│
|
├── pages/ # Pages 레이어 (페이지 슬라이스)
|
||||||
├── entities/ # Entities 레이어
|
│ └── home/
|
||||||
│ └── [entity-name]/ # 비즈니스 엔티티 (User, Product 등)
|
│ ├── ui/
|
||||||
│ ├── model/
|
│ └── index.ts # Public API
|
||||||
│ ├── api/
|
│
|
||||||
│ ├── ui/
|
├── widgets/ # Widgets 레이어
|
||||||
│ └── index.ts
|
├── features/ # Features 레이어
|
||||||
│
|
├── entities/ # Entities 레이어
|
||||||
└── shared/ # Shared 레이어
|
└── shared/ # Shared 레이어
|
||||||
├── ui/ # UI Kit (비즈니스 로직 없는 공통 컴포넌트)
|
├── ui/
|
||||||
├── api/ # API 클라이언트 설정
|
├── api/
|
||||||
├── lib/ # 내부 라이브러리 (dates, colors 등)
|
├── lib/
|
||||||
├── config/ # 환경 설정, feature flags
|
└── config/
|
||||||
├── types/ # 공통 타입 정의
|
|
||||||
└── routes/ # 라우트 상수
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### 계층 구조 이해하기
|
### 계층 구조 이해하기
|
||||||
@@ -86,10 +80,10 @@ shared/ ↓ 가장 낮은 책임, 의존성 없음
|
|||||||
- **특징**: 슬라이스가 없고 세그먼트로만 구성
|
- **특징**: 슬라이스가 없고 세그먼트로만 구성
|
||||||
- **의존성**: 모든 하위 레이어 사용 가능
|
- **의존성**: 모든 하위 레이어 사용 가능
|
||||||
|
|
||||||
### 2. Pages (app 디렉토리)
|
### 2. Pages (src/pages)
|
||||||
- **목적**: 웹사이트나 애플리케이션을 구성하는 페이지/화면
|
- **목적**: 웹사이트나 애플리케이션을 구성하는 페이지/화면
|
||||||
- **내용**: 페이지 UI, 로딩 상태, 에러 바운더리, 데이터 fetching
|
- **내용**: 페이지 UI, 로딩 상태, 에러 바운더리, 데이터 fetching
|
||||||
- **특징**: 한 페이지당 한 슬라이스 (유사한 페이지는 그룹화 가능)
|
- **특징**: 한 페이지당 한 슬라이스 (유사한 페이지는 그룹화 가능). Next.js `app/`의 route 파일에서 re-export
|
||||||
- **의존성**: `widgets`, `features`, `entities`, `shared` 사용 가능
|
- **의존성**: `widgets`, `features`, `entities`, `shared` 사용 가능
|
||||||
|
|
||||||
> 💡 **FSD v2.1 권장사항**: "pages-first" 접근 방식을 따라, 재사용되지 않는 큰 UI 블록과 비즈니스 로직은 페이지 슬라이스에 유지하세요.
|
> 💡 **FSD v2.1 권장사항**: "pages-first" 접근 방식을 따라, 재사용되지 않는 큰 UI 블록과 비즈니스 로직은 페이지 슬라이스에 유지하세요.
|
||||||
@@ -118,29 +112,6 @@ shared/ ↓ 가장 낮은 책임, 의존성 없음
|
|||||||
- **특징**: 비즈니스 로직 없음, 슬라이스가 없고 세그먼트로만 구성
|
- **특징**: 비즈니스 로직 없음, 슬라이스가 없고 세그먼트로만 구성
|
||||||
- **의존성**: 외부 라이브러리만 사용 가능 (다른 레이어 불가)
|
- **의존성**: 외부 라이브러리만 사용 가능 (다른 레이어 불가)
|
||||||
|
|
||||||
## 레이어 간 Import 규칙
|
|
||||||
|
|
||||||
> **핵심 규칙**: 슬라이스 내의 모듈(파일)은 **오직 하위 레이어**에 있는 다른 슬라이스만 import할 수 있습니다.
|
|
||||||
|
|
||||||
예시:
|
|
||||||
- `features/auth-login/ui/form.tsx`는 `entities/user`와 `shared/ui`를 import 가능
|
|
||||||
- 하지만 다른 `features/post-create`나 상위 레이어인 `widgets`는 import 불가
|
|
||||||
- 같은 슬라이스 내부(`features/auth-login/`)의 다른 파일들은 자유롭게 import 가능
|
|
||||||
|
|
||||||
## Public API 규칙
|
|
||||||
|
|
||||||
> **슬라이스 외부의 모듈은 슬라이스의 Public API만 참조할 수 있으며, 내부 파일 구조에 직접 접근할 수 없습니다.**
|
|
||||||
|
|
||||||
모든 슬라이스(및 슬라이스가 없는 레이어의 세그먼트)는 반드시 `index.ts`를 통해 Public API를 정의해야 합니다.
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// ✅ 올바른 import
|
|
||||||
import { LoginForm } from 'features/auth-login';
|
|
||||||
|
|
||||||
// ❌ 잘못된 import (내부 구조 직접 접근)
|
|
||||||
import { LoginForm } from 'features/auth-login/ui/login-form';
|
|
||||||
```
|
|
||||||
|
|
||||||
## 시작하기
|
## 시작하기
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@@ -174,16 +145,16 @@ NEXT_PUBLIC_API_URL=http://localhost:3000/api
|
|||||||
```typescript
|
```typescript
|
||||||
// ✅ 올바른 import (하위 레이어)
|
// ✅ 올바른 import (하위 레이어)
|
||||||
// features/auth-login/ui/form.tsx
|
// features/auth-login/ui/form.tsx
|
||||||
import { User } from 'entities/user';
|
import { User } from "entities/user";
|
||||||
import { Button } from 'shared/ui/button';
|
import { Button } from "shared/ui/button";
|
||||||
|
|
||||||
// ❌ 잘못된 import (같은 레이어)
|
// ❌ 잘못된 import (같은 레이어)
|
||||||
// features/auth-login/ui/form.tsx
|
// features/auth-login/ui/form.tsx
|
||||||
import { PostForm } from 'features/post-create'; // 금지!
|
import { PostForm } from "features/post-create"; // 금지!
|
||||||
|
|
||||||
// ❌ 잘못된 import (상위 레이어)
|
// ❌ 잘못된 import (상위 레이어)
|
||||||
// features/auth-login/ui/form.tsx
|
// features/auth-login/ui/form.tsx
|
||||||
import { Header } from 'widgets/header'; // 금지!
|
import { Header } from "widgets/header"; // 금지!
|
||||||
```
|
```
|
||||||
|
|
||||||
### 2. Public API 규칙
|
### 2. Public API 규칙
|
||||||
@@ -192,10 +163,10 @@ import { Header } from 'widgets/header'; // 금지!
|
|||||||
|
|
||||||
```typescript
|
```typescript
|
||||||
// ✅ 올바른 import (Public API 사용)
|
// ✅ 올바른 import (Public API 사용)
|
||||||
import { LoginForm } from 'features/auth-login';
|
import { LoginForm } from "features/auth-login";
|
||||||
|
|
||||||
// ❌ 잘못된 import (내부 구조 직접 접근)
|
// ❌ 잘못된 import (내부 구조 직접 접근)
|
||||||
import { LoginForm } from 'features/auth-login/ui/login-form';
|
import { LoginForm } from "features/auth-login/ui/login-form";
|
||||||
```
|
```
|
||||||
|
|
||||||
**Public API 작성 시 주의사항**:
|
**Public API 작성 시 주의사항**:
|
||||||
@@ -205,44 +176,12 @@ import { LoginForm } from 'features/auth-login/ui/login-form';
|
|||||||
|
|
||||||
```typescript
|
```typescript
|
||||||
// ❌ 나쁜 예시
|
// ❌ 나쁜 예시
|
||||||
export * from './ui/Comment';
|
export * from "./ui/Comment";
|
||||||
export * from './model/comments';
|
export * from "./model/comments";
|
||||||
|
|
||||||
// ✅ 좋은 예시
|
// ✅ 좋은 예시
|
||||||
export { Comment } from './ui/comment';
|
export { Comment } from "./ui/comment";
|
||||||
export { CommentForm } from './ui/comment-form';
|
export { CommentForm } from "./ui/comment-form";
|
||||||
export { useComments } from './model/use-comments';
|
export { useComments } from "./model/use-comments";
|
||||||
export type { Comment, CommentFormData } from './model/types';
|
export type { Comment, CommentFormData } from "./model/types";
|
||||||
```
|
|
||||||
|
|
||||||
### 3. 슬라이스 독립성
|
|
||||||
|
|
||||||
- **Zero Coupling**: 같은 레이어의 슬라이스들은 서로 독립적이어야 합니다
|
|
||||||
- **High Cohesion**: 슬라이스는 주요 목표와 관련된 대부분의 코드를 포함해야 합니다
|
|
||||||
- 예외: Entities 레이어에서 필요한 경우 `@x` 표기법으로 cross-import 가능
|
|
||||||
|
|
||||||
### 4. 세그먼트 명명 규칙
|
|
||||||
|
|
||||||
세그먼트 이름은 **목적**을 설명해야 하며, **본질**을 설명하면 안 됩니다:
|
|
||||||
|
|
||||||
- ❌ **나쁜 이름**: `components`, `hooks`, `types` (무엇인지만 설명)
|
|
||||||
- ✅ **좋은 이름**: `ui`, `api`, `model`, `lib` (왜 있는지 설명)
|
|
||||||
|
|
||||||
## 코드 규칙
|
|
||||||
|
|
||||||
- TypeScript 사용 (strict mode)
|
|
||||||
- 함수형 컴포넌트 사용
|
|
||||||
- Named exports 선호
|
|
||||||
- Tailwind CSS 사용
|
|
||||||
- ESLint + Prettier 적용
|
|
||||||
- Public API는 명시적으로 정의 (와일드카드 export 지양)
|
|
||||||
|
|
||||||
## 아키텍처 린팅
|
|
||||||
|
|
||||||
코드베이스의 FSD 규칙 준수를 자동으로 검증하려면 [Steiger](https://github.com/feature-sliced/steiger)를 사용하세요.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Steiger 설치 및 실행
|
|
||||||
pnpm add -D @feature-sliced/steiger
|
|
||||||
npx steiger src
|
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -1,31 +1,10 @@
|
|||||||
"use client";
|
import type { ReactNode } from "react";
|
||||||
|
import { BaseLayoutWrapper } from "@/app/layouts/base-layout";
|
||||||
import { useCallback } from "react";
|
|
||||||
import { usePathname, useRouter } from "next/navigation";
|
interface WithBaseLayoutProps {
|
||||||
import { useQueryClient } from "@tanstack/react-query";
|
children: ReactNode;
|
||||||
import { BaseLayout } from "@common/components";
|
}
|
||||||
import type { MenuItem } from "@/entities/menu";
|
|
||||||
import { PageLayout } from "@/shared/ui/page-layout";
|
export default function WithBaseLayout({ children }: WithBaseLayoutProps) {
|
||||||
|
return <BaseLayoutWrapper>{children}</BaseLayoutWrapper>;
|
||||||
export default function WithBaseLayout({ children }: { children: React.ReactNode }) {
|
}
|
||||||
const router = useRouter();
|
|
||||||
const pathname = usePathname();
|
|
||||||
const queryClient = useQueryClient();
|
|
||||||
|
|
||||||
const handleMenuClick = useCallback(
|
|
||||||
(item: MenuItem) => {
|
|
||||||
router.push(item.urlPath);
|
|
||||||
},
|
|
||||||
[router],
|
|
||||||
);
|
|
||||||
|
|
||||||
return (
|
|
||||||
<BaseLayout
|
|
||||||
queryClient={queryClient}
|
|
||||||
currentPath={pathname ?? ""}
|
|
||||||
handleMenuClick={handleMenuClick}
|
|
||||||
>
|
|
||||||
<PageLayout>{children}</PageLayout>
|
|
||||||
</BaseLayout>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|||||||
@@ -1,9 +1 @@
|
|||||||
"use client";
|
export { MainPage as default } from "@/pages/home";
|
||||||
|
|
||||||
export default function MainPage() {
|
|
||||||
return (
|
|
||||||
<div className="flex h-full flex-col items-center justify-center py-10">
|
|
||||||
<h1 className="mb-4 text-3xl font-bold">Home</h1>
|
|
||||||
</div>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|||||||
@@ -1,14 +1,7 @@
|
|||||||
import type { Metadata } from "next";
|
import type { Metadata } from "next";
|
||||||
import { Noto_Sans_KR } from "next/font/google";
|
import { cookies } from "next/headers";
|
||||||
import { Providers } from "./providers";
|
import { Providers } from "@/app/providers";
|
||||||
import "./globals.css";
|
import "@/app/styles/globals.css";
|
||||||
|
|
||||||
const notoSansKR = Noto_Sans_KR({
|
|
||||||
subsets: ["latin"],
|
|
||||||
weight: ["100", "300", "400", "500", "700", "900"],
|
|
||||||
display: "swap",
|
|
||||||
variable: "--font-noto-sans-kr",
|
|
||||||
});
|
|
||||||
|
|
||||||
export const metadata: Metadata = {
|
export const metadata: Metadata = {
|
||||||
title: "행정지원시스템",
|
title: "행정지원시스템",
|
||||||
@@ -19,10 +12,12 @@ interface RootLayoutProps {
|
|||||||
children: React.ReactNode;
|
children: React.ReactNode;
|
||||||
}
|
}
|
||||||
|
|
||||||
export default function RootLayout({ children }: RootLayoutProps) {
|
export default async function RootLayout({ children }: RootLayoutProps) {
|
||||||
|
const theme = (await cookies()).get("site-theme-key");
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<html lang="ko" className={notoSansKR.variable}>
|
<html lang="ko" data-theme={theme?.value}>
|
||||||
<body className={`${notoSansKR.className} antialiased`}>
|
<body>
|
||||||
<Providers>{children}</Providers>
|
<Providers>{children}</Providers>
|
||||||
</body>
|
</body>
|
||||||
</html>
|
</html>
|
||||||
|
|||||||
@@ -0,0 +1,50 @@
|
|||||||
|
import { NextRequest, NextResponse } from "next/server";
|
||||||
|
import { PORT, PROXY_HOST, SERVER_API_URL, SITE_ID } from "@/shared/config";
|
||||||
|
|
||||||
|
const serverApiUrl = process.env.SERVER_API_URL ?? "http://localhost:3000";
|
||||||
|
|
||||||
|
// CSP 헤더 설정 함수 (img-src만)
|
||||||
|
function addSecurityHeaders(response: NextResponse): NextResponse {
|
||||||
|
response.headers.set("Content-Security-Policy", "img-src 'self' data: https: blob:;");
|
||||||
|
return response;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function middleware(req: NextRequest) {
|
||||||
|
const pathname = req.nextUrl.pathname;
|
||||||
|
const searchParams = req.nextUrl.searchParams;
|
||||||
|
|
||||||
|
const logMessages: string[] = [
|
||||||
|
`[Middleware Request] ${new Date().toISOString()}`,
|
||||||
|
`[Environment]\n Mode: ${process.env.NODE_ENV}\n Port: ${PORT}\n Proxy Host: ${PROXY_HOST}\n Server API URL: ${SERVER_API_URL}\n Site ID: ${SITE_ID}`,
|
||||||
|
`[Request]\n Original Pathname: ${pathname}`,
|
||||||
|
];
|
||||||
|
|
||||||
|
if (pathname.startsWith("/server")) {
|
||||||
|
const queryParams = searchParams.toString();
|
||||||
|
const newUrl = `${serverApiUrl}${pathname.replace("/server", "")}${
|
||||||
|
queryParams ? `?${queryParams}` : ""
|
||||||
|
}`;
|
||||||
|
|
||||||
|
logMessages.push(` Rewritten URL: ${newUrl}`);
|
||||||
|
logMessages.push("\n--------------------------------\n");
|
||||||
|
console.log(logMessages.join("\n"));
|
||||||
|
|
||||||
|
const response = NextResponse.rewrite(new URL(newUrl));
|
||||||
|
return addSecurityHeaders(response);
|
||||||
|
}
|
||||||
|
|
||||||
|
// if (pathname === "/") {
|
||||||
|
// const response = NextResponse.redirect(new URL("/dashboard", req.url));
|
||||||
|
// return addSecurityHeaders(response);
|
||||||
|
// }
|
||||||
|
|
||||||
|
logMessages.push("\n--------------------------------\n");
|
||||||
|
console.log(logMessages.join("\n"));
|
||||||
|
|
||||||
|
const response = NextResponse.next();
|
||||||
|
return addSecurityHeaders(response);
|
||||||
|
}
|
||||||
|
|
||||||
|
export const config = {
|
||||||
|
matcher: ["/server/:path*", "/"],
|
||||||
|
};
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
{
|
{
|
||||||
"name": "as",
|
"name": "template",
|
||||||
"version": "0.1.0",
|
"version": "0.1.0",
|
||||||
"private": true,
|
"private": true,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
|||||||
@@ -0,0 +1,9 @@
|
|||||||
|
# 이 폴더는 비워 둡니다 (FSD + Next.js App Router)
|
||||||
|
|
||||||
|
Next.js가 `src/pages`를 **Pages Router**용 `pages` 디렉터리로 인식하지 않도록,
|
||||||
|
프로젝트 루트에 **빈 `pages` 폴더**를 두는 것이 FSD 공식 가이드 권장사항입니다.
|
||||||
|
|
||||||
|
- 실제 페이지(FSD Pages 레이어)는 **`src/pages`**에 있습니다.
|
||||||
|
- Next.js 라우트는 **`app/`** 에서 `src/pages`를 re-export 하는 방식으로 연결됩니다.
|
||||||
|
|
||||||
|
[Feature-Sliced Design - Usage with Next.js (App Router)](https://feature-sliced.design/docs/guides/tech/with-nextjs)
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
export const PORT = process.env.NEXT_PUBLIC_PORT || "3000";
|
|
||||||
export const PROXY_HOST =
|
|
||||||
process.env.NEXT_PUBLIC_PROXY_HOST || `http://localhost:${PORT}`;
|
|
||||||
export const SERVER_API_URL = process.env.NEXT_PUBLIC_SERVER_API_URL;
|
|
||||||
export const SITE_ID = process.env.NEXT_PUBLIC_SITE_ID || "AS";
|
|
||||||
export const CLAIM_NAME = process.env.NEXT_PUBLIC_CLAIM_NAME || "Authorization";
|
|
||||||
export const ACCESS_TOKEN =
|
|
||||||
process.env.NEXT_PUBLIC_ACCESS_TOKEN || "access-token";
|
|
||||||
export const REFRESH_TOKEN =
|
|
||||||
process.env.NEXT_PUBLIC_REFRESH_TOKEN || "refresh-token";
|
|
||||||
export const AUTH_USER_ID = process.env.NEXT_PUBLIC_AUTH_USER_ID || "token-id";
|
|
||||||
@@ -0,0 +1,35 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useCallback } from "react";
|
||||||
|
import { usePathname, useRouter } from "next/navigation";
|
||||||
|
import { useQueryClient } from "@tanstack/react-query";
|
||||||
|
import { BaseLayout } from "@common/components";
|
||||||
|
import type { MenuItem } from "@/entities/menu";
|
||||||
|
import { PageLayout } from "@/shared/ui/page-layout";
|
||||||
|
|
||||||
|
interface BaseLayoutWrapperProps {
|
||||||
|
children: React.ReactNode;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function BaseLayoutWrapper({ children }: BaseLayoutWrapperProps) {
|
||||||
|
const router = useRouter();
|
||||||
|
const pathname = usePathname();
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
const handleMenuClick = useCallback(
|
||||||
|
(item: MenuItem) => {
|
||||||
|
router.push(item.urlPath);
|
||||||
|
},
|
||||||
|
[router],
|
||||||
|
);
|
||||||
|
|
||||||
|
return (
|
||||||
|
<BaseLayout
|
||||||
|
queryClient={queryClient}
|
||||||
|
currentPath={pathname ?? ""}
|
||||||
|
handleMenuClick={handleMenuClick}
|
||||||
|
>
|
||||||
|
<PageLayout>{children}</PageLayout>
|
||||||
|
</BaseLayout>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -1,18 +1,18 @@
|
|||||||
"use client";
|
"use client";
|
||||||
|
|
||||||
import { QueryClientProvider } from "@tanstack/react-query";
|
import { QueryClientProvider } from "@tanstack/react-query";
|
||||||
import { ReactQueryDevtools } from "@tanstack/react-query-devtools";
|
import { ReactQueryDevtools } from "@tanstack/react-query-devtools";
|
||||||
import { queryClient } from "@/shared/lib";
|
import { queryClient } from "@/shared/lib";
|
||||||
|
|
||||||
interface ProvidersProps {
|
interface ProvidersProps {
|
||||||
children: React.ReactNode;
|
children: React.ReactNode;
|
||||||
}
|
}
|
||||||
|
|
||||||
export function Providers({ children }: ProvidersProps) {
|
export function Providers({ children }: ProvidersProps) {
|
||||||
return (
|
return (
|
||||||
<QueryClientProvider client={queryClient}>
|
<QueryClientProvider client={queryClient}>
|
||||||
{children}
|
{children}
|
||||||
<ReactQueryDevtools initialIsOpen={false} />
|
<ReactQueryDevtools initialIsOpen={false} />
|
||||||
</QueryClientProvider>
|
</QueryClientProvider>
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
@@ -10,6 +10,6 @@ html,
|
|||||||
body {
|
body {
|
||||||
color: var(--foreground);
|
color: var(--foreground);
|
||||||
background: var(--background);
|
background: var(--background);
|
||||||
font-family: var(--font-noto-sans-kr), sans-serif;
|
font-family: "Noto Sans KR", sans-serif;
|
||||||
font-size: 10px;
|
font-size: 10px;
|
||||||
}
|
}
|
||||||
@@ -0,0 +1,133 @@
|
|||||||
|
# Features Layer
|
||||||
|
|
||||||
|
**Features**는 앱의 주요 사용자 상호작용과 기능을 구현하는 레이어입니다. 사용자가 실제로 수행하는 작업들로, 주로 비즈니스 엔티티와 관련이 있습니다.
|
||||||
|
|
||||||
|
## 목적
|
||||||
|
|
||||||
|
- 사용자가 중요하게 생각하는 주요 상호작용 구현
|
||||||
|
- 재사용 가능한 비즈니스 기능 제공
|
||||||
|
- 여러 페이지에서 사용되는 기능의 중복 제거
|
||||||
|
|
||||||
|
## Feature로 만들어야 하는 경우
|
||||||
|
|
||||||
|
> ⚠️ **중요**: 모든 것을 feature로 만들 필요는 없습니다.
|
||||||
|
|
||||||
|
Feature로 만드는 것이 좋은 지표:
|
||||||
|
|
||||||
|
- **여러 페이지에서 재사용됨**: 예를 들어, 여러 에디터가 있고 모두 댓글 기능이 있다면, 댓글은 재사용 가능한 feature입니다
|
||||||
|
- **중요한 비즈니스 기능**: 신규 프로젝트 참여자가 Features 폴더를 보고 앱의 주요 기능을 빠르게 파악할 수 있어야 합니다
|
||||||
|
|
||||||
|
Feature가 너무 많으면 중요한 기능이 묻히므로, 신규 참여자의 경험을 최적화하여 결정하세요.
|
||||||
|
|
||||||
|
## 구조
|
||||||
|
|
||||||
|
각 feature 슬라이스는 다음 세그먼트로 구성됩니다:
|
||||||
|
|
||||||
|
```
|
||||||
|
features/
|
||||||
|
└── [feature-name]/
|
||||||
|
├── ui/ # 상호작용을 수행하는 UI (폼, 버튼 등)
|
||||||
|
├── api/ # 액션 수행에 필요한 API 호출 (선택적)
|
||||||
|
├── model/ # 검증 및 내부 상태 관리 (선택적)
|
||||||
|
├── lib/ # 유틸리티 함수 (선택적)
|
||||||
|
├── config/ # feature flags (선택적)
|
||||||
|
└── index.ts # Public API
|
||||||
|
```
|
||||||
|
|
||||||
|
### 세그먼트 설명
|
||||||
|
|
||||||
|
- **ui**: 사용자 상호작용을 위한 UI 컴포넌트 (폼, 모달, 버튼 등)
|
||||||
|
- **api**: feature 실행에 필요한 API 요청 함수
|
||||||
|
- **model**: 폼 검증, 내부 상태, 비즈니스 로직
|
||||||
|
- **lib**: feature 내부에서만 사용되는 유틸리티
|
||||||
|
- **config**: feature flags, feature별 설정값
|
||||||
|
- **index.ts**: 슬라이스의 Public API (외부에서 사용할 수 있는 것만 export)
|
||||||
|
|
||||||
|
## 예시
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// features/auth-login/ui/login-form.tsx
|
||||||
|
import { useState } from 'react';
|
||||||
|
import { loginUser } from '../api/login-user';
|
||||||
|
import type { LoginCredentials } from '../model/types';
|
||||||
|
|
||||||
|
export function LoginForm() {
|
||||||
|
const [credentials, setCredentials] = useState<LoginCredentials>({
|
||||||
|
email: '',
|
||||||
|
password: ''
|
||||||
|
});
|
||||||
|
|
||||||
|
const handleSubmit = async (e: React.SubmitEvent) => {
|
||||||
|
e.preventDefault();
|
||||||
|
await loginUser(credentials);
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<form onSubmit={handleSubmit}>
|
||||||
|
<input
|
||||||
|
type="email"
|
||||||
|
value={credentials.email}
|
||||||
|
onChange={(e) => setCredentials({ ...credentials, email: e.target.value })}
|
||||||
|
/>
|
||||||
|
<input
|
||||||
|
type="password"
|
||||||
|
value={credentials.password}
|
||||||
|
onChange={(e) => setCredentials({ ...credentials, password: e.target.value })}
|
||||||
|
/>
|
||||||
|
<button type="submit">로그인</button>
|
||||||
|
</form>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// features/auth-login/api/login-user.ts
|
||||||
|
import type { LoginCredentials } from '../model/types';
|
||||||
|
|
||||||
|
export async function loginUser(credentials: LoginCredentials) {
|
||||||
|
const response = await fetch('/api/auth/login', {
|
||||||
|
method: 'POST',
|
||||||
|
body: JSON.stringify(credentials),
|
||||||
|
});
|
||||||
|
return response.json();
|
||||||
|
}
|
||||||
|
|
||||||
|
// features/auth-login/model/types.ts
|
||||||
|
export interface LoginCredentials {
|
||||||
|
email: string;
|
||||||
|
password: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
// features/auth-login/index.ts
|
||||||
|
export { LoginForm } from './ui/login-form';
|
||||||
|
export { loginUser } from './api/login-user';
|
||||||
|
export type { LoginCredentials } from './model/types';
|
||||||
|
```
|
||||||
|
|
||||||
|
## 레이어 의존성 규칙
|
||||||
|
|
||||||
|
✅ **허용되는 의존성**:
|
||||||
|
|
||||||
|
- `shared` 레이어의 모듈
|
||||||
|
- `entities` 레이어의 모듈
|
||||||
|
- 같은 feature 슬라이스 내의 다른 세그먼트
|
||||||
|
|
||||||
|
❌ **금지된 의존성**:
|
||||||
|
|
||||||
|
- 다른 `features` 슬라이스 (feature 간 직접 의존 금지)
|
||||||
|
- `widgets` 레이어
|
||||||
|
- `pages` 레이어
|
||||||
|
- `app` 레이어
|
||||||
|
|
||||||
|
> 💡 **팁**: 여러 features가 공통 기능을 필요로 한다면, 그 기능을 `shared` 레이어로 이동시키거나 `entities` 레이어에서 관리하세요.
|
||||||
|
|
||||||
|
## 명명 규칙
|
||||||
|
|
||||||
|
- 소문자와 대시 사용: `auth-login`, `post-create`, `comment-edit`
|
||||||
|
- 동사 형태 권장: 사용자 액션을 나타내는 이름 사용
|
||||||
|
- 명확하고 구체적으로: 기능의 목적이 명확하게 드러나도록
|
||||||
|
|
||||||
|
## 주의사항
|
||||||
|
|
||||||
|
1. **하나의 기능에만 집중**: 각 feature는 단일 사용자 시나리오를 구현해야 합니다
|
||||||
|
2. **재사용성 고려**: 여러 페이지에서 사용될 수 있도록 설계
|
||||||
|
3. **독립성 유지**: 다른 features에 의존하지 않고 독립적으로 작동
|
||||||
|
4. **적절한 추상화**: 너무 많은 feature를 만들지 말고, 중요한 기능 위주로 구성
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
export { MainPage } from "./ui/main-page";
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
export function MainPage() {
|
||||||
|
return (
|
||||||
|
<div className="flex h-full flex-col items-center justify-center py-10">
|
||||||
|
<h1 className="mb-4 text-3xl font-bold">Home</h1>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
export const PORT = process.env.NEXT_PUBLIC_PORT || "3000";
|
||||||
|
export const PROXY_HOST = process.env.NEXT_PUBLIC_PROXY_HOST || `http://localhost:${PORT}`;
|
||||||
|
export const SITE_ID = process.env.NEXT_PUBLIC_SITE_ID || "AS";
|
||||||
|
export const SERVER_API_URL = process.env.SERVER_API_URL;
|
||||||
|
export const CLAIM_NAME = process.env.NEXT_PUBLIC_CLAIM_NAME || "Authorization";
|
||||||
|
export const ACCESS_TOKEN = process.env.NEXT_PUBLIC_ACCESS_TOKEN || "access-token";
|
||||||
|
export const REFRESH_TOKEN = process.env.NEXT_PUBLIC_REFRESH_TOKEN || "refresh-token";
|
||||||
|
export const AUTH_USER_ID = process.env.NEXT_PUBLIC_AUTH_USER_ID || "token-id";
|
||||||
@@ -18,9 +18,6 @@ const config: Config = {
|
|||||||
background: "var(--background)",
|
background: "var(--background)",
|
||||||
foreground: "var(--foreground)",
|
foreground: "var(--foreground)",
|
||||||
},
|
},
|
||||||
fontFamily: {
|
|
||||||
sans: ["var(--font-noto-sans-kr)", "Noto Sans KR", "sans-serif"],
|
|
||||||
},
|
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
plugins: [],
|
plugins: [],
|
||||||
|
|||||||
@@ -19,13 +19,7 @@
|
|||||||
}
|
}
|
||||||
],
|
],
|
||||||
"paths": {
|
"paths": {
|
||||||
"@/*": ["./*"],
|
"@/*": ["./src/*"],
|
||||||
"@/app/*": ["./app/*"],
|
|
||||||
"@/shared/*": ["./shared/*"],
|
|
||||||
"@/entities/*": ["./entities/*"],
|
|
||||||
"@/features/*": ["./features/*"],
|
|
||||||
"@/widgets/*": ["./widgets/*"],
|
|
||||||
"@/pages/*": ["./pages/*"],
|
|
||||||
"@common/components": ["../../packages/common/components/dist/"],
|
"@common/components": ["../../packages/common/components/dist/"],
|
||||||
"@common/network": ["../../packages/common/network/"]
|
"@common/network": ["../../packages/common/network/"]
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,3 @@
|
|||||||
|
{
|
||||||
|
"extends": "next/core-web-vitals"
|
||||||
|
}
|
||||||
@@ -1,13 +1,10 @@
|
|||||||
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
|
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
|
||||||
|
|
||||||
# dependencies
|
# dependencies
|
||||||
|
/node_modules
|
||||||
/.pnp
|
/.pnp
|
||||||
.pnp.*
|
.pnp.js
|
||||||
.yarn/*
|
.yarn/install-state.gz
|
||||||
!.yarn/patches
|
|
||||||
!.yarn/plugins
|
|
||||||
!.yarn/releases
|
|
||||||
!.yarn/versions
|
|
||||||
|
|
||||||
# testing
|
# testing
|
||||||
/coverage
|
/coverage
|
||||||
@@ -27,9 +24,9 @@
|
|||||||
npm-debug.log*
|
npm-debug.log*
|
||||||
yarn-debug.log*
|
yarn-debug.log*
|
||||||
yarn-error.log*
|
yarn-error.log*
|
||||||
.pnpm-debug.log*
|
|
||||||
|
|
||||||
# env files (can opt-in for committing if needed)
|
# local env files
|
||||||
|
.env.*
|
||||||
|
|
||||||
# vercel
|
# vercel
|
||||||
.vercel
|
.vercel
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
{
|
||||||
|
"semi": true,
|
||||||
|
"trailingComma": "all",
|
||||||
|
"singleQuote": false,
|
||||||
|
"printWidth": 100,
|
||||||
|
"tabWidth": 2,
|
||||||
|
"plugins": ["prettier-plugin-tailwindcss"]
|
||||||
|
}
|
||||||
@@ -0,0 +1,187 @@
|
|||||||
|
# Template Application
|
||||||
|
|
||||||
|
Next.js 애플리케이션 with FSD(Feature Sliced Design) 아키텍처
|
||||||
|
|
||||||
|
## 기술 스택
|
||||||
|
|
||||||
|
- **프레임워크**: Next.js 15 + TypeScript
|
||||||
|
- **스타일링**: Tailwind CSS
|
||||||
|
- **상태관리**: Zustand
|
||||||
|
- **데이터 페칭**: TanStack Query (React Query)
|
||||||
|
- **폼 관리**: React Hook Form + Zod
|
||||||
|
- **테이블**: TanStack Table
|
||||||
|
- **HTTP 클라이언트**: Axios
|
||||||
|
- **날짜 처리**: Day.js
|
||||||
|
|
||||||
|
## 프로젝트 구조 (FSD + Next.js App Router)
|
||||||
|
|
||||||
|
이 프로젝트는 **Feature-Sliced Design v2.1**과 **FSD 공식 Next.js 가이드**에 맞춰 구성되어 있습니다. Next.js `app/`은 라우트만 담당하고, 실제 레이어는 `src/` 아래에 있습니다.
|
||||||
|
|
||||||
|
```
|
||||||
|
_template/
|
||||||
|
├── app/ # Next.js App Router (루트) — 라우트·레이아웃 진입점만
|
||||||
|
│ ├── layout.tsx # 루트 레이아웃 (src/app에서 providers, styles import)
|
||||||
|
│ └── (with-base-layout)/
|
||||||
|
│ ├── layout.tsx # BaseLayout 래퍼 (src/app/layouts에서 import)
|
||||||
|
│ └── page.tsx # re-export: export { MainPage as default } from '@/pages/home'
|
||||||
|
│
|
||||||
|
├── pages/ # 빈 폴더 + README (Next.js가 src/pages를 Pages Router로 쓰지 않도록)
|
||||||
|
│ └── README.md
|
||||||
|
│
|
||||||
|
└── src/ # FSD 레이어 (실제 코드)
|
||||||
|
├── app/ # App 레이어 (슬라이스 없음, 세그먼트만)
|
||||||
|
│ ├── providers/ # 전역 Providers (QueryClient 등)
|
||||||
|
│ ├── styles/ # 글로벌 스타일 (globals.css)
|
||||||
|
│ └── layouts/ # 공통 레이아웃 컴포넌트 (BaseLayoutWrapper)
|
||||||
|
│
|
||||||
|
├── pages/ # Pages 레이어 (페이지 슬라이스)
|
||||||
|
│ └── home/
|
||||||
|
│ ├── ui/
|
||||||
|
│ └── index.ts # Public API
|
||||||
|
│
|
||||||
|
├── widgets/ # Widgets 레이어
|
||||||
|
├── features/ # Features 레이어
|
||||||
|
├── entities/ # Entities 레이어
|
||||||
|
└── shared/ # Shared 레이어
|
||||||
|
├── ui/
|
||||||
|
├── api/
|
||||||
|
├── lib/
|
||||||
|
└── config/
|
||||||
|
```
|
||||||
|
|
||||||
|
### 계층 구조 이해하기
|
||||||
|
|
||||||
|
FSD는 **3단계 계층**으로 구성됩니다:
|
||||||
|
|
||||||
|
1. **Layers (레이어)**: 책임과 의존성에 따른 수평적 분리 (app, pages, widgets, features, entities, shared)
|
||||||
|
2. **Slices (슬라이스)**: 비즈니스 도메인에 따른 수직적 분리 (user, product, auth-login 등)
|
||||||
|
3. **Segments (세그먼트)**: 기술적 목적에 따른 분리 (ui, api, model, lib 등)
|
||||||
|
|
||||||
|
> 📚 각 레이어의 자세한 설명은 해당 폴더의 README.md를 참고하세요.
|
||||||
|
|
||||||
|
## FSD 레이어 설명
|
||||||
|
|
||||||
|
FSD는 계층적 아키텍처로, 각 레이어는 책임의 범위와 의존성의 정도에 따라 구분됩니다. 7개의 표준화된 레이어가 있으며, 프로젝트에 필요한 레이어만 사용하면 됩니다.
|
||||||
|
|
||||||
|
### 레이어 계층 구조 (위에서 아래로)
|
||||||
|
|
||||||
|
```
|
||||||
|
app/ ↑ 가장 높은 책임, 가장 많은 의존성
|
||||||
|
pages/ |
|
||||||
|
widgets/ |
|
||||||
|
features/ |
|
||||||
|
entities/ |
|
||||||
|
shared/ ↓ 가장 낮은 책임, 의존성 없음
|
||||||
|
```
|
||||||
|
|
||||||
|
### 1. App
|
||||||
|
- **목적**: 앱 전체에 영향을 주는 기술적/비즈니스적 사항
|
||||||
|
- **내용**: Context providers, 글로벌 스타일, 스토어 설정, 라우터 설정, 애널리틱스
|
||||||
|
- **특징**: 슬라이스가 없고 세그먼트로만 구성
|
||||||
|
- **의존성**: 모든 하위 레이어 사용 가능
|
||||||
|
|
||||||
|
### 2. Pages (src/pages)
|
||||||
|
- **목적**: 웹사이트나 애플리케이션을 구성하는 페이지/화면
|
||||||
|
- **내용**: 페이지 UI, 로딩 상태, 에러 바운더리, 데이터 fetching
|
||||||
|
- **특징**: 한 페이지당 한 슬라이스 (유사한 페이지는 그룹화 가능). Next.js `app/`의 route 파일에서 re-export
|
||||||
|
- **의존성**: `widgets`, `features`, `entities`, `shared` 사용 가능
|
||||||
|
|
||||||
|
> 💡 **FSD v2.1 권장사항**: "pages-first" 접근 방식을 따라, 재사용되지 않는 큰 UI 블록과 비즈니스 로직은 페이지 슬라이스에 유지하세요.
|
||||||
|
|
||||||
|
### 3. Widgets
|
||||||
|
- **목적**: 큰 규모의 독립적인 UI 블록
|
||||||
|
- **내용**: 여러 features와 entities를 조합한 복합 UI
|
||||||
|
- **사용 시기**: 여러 페이지에서 재사용되거나, 페이지에 여러 개의 큰 독립적 블록이 있을 때
|
||||||
|
- **의존성**: `features`, `entities`, `shared` 사용 가능 (다른 `widgets` 불가)
|
||||||
|
|
||||||
|
### 4. Features
|
||||||
|
- **목적**: 사용자가 수행하는 주요 상호작용과 비즈니스 기능
|
||||||
|
- **내용**: 사용자 시나리오 (예: 로그인, 상품 검색, 댓글 작성)
|
||||||
|
- **사용 시기**: 여러 페이지에서 재사용되는 기능
|
||||||
|
- **의존성**: `entities`, `shared` 사용 가능 (다른 `features` 불가)
|
||||||
|
|
||||||
|
### 5. Entities
|
||||||
|
- **목적**: 비즈니스가 다루는 실제 개념 (User, Product, Order 등)
|
||||||
|
- **내용**: 데이터 모델, 타입, API 요청, 엔티티의 시각적 표현
|
||||||
|
- **특징**: 비즈니스 용어로 명명
|
||||||
|
- **의존성**: 다른 `entities`, `shared` 사용 가능
|
||||||
|
|
||||||
|
### 6. Shared
|
||||||
|
- **목적**: 애플리케이션의 기반 제공
|
||||||
|
- **내용**: API 클라이언트, UI Kit, 유틸리티 라이브러리, 글로벌 설정
|
||||||
|
- **특징**: 비즈니스 로직 없음, 슬라이스가 없고 세그먼트로만 구성
|
||||||
|
- **의존성**: 외부 라이브러리만 사용 가능 (다른 레이어 불가)
|
||||||
|
|
||||||
|
## 시작하기
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 의존성 설치
|
||||||
|
pnpm install
|
||||||
|
|
||||||
|
# 개발 서버 실행
|
||||||
|
pnpm run dev
|
||||||
|
|
||||||
|
# 프로덕션 빌드
|
||||||
|
pnpm run build
|
||||||
|
|
||||||
|
# 프로덕션 서버 실행
|
||||||
|
pnpm start
|
||||||
|
```
|
||||||
|
|
||||||
|
## 환경 변수
|
||||||
|
|
||||||
|
`.env.local` 파일 생성:
|
||||||
|
|
||||||
|
```env
|
||||||
|
NEXT_PUBLIC_API_URL=http://localhost:3000/api
|
||||||
|
```
|
||||||
|
|
||||||
|
## FSD 핵심 규칙
|
||||||
|
|
||||||
|
### 1. Import 규칙
|
||||||
|
|
||||||
|
> **슬라이스 내의 모듈(파일)은 오직 하위 레이어에 있는 슬라이스만 import할 수 있습니다.**
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// ✅ 올바른 import (하위 레이어)
|
||||||
|
// features/auth-login/ui/form.tsx
|
||||||
|
import { User } from "entities/user";
|
||||||
|
import { Button } from "shared/ui/button";
|
||||||
|
|
||||||
|
// ❌ 잘못된 import (같은 레이어)
|
||||||
|
// features/auth-login/ui/form.tsx
|
||||||
|
import { PostForm } from "features/post-create"; // 금지!
|
||||||
|
|
||||||
|
// ❌ 잘못된 import (상위 레이어)
|
||||||
|
// features/auth-login/ui/form.tsx
|
||||||
|
import { Header } from "widgets/header"; // 금지!
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Public API 규칙
|
||||||
|
|
||||||
|
> **슬라이스 외부에서는 Public API(index.ts)를 통해서만 접근해야 합니다.**
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// ✅ 올바른 import (Public API 사용)
|
||||||
|
import { LoginForm } from "features/auth-login";
|
||||||
|
|
||||||
|
// ❌ 잘못된 import (내부 구조 직접 접근)
|
||||||
|
import { LoginForm } from "features/auth-login/ui/login-form";
|
||||||
|
```
|
||||||
|
|
||||||
|
**Public API 작성 시 주의사항**:
|
||||||
|
- 와일드카드 re-export(`export * from`) 사용 지양
|
||||||
|
- 필요한 것만 명시적으로 export
|
||||||
|
- 슬라이스의 인터페이스를 명확하게 표현
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// ❌ 나쁜 예시
|
||||||
|
export * from "./ui/Comment";
|
||||||
|
export * from "./model/comments";
|
||||||
|
|
||||||
|
// ✅ 좋은 예시
|
||||||
|
export { Comment } from "./ui/comment";
|
||||||
|
export { CommentForm } from "./ui/comment-form";
|
||||||
|
export { useComments } from "./model/use-comments";
|
||||||
|
export type { Comment, CommentFormData } from "./model/types";
|
||||||
|
```
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
export { ApprovalLineManagementPage as default } from "@/pages/approval-line-management";
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
export { ChecklistManagementPage as default } from "@/pages/checklist-management";
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
import { CnfmModifyPage } from "@/pages/instl-sncn";
|
||||||
|
|
||||||
|
export default async function InstlSncnModifyPage({
|
||||||
|
params,
|
||||||
|
}: {
|
||||||
|
params: Promise<{ id: string }>;
|
||||||
|
}) {
|
||||||
|
const { id } = await params;
|
||||||
|
return <CnfmModifyPage id={id} />;
|
||||||
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
import { CnfmViewPage } from "@/pages/instl-sncn";
|
||||||
|
|
||||||
|
export default async function InstlSncnViewPage({
|
||||||
|
params,
|
||||||
|
}: {
|
||||||
|
params: Promise<{ id: string }>;
|
||||||
|
}) {
|
||||||
|
const { id } = await params;
|
||||||
|
return <CnfmViewPage id={id} />;
|
||||||
|
}
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
import { CnfmListPage } from "@/pages/instl-sncn";
|
||||||
|
|
||||||
|
export default CnfmListPage;
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
import { CnfmRegistPage } from "@/pages/instl-sncn";
|
||||||
|
|
||||||
|
export default CnfmRegistPage;
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
import type { ReactNode } from "react";
|
||||||
|
|
||||||
|
import { BaseLayoutWrapper } from "@/app/layouts/base-layout";
|
||||||
|
|
||||||
|
interface WithBaseLayoutProps {
|
||||||
|
children: ReactNode;
|
||||||
|
}
|
||||||
|
|
||||||
|
export default function WithBaseLayout({ children }: WithBaseLayoutProps) {
|
||||||
|
return <BaseLayoutWrapper>{children}</BaseLayoutWrapper>;
|
||||||
|
}
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
export { MainPage as default } from "@/pages/home";
|
||||||
@@ -0,0 +1,169 @@
|
|||||||
|
# App Layer
|
||||||
|
|
||||||
|
**App**은 애플리케이션 전체에 영향을 미치는 기술적, 비즈니스적 사항을 다루는 최상위 레이어입니다.
|
||||||
|
|
||||||
|
## 목적
|
||||||
|
|
||||||
|
- 애플리케이션의 진입점(entrypoint) 제공
|
||||||
|
- 전역 Context Providers 설정
|
||||||
|
- 라우터 구성
|
||||||
|
- 글로벌 스타일 정의
|
||||||
|
- 전역 상태 저장소 설정
|
||||||
|
- 애널리틱스 및 모니터링 설정
|
||||||
|
|
||||||
|
## 특징
|
||||||
|
|
||||||
|
- **슬라이스 없음**: App 레이어는 Shared처럼 슬라이스가 없고 세그먼트로만 구성됩니다
|
||||||
|
- **전체 앱 관심사**: 특정 비즈니스 도메인이 아닌 앱 전체와 관련된 코드만 포함
|
||||||
|
- **최상위 레이어**: 모든 하위 레이어의 모듈을 자유롭게 import 가능
|
||||||
|
|
||||||
|
## 구조 (Next.js App Router)
|
||||||
|
|
||||||
|
Next.js를 사용하는 경우, App 레이어는 주로 `app/` 디렉토리로 표현됩니다:
|
||||||
|
|
||||||
|
```
|
||||||
|
app/
|
||||||
|
├── (routes)/ # 라우트 그룹 및 페이지
|
||||||
|
│ ├── (auth)/
|
||||||
|
│ │ ├── login/
|
||||||
|
│ │ │ └── page.tsx
|
||||||
|
│ │ └── register/
|
||||||
|
│ │ └── page.tsx
|
||||||
|
│ └── (main)/
|
||||||
|
│ ├── dashboard/
|
||||||
|
│ │ └── page.tsx
|
||||||
|
│ └── settings/
|
||||||
|
│ └── page.tsx
|
||||||
|
├── layout.tsx # 루트 레이아웃
|
||||||
|
├── page.tsx # 홈 페이지
|
||||||
|
├── globals.css # 글로벌 스타일
|
||||||
|
├── providers.tsx # 전역 Providers 설정
|
||||||
|
└── error.tsx # 글로벌 에러 핸들러
|
||||||
|
```
|
||||||
|
|
||||||
|
### 일반적인 FSD 세그먼트 구조
|
||||||
|
|
||||||
|
FSD 표준 세그먼트를 사용하는 경우:
|
||||||
|
|
||||||
|
```
|
||||||
|
app/
|
||||||
|
├── entrypoint/ # 애플리케이션 진입점 (프레임워크별)
|
||||||
|
│ └── index.tsx
|
||||||
|
├── providers/ # Context Providers
|
||||||
|
│ ├── query-provider.tsx
|
||||||
|
│ ├── theme-provider.tsx
|
||||||
|
│ └── index.tsx
|
||||||
|
├── styles/ # 글로벌 스타일
|
||||||
|
│ ├── globals.css
|
||||||
|
│ └── theme.css
|
||||||
|
├── store/ # 글로벌 상태 저장소 설정
|
||||||
|
│ └── index.ts
|
||||||
|
└── routes/ # 라우터 설정
|
||||||
|
└── index.tsx
|
||||||
|
```
|
||||||
|
|
||||||
|
## 예시
|
||||||
|
|
||||||
|
### Next.js Providers 설정
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// app/providers.tsx
|
||||||
|
'use client';
|
||||||
|
|
||||||
|
import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
|
||||||
|
import { ThemeProvider } from 'next-themes';
|
||||||
|
import { useState } from 'react';
|
||||||
|
|
||||||
|
export function Providers({ children }: { children: React.ReactNode }) {
|
||||||
|
const [queryClient] = useState(() => new QueryClient({
|
||||||
|
defaultOptions: {
|
||||||
|
queries: {
|
||||||
|
staleTime: 60 * 1000,
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}));
|
||||||
|
|
||||||
|
return (
|
||||||
|
<QueryClientProvider client={queryClient}>
|
||||||
|
<ThemeProvider attribute="class" defaultTheme="system" enableSystem>
|
||||||
|
{children}
|
||||||
|
</ThemeProvider>
|
||||||
|
</QueryClientProvider>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// app/layout.tsx
|
||||||
|
import { Providers } from './providers';
|
||||||
|
import './globals.css';
|
||||||
|
|
||||||
|
export default function RootLayout({
|
||||||
|
children,
|
||||||
|
}: {
|
||||||
|
children: React.ReactNode;
|
||||||
|
}) {
|
||||||
|
return (
|
||||||
|
<html lang="ko">
|
||||||
|
<body>
|
||||||
|
<Providers>
|
||||||
|
{children}
|
||||||
|
</Providers>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 글로벌 설정
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// app/config/analytics.ts
|
||||||
|
export function initAnalytics() {
|
||||||
|
if (typeof window !== 'undefined') {
|
||||||
|
// 애널리틱스 초기화
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// app/config/monitoring.ts
|
||||||
|
export function initMonitoring() {
|
||||||
|
// 에러 모니터링 설정
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Next.js App Router와 FSD
|
||||||
|
|
||||||
|
Next.js의 `app/` 디렉토리는 FSD의 **App 레이어**와 **Pages 레이어**를 동시에 담당합니다:
|
||||||
|
|
||||||
|
- **루트 레벨 파일들** (`layout.tsx`, `providers.tsx`, `globals.css`): App 레이어
|
||||||
|
- **라우트 폴더들** (`dashboard/`, `login/` 등): Pages 레이어
|
||||||
|
|
||||||
|
각 페이지별 비즈니스 로직은:
|
||||||
|
- 재사용되지 않는 UI는 페이지 슬라이스(`app/dashboard/` 등) 안에 유지
|
||||||
|
- 재사용되는 기능은 `features/` 레이어로 분리
|
||||||
|
- 여러 페이지에서 재사용되는 큰 UI 블록은 `widgets/` 레이어로 분리
|
||||||
|
|
||||||
|
## 레이어 의존성 규칙
|
||||||
|
|
||||||
|
✅ **허용되는 의존성**:
|
||||||
|
- 모든 하위 레이어 (`pages`, `widgets`, `features`, `entities`, `shared`)
|
||||||
|
- 같은 `app` 레이어 내의 다른 세그먼트
|
||||||
|
- 외부 라이브러리
|
||||||
|
|
||||||
|
❌ **금지된 의존성**:
|
||||||
|
- 없음 (App은 최상위 레이어)
|
||||||
|
|
||||||
|
## 주의사항
|
||||||
|
|
||||||
|
1. **비대화 방지**: App 레이어가 너무 커지면 관리가 어려워집니다. 대부분의 로직은 하위 레이어에 배치하세요
|
||||||
|
2. **전역 관심사만**: 특정 페이지나 기능에만 관련된 코드는 해당 레이어로 이동
|
||||||
|
3. **라우터 레벨 로직**: 라우터 및 서버 레벨 로직은 이 레이어에 유지
|
||||||
|
4. **Processes 레이어 사용 지양**: Processes 레이어는 deprecated되었으므로 해당 로직은 `app`이나 `features`에 배치
|
||||||
|
|
||||||
|
## FSD v2.1 권장사항
|
||||||
|
|
||||||
|
최신 FSD 버전(v2.1)은 **"pages-first"** 접근 방식을 권장합니다:
|
||||||
|
|
||||||
|
- 더 많은 코드를 페이지 슬라이스에 유지
|
||||||
|
- 큰 UI 블록과 재사용되지 않는 비즈니스 로직은 즉시 추출하지 말고 페이지에 보관
|
||||||
|
- 실제로 재사용이 필요할 때만 `features`나 `widgets`로 분리
|
||||||
|
|
||||||
|
이 접근 방식은 과도한 추상화를 방지하고 코드를 더 쉽게 탐색할 수 있게 합니다.
|
||||||
@@ -0,0 +1,111 @@
|
|||||||
|
import { cookies } from "next/headers";
|
||||||
|
import { NextResponse } from "next/server";
|
||||||
|
|
||||||
|
import {
|
||||||
|
ACCESS_TOKEN,
|
||||||
|
AUTH_USER_ID,
|
||||||
|
CLAIM_NAME,
|
||||||
|
REFRESH_TOKEN,
|
||||||
|
SERVER_API_URL,
|
||||||
|
SITE_ID,
|
||||||
|
} from "@/shared/config";
|
||||||
|
|
||||||
|
async function handler(
|
||||||
|
request: Request,
|
||||||
|
params: { url: string[] },
|
||||||
|
method: "GET" | "POST" | "PUT" | "DELETE",
|
||||||
|
) {
|
||||||
|
const cookieStore = await cookies();
|
||||||
|
const headers: Record<string, string> = {
|
||||||
|
"Content-Type": "application/json",
|
||||||
|
"X-Site-Id": SITE_ID,
|
||||||
|
};
|
||||||
|
let body = {};
|
||||||
|
const isRefreshHandler = params.url.includes("refresh");
|
||||||
|
|
||||||
|
// silent refresh
|
||||||
|
if (isRefreshHandler) {
|
||||||
|
const refreshToken = cookieStore.get(REFRESH_TOKEN);
|
||||||
|
headers[CLAIM_NAME] = refreshToken?.value ?? "";
|
||||||
|
|
||||||
|
if (!headers[CLAIM_NAME]) {
|
||||||
|
return NextResponse.json({ message: "Can't refresh" }, { status: 401 });
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
if (!isRefreshHandler) {
|
||||||
|
body = await request.json();
|
||||||
|
}
|
||||||
|
|
||||||
|
const targetUrl = `${SERVER_API_URL}/${params.url.join("/")}`;
|
||||||
|
console.log(`[Proxy API] ${method} ${params.url.join("/")} -> ${targetUrl}`);
|
||||||
|
console.log(`[Proxy API] Headers:`, headers);
|
||||||
|
if (!isRefreshHandler) {
|
||||||
|
console.log(`[Proxy API] Body:`, body);
|
||||||
|
}
|
||||||
|
|
||||||
|
const result = await fetch(targetUrl, {
|
||||||
|
method,
|
||||||
|
headers,
|
||||||
|
body: JSON.stringify(body),
|
||||||
|
});
|
||||||
|
|
||||||
|
console.log(`[Proxy API] Response Status: ${result.status}`);
|
||||||
|
console.log(`[Proxy API] Response Headers:`, {
|
||||||
|
[ACCESS_TOKEN]: result.headers.get(ACCESS_TOKEN),
|
||||||
|
[REFRESH_TOKEN]: result.headers.get(REFRESH_TOKEN) ? '***hidden***' : undefined,
|
||||||
|
[AUTH_USER_ID]: result.headers.get(AUTH_USER_ID),
|
||||||
|
});
|
||||||
|
|
||||||
|
if (!result.ok) {
|
||||||
|
console.error(`[Proxy API] Request failed with status ${result.status}`);
|
||||||
|
return NextResponse.json({ message: "Invalid Credentials" }, { status: 401 });
|
||||||
|
}
|
||||||
|
|
||||||
|
const accessToken = result.headers.get(ACCESS_TOKEN);
|
||||||
|
const refreshToken = result.headers.get(REFRESH_TOKEN);
|
||||||
|
const userId = result.headers.get(AUTH_USER_ID);
|
||||||
|
|
||||||
|
if (accessToken && userId) {
|
||||||
|
console.log(`[Proxy API] Login successful for user: ${userId}`);
|
||||||
|
const response = NextResponse.json({
|
||||||
|
[ACCESS_TOKEN]: accessToken,
|
||||||
|
[AUTH_USER_ID]: userId,
|
||||||
|
});
|
||||||
|
|
||||||
|
const forwardedHost = request.headers.get("x-forwarded-host");
|
||||||
|
const host = request.headers.get("host");
|
||||||
|
const actualHost = forwardedHost || host || new URL(request.url).hostname.toString();
|
||||||
|
|
||||||
|
// 운영 환경에서 domain 설정
|
||||||
|
const domain = actualHost.includes("hasuon.or.kr") ? ".hasuon.or.kr" : actualHost;
|
||||||
|
|
||||||
|
if (refreshToken) {
|
||||||
|
cookieStore.set(REFRESH_TOKEN, refreshToken, {
|
||||||
|
httpOnly: true,
|
||||||
|
sameSite: "strict",
|
||||||
|
domain: domain,
|
||||||
|
path: "/",
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
return response;
|
||||||
|
}
|
||||||
|
|
||||||
|
return NextResponse.json({ message: "Invalid Credentials" }, { status: 401 });
|
||||||
|
} catch (error) {
|
||||||
|
console.error(`[Proxy API] Error caught in handler:`, error);
|
||||||
|
return NextResponse.json({ message: "Server Error", error }, { status: 500 });
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function POST(request: Request, props: { params: Promise<{ url: string[] }> }) {
|
||||||
|
const params = await props.params;
|
||||||
|
return handler(request, params, "POST");
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function PUT(request: Request, props: { params: Promise<{ url: string[] }> }) {
|
||||||
|
const params = await props.params;
|
||||||
|
return handler(request, params, "PUT");
|
||||||
|
}
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
import type { Metadata } from "next";
|
||||||
|
import { cookies } from "next/headers";
|
||||||
|
|
||||||
|
import { Providers } from "@/app/providers";
|
||||||
|
|
||||||
|
import "@/app/styles/globals.css";
|
||||||
|
|
||||||
|
export const metadata: Metadata = {
|
||||||
|
title: "행정지원시스템",
|
||||||
|
description: "행정지원시스템",
|
||||||
|
};
|
||||||
|
|
||||||
|
interface RootLayoutProps {
|
||||||
|
children: React.ReactNode;
|
||||||
|
}
|
||||||
|
|
||||||
|
export default async function RootLayout({ children }: RootLayoutProps) {
|
||||||
|
const theme = (await cookies()).get("site-theme-key");
|
||||||
|
|
||||||
|
return (
|
||||||
|
<html lang="ko" data-theme={theme?.value}>
|
||||||
|
<body>
|
||||||
|
<Providers>{children}</Providers>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,407 @@
|
|||||||
|
# 화면설계서: 결재선 관리
|
||||||
|
|
||||||
|
## 1. 기본 정보
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| ---------- | -------------------------------------------- |
|
||||||
|
| 버전 | 0.3 |
|
||||||
|
| 프로세스명 | UI설계 |
|
||||||
|
| 화면명 | 결재선 관리 |
|
||||||
|
| 화면 유형 | [v] 조회 [v] 입력 [v] 수정 [v] 삭제 [ ] 출력 |
|
||||||
|
| 메뉴 경로 | 디지털행정지원 > 시스템관리 > 결재선 관리 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 화면 목적
|
||||||
|
|
||||||
|
전자결재 처리에 사용할 **결재서식**(템플릿)을 등록·관리하고, 각 서식별로 **결재선**(결재구분·결재자·순서)을 구성한다. 상단의 결재서식 목록에서 하나를 선택하면 하단 영역에 해당 서식의 결재선이 표시되며, 사용자는 **그리드 인라인 폼**으로 결재자를 등록·수정한다. **행 추가 또는 한 행 수정 중에는 다른 행을 편집할 수 없다**(단일 행 편집 잠금). 드래그로 순서를 변경한 뒤 **[결재선 저장]** 으로 서버에 반영한다.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 화면 구성
|
||||||
|
|
||||||
|
### 3-1. 전체 레이아웃
|
||||||
|
|
||||||
|
```
|
||||||
|
┌───────────────────────────────────────────────────────────────────────────────────────────────┐
|
||||||
|
│ 페이지 타이틀: 결재선 관리 브레드크럼: 디지털행정지원 > … > │
|
||||||
|
├───────────────────────────────────────────────────────────────────────────────────────────────┤
|
||||||
|
│ [영역 A] 전자결재선 관리 목록 [서식 등록] │
|
||||||
|
│ ┌──────────────────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ 전자결재서식아이디 | 결재서식명 | 문서구분 | 등록일시 | 관리 │ │
|
||||||
|
│ ├──────────────────────────────────────────────────────────────────────┤ │
|
||||||
|
│ │ TMPL-0001 (선택 행 강조) … [수정][삭제] │ │
|
||||||
|
│ └──────────────────────────────────────────────────────────────────────┘ │
|
||||||
|
├───────────────────────────────────────────────────────────────────────────────────────────────┤
|
||||||
|
│ [영역 B] 결재선 관리 선택된 서식: TMPL-0001 [결재선 저장] │
|
||||||
|
│ ┌─────────────────────────────────────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ [영역 B-2] 결재선 그리드 (인라인 편집 + 행 드래그 — @dnd-kit) │ │
|
||||||
|
│ │ ⋮⋮ | 결재선아이디 | 결재순서 | 결재구분 ▼ | 결재자 [선택] | 등록일시 | 관리 │ │
|
||||||
|
│ │ ⋮⋮ | APLN-0001 | [ 1 ] | [검토자 ▼] | [김민수 ][선택] | … | [저장][삭제] │ │
|
||||||
|
│ │ ⋮⋮ | (신규) | [ 2 ] | [승인자 ▼] | [ ][선택] | — | [저장][취소] │ │
|
||||||
|
│ └─────────────────────────────────────────────────────────────────────────────────────────┘ │
|
||||||
|
│ [행 추가] │
|
||||||
|
│ ※ 결재자 등록·수정은 그리드 셀에서 직접 입력. 검토인력만 [선택] 팝업/다이얼로그 │
|
||||||
|
│ ※ 행 추가·수정 중: 해당 행만 편집 가능, 나머지 행·[행 추가]·드래그 비활성 │
|
||||||
|
└───────────────────────────────────────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3-2. 화면 데이터 흐름
|
||||||
|
|
||||||
|
```
|
||||||
|
BEGIN
|
||||||
|
|
||||||
|
// 최초 진입
|
||||||
|
CALL GET /as-elapr-service/api/v1/elapr-tmplt
|
||||||
|
DISPLAY 결재서식 그리드 (영역 A)
|
||||||
|
DISPLAY 빈 상태 안내 (영역 B) // 서식 미선택 시 그리드·툴바 비활성
|
||||||
|
|
||||||
|
// 영역 A: 서식 행 선택
|
||||||
|
ON 영역 A 행 CLICK DO
|
||||||
|
SET 선택된 서식 = 행.elaprTmpltId
|
||||||
|
CALL GET /as-elapr-service/api/v1/elapr-apln?elaprTmpltId={id}
|
||||||
|
DISPLAY 결재선 그리드 (영역 B-2) — 조회 모드
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 A: 신규 서식 등록
|
||||||
|
ON [서식 등록] 버튼 CLICK DO
|
||||||
|
OPEN 결재서식 등록 다이얼로그
|
||||||
|
ON 확인 DO
|
||||||
|
CALL POST /as-elapr-service/api/v1/elapr-tmplt
|
||||||
|
CALL GET /as-elapr-service/api/v1/elapr-tmplt
|
||||||
|
END ON
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 A: 서식 수정·삭제 (다이얼로그 유지)
|
||||||
|
ON 영역 A [수정] / [삭제] DO
|
||||||
|
(기존과 동일 — PUT / DELETE elapr-tmplt)
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 B: 행 추가 (인라인 신규 행)
|
||||||
|
ON [행 추가] 버튼 CLICK DO
|
||||||
|
VALIDATE 서식 선택됨
|
||||||
|
VALIDATE 편집 중인 행 없음 (editingRowKey == null)
|
||||||
|
ADD 영역 B-2 그리드 맨 아래 편집 가능 행
|
||||||
|
SET editingRowKey = rowKey (draft-{timestamp})
|
||||||
|
SET 편집상태 = 신규
|
||||||
|
SET aplnId = 미설정 (POST 저장 시 서버 fn_gen_apln_id 발급)
|
||||||
|
SET atrzSeqNo = 현재 행 수 + 1
|
||||||
|
SET atrzSeComCd, aprvrUuid = 빈 값
|
||||||
|
DISABLE 나머지 행 편집 · [행 추가] · 드래그 · [결재선 저장](정책에 따라)
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 B-2: 기존 행 수정 진입
|
||||||
|
ON 행별 [수정] CLICK DO
|
||||||
|
VALIDATE 편집 중인 행 없음
|
||||||
|
SET editingRowId = 행.aplnId
|
||||||
|
SET 해당 행만 편집 모드
|
||||||
|
DISABLE 나머지 행 편집 · [행 추가] · 드래그
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 B-2: 인라인 편집
|
||||||
|
ON 그리드 셀 변경 DO
|
||||||
|
VALIDATE 변경 대상 행 == editingRowId
|
||||||
|
SET 해당 행 dirty = true
|
||||||
|
END ON
|
||||||
|
|
||||||
|
ON 셀 [선택] (검토인력) CLICK DO
|
||||||
|
OPEN 검토인력 선택 다이얼로그 (단일 선택)
|
||||||
|
ON 선택 DO
|
||||||
|
SET 행.aprvrUuid = 선택인력.uuid
|
||||||
|
SET 행.aprvrNm = 선택인력.성명 // UI 표시용 (응답 DTO에 없음 — 로컬 보조 필드)
|
||||||
|
END ON
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 B-2: 행별 저장
|
||||||
|
ON 행별 [저장] CLICK DO
|
||||||
|
VALIDATE atrzSeComCd, aprvrUuid, atrzSeqNo
|
||||||
|
IF 편집상태 = 신규 THEN
|
||||||
|
CALL POST /as-elapr-service/api/v1/elapr-apln
|
||||||
|
ELSE
|
||||||
|
CALL PUT /as-elapr-service/api/v1/elapr-apln/{aplnId}
|
||||||
|
END IF
|
||||||
|
CALL GET /as-elapr-service/api/v1/elapr-apln?elaprTmpltId={id}
|
||||||
|
CLEAR editingRowId
|
||||||
|
ENABLE 전체 행 조회 모드 · [행 추가] · 드래그
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 B: 결재선 저장 (드래그 순서 일괄 반영)
|
||||||
|
ON [결재선 저장] 버튼 CLICK DO
|
||||||
|
VALIDATE 서식 선택됨
|
||||||
|
VALIDATE 편집 중인 행 없음
|
||||||
|
REORDER atrzSeqNo = 그리드 행 순서 (1..n)
|
||||||
|
FOR EACH dirty 또는 순서 변경된 행 DO
|
||||||
|
CALL PUT /as-elapr-service/api/v1/elapr-apln/{aplnId} // atrzSeqNo 등 반영
|
||||||
|
END FOR
|
||||||
|
FOR EACH 신규 미저장 행 DO
|
||||||
|
CALL POST /as-elapr-service/api/v1/elapr-apln
|
||||||
|
END FOR
|
||||||
|
CALL GET /as-elapr-service/api/v1/elapr-apln?elaprTmpltId={id}
|
||||||
|
TOAST "결재선이 저장되었습니다."
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 B-2: 행 드래그
|
||||||
|
ON 영역 B-2 행 DRAG END DO
|
||||||
|
VALIDATE 편집 중인 행 없음
|
||||||
|
REORDER 그리드 행
|
||||||
|
SET 각 행 atrzSeqNo = 행 인덱스 + 1 (UI 즉시 반영, 서버는 [결재선 저장] 또는 행별 [저장])
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 B-2: 행 삭제
|
||||||
|
ON 행별 [삭제] CLICK DO
|
||||||
|
CONFIRM "선택한 결재선을 삭제하시겠습니까?"
|
||||||
|
IF 서버 저장된 행 THEN
|
||||||
|
CALL DELETE /as-elapr-service/api/v1/elapr-apln/{aplnId}
|
||||||
|
END IF
|
||||||
|
REMOVE 그리드 행 (신규 미저장 행은 API 호출 없이 제거)
|
||||||
|
CALL GET /as-elapr-service/api/v1/elapr-apln?elaprTmpltId={id}
|
||||||
|
END ON
|
||||||
|
|
||||||
|
ON 행별 [취소] CLICK DO // 신규·수정 공통
|
||||||
|
IF 편집상태 = 신규 THEN REMOVE 임시 행
|
||||||
|
ELSE RESTORE 행 스냅샷 (수정 취소)
|
||||||
|
CLEAR editingRowId
|
||||||
|
ENABLE 전체 행 조회 모드 · [행 추가] · 드래그
|
||||||
|
END ON
|
||||||
|
|
||||||
|
END
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 영역 A: 전자결재선 관리 목록
|
||||||
|
|
||||||
|
선택된 결재서식이 영역 B의 작업 대상이 된다. 행 클릭으로 선택 상태를 표시(좌측 컬러 바·배경 강조)한다.
|
||||||
|
|
||||||
|
### 4-1. 헤더 / 툴바
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| ----------- | ----------------------------------------------- |
|
||||||
|
| 섹션 타이틀 | 전자결재선 관리 목록 |
|
||||||
|
| 우측 버튼 | **[서식 등록]** — 결재서식 등록 다이얼로그 오픈 |
|
||||||
|
|
||||||
|
### 4-2. 그리드 컬럼
|
||||||
|
|
||||||
|
| 컬럼명 | Field | 타입 | 비고 |
|
||||||
|
| ------------------ | -------------- | ------ | --------------------------------------- |
|
||||||
|
| 전자결재서식아이디 | `elaprTmpltId` | string | 등록 시 서버(DB 함수) 자동 발급 |
|
||||||
|
| 결재서식명 | `elaprTmpltNm` | string | |
|
||||||
|
| 문서구분 | `docSeComNm` | string | 코드 `docSeComCd`, 상위코드 `ASDOCSECD` |
|
||||||
|
| 등록일시 | `regDt` | string | `yyyy-MM-dd HH:mm:ss` |
|
||||||
|
| 관리 | — | — | 행별 **[수정] · [삭제]** 버튼 |
|
||||||
|
|
||||||
|
- 행 클릭 시: `elaprTmpltId` 선택 → 영역 B 라벨·B-2 그리드 갱신.
|
||||||
|
- 페이지네이션: Spring `Pageable` (`page`, `size`, `sort`).
|
||||||
|
|
||||||
|
### 4-3. 버튼
|
||||||
|
|
||||||
|
| 버튼명 | 위치 | 동작 |
|
||||||
|
| --------- | -------------- | ----------------------------------------------- |
|
||||||
|
| 서식 등록 | 섹션 우측 상단 | 결재서식 등록 다이얼로그 오픈 |
|
||||||
|
| 수정 | 행별 | 결재서식 수정 다이얼로그 (기존 값 초기화) |
|
||||||
|
| 삭제 | 행별 | 확인 후 삭제. 선택 중인 서식이면 영역 B 초기화. |
|
||||||
|
|
||||||
|
### 4-4. 다이얼로그(개요)
|
||||||
|
|
||||||
|
| 다이얼로그명 | 트리거 | 입력 항목 | 비고 |
|
||||||
|
| ------------------ | ----------- | ----------------------------------------------- | ----------------------------------------- |
|
||||||
|
| 결재서식 등록 | [서식 등록] | `elaprTmpltNm`, `docSeComCd` | `elaprTmpltExpln` 선택, ID는 저장 후 응답 |
|
||||||
|
| 결재서식 수정 | 행별 [수정] | `elaprTmpltNm`, `docSeComCd`, `elaprTmpltExpln` | ID는 변경 불가 |
|
||||||
|
| 결재서식 삭제 확인 | 행별 [삭제] | (확인/취소) | |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. 영역 B: 결재선 관리
|
||||||
|
|
||||||
|
영역 A에서 선택된 `elaprTmpltId` 기준으로 결재선을 관리한다. **등록·수정은 B-2 그리드 인라인 폼**으로 수행하며, 검토인력 지정만 **[선택]** 보조 다이얼로그를 사용한다.
|
||||||
|
|
||||||
|
### 5-1. 헤더 / 툴바
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| ----------- | --------------------------------------------------------------------------------------------------------------------------- |
|
||||||
|
| 섹션 타이틀 | 결재선 관리 |
|
||||||
|
| 우측 라벨 | `선택된 서식: {elaprTmpltId}` — 미선택 시 영역 B 비활성 |
|
||||||
|
| 우측 버튼 | **[행 추가]** — 편집 중인 행이 없을 때만 활성 · **[결재선 저장]** — 편집 중인 행이 없을 때만 활성(순서·미저장 행 일괄 반영) |
|
||||||
|
|
||||||
|
### 5-2. 영역 B-2: 결재선 그리드 (인라인 편집)
|
||||||
|
|
||||||
|
#### 그리드 컬럼
|
||||||
|
|
||||||
|
| 컬럼명 | Field | 입력 UI (편집 모드) | 비고 |
|
||||||
|
| ------------- | ------------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------- |
|
||||||
|
| (드래그 핸들) | — | — | `useSortable` 연동 |
|
||||||
|
| 결재선아이디 | `aplnId` | 읽기 전용 | 신규 행: `—`, 저장 후 서버 `aplnId` 표시 |
|
||||||
|
| 결재순서번호 | `atrzSeqNo` | 읽기 전용 (그리드 행 순서 1부터 표시) | 저장 시 행 순서 기준 자동 채번 |
|
||||||
|
| 결재구분 | `atrzSeComCd` | Select (`ATRZSECD` 공통코드) | 표시명 `atrzSeComNm` (조회 행) |
|
||||||
|
| 결재자 | `aprvrUuid` | 읽기 전용 이름 + **[선택]** 버튼 | 응답에 성명 없음 — 선택 시 로컬 `aprvrNm` 유지 |
|
||||||
|
| 등록일시 | `regDt` | 읽기 전용 | 신규 행은 `—` |
|
||||||
|
| 관리 | — | 편집 중인 행: **[저장] [취소]** · 조회 행: **[수정] [삭제]** (다른 행 편집 중이면 비활성) |
|
||||||
|
|
||||||
|
#### 인라인 편집 정책
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
|
||||||
|
| **단일 행 편집** | **행 추가 또는 한 행 수정 중에는 다른 행을 편집할 수 없다.** `editingRowId` 로 현재 편집 행 1건만 허용. |
|
||||||
|
| 편집 잠금 시 비활성 | 다른 행: 셀·[수정]·[삭제] 비활성 · `[행 추가]` 비활성 · 행 드래그 비활성 · (선택) `[결재선 저장]` 비활성 |
|
||||||
|
| 편집 해제 | 행별 **[저장]** 성공 또는 **[취소]** 시 `editingRowId` 초기화 후 전체 조회 모드 복귀 |
|
||||||
|
| 조회 행 | 편집 중이 아닐 때 읽기 전용. **[수정]** 클릭 시 해당 행만 편집 모드 진입 |
|
||||||
|
| 신규 행 | `[행 추가]` 시 맨 아래 편집 행 1건 생성 (`editingRowId` = 임시 키) |
|
||||||
|
| 필수값 | `atrzSeComCd`, `aprvrUuid` |
|
||||||
|
| 순서 중복 | 저장 시 행 순서로 자동 채번하므로 중복 없음 |
|
||||||
|
| 결재구분 코드 | `ATRZSECD` — 예: `ATRZ01` 검토자, `ATRZ02` 승인자, `ATRZ03` 최종승인자 |
|
||||||
|
| **순서 제약** | `ATRZ01`은 최상단 블록, `ATRZ03`은 최하단 블록. 드래그 종료·저장 시 `validateAtrzOrder`로 검증, 위반 시 적용/저장 불가 (결재구분 변경 시에는 미검증) |
|
||||||
|
| 저장 단위 | 행별 **[저장]** (단건 POST/PUT) 또는 툴바 **[결재선 저장]** (일괄) |
|
||||||
|
|
||||||
|
#### 행 드래그 정렬 (`@dnd-kit` + `useSortable`)
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| ---------- | ------------------------------------------------------------------------------------------------------- |
|
||||||
|
| 목적 | 결재 단계 순서를 그리드에서 직접 변경 |
|
||||||
|
| 라이브러리 | `@dnd-kit/core`, `@dnd-kit/sortable` — 테이블 행 POC 후 확정 |
|
||||||
|
| 저장 시점 | 드래그는 클라이언트 상태만 변경 → **[결재선 저장]** 또는 행별 **[저장]** 시 `atrzSeqNo` PUT |
|
||||||
|
| 편집 중 | `editingRowKey != null` 이면 드래그 **불가** |
|
||||||
|
| 순서 제약 | 드래그 종료 시 `validateAtrzOrder` — 실패하면 순서 변경 미적용 + 안내. 결재구분 미선택 행은 드래그 불가 |
|
||||||
|
|
||||||
|
### 5-3. 보조 다이얼로그 (검토인력만)
|
||||||
|
|
||||||
|
| 다이얼로그명 | 트리거 | 결과 |
|
||||||
|
| ------------- | ----------------------- | ---------------------------------- |
|
||||||
|
| 검토인력 선택 | 그리드 결재자 셀 [선택] | `aprvrUuid` 및 UI용 `aprvrNm` 반영 |
|
||||||
|
|
||||||
|
> 결재자 **등록·수정 다이얼로그는 사용하지 않음** (v0.2 변경).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. API/DTO 명세
|
||||||
|
|
||||||
|
### 6-1. 공통
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| ----------- | ------------------------------------------------------------- |
|
||||||
|
| 서비스 | `as-elapr-service` |
|
||||||
|
| Base prefix | `/as-elapr-service/api/v1` (프록시 경유) |
|
||||||
|
| 인증 | JWT (`Authorization` 헤더) |
|
||||||
|
| 페이징 | Spring `Pageable`: `page`, `size`, `sort` → `PageResponse<T>` |
|
||||||
|
| 엔티티 | `@/entities/elapr` (`elaprTmpltService`, `elaprAplnService`) |
|
||||||
|
|
||||||
|
### 6-2. 전자결재서식 (영역 A) — `elapr-tmplt`
|
||||||
|
|
||||||
|
| 기능 | Method | URL | Request / Query | Response | 클라이언트 |
|
||||||
|
| --------- | ------ | ----------------------------- | ------------------------------------------ | ------------------ | ---------------------------- |
|
||||||
|
| 목록 조회 | GET | `/elapr-tmplt` | Query: `ElaprTmpltSearchParams` + Pageable | `Page<ElaprTmplt>` | `elaprTmpltService.findPage` |
|
||||||
|
| 단건 조회 | GET | `/elapr-tmplt/{elaprTmpltId}` | — | `ElaprTmplt` | `elaprTmpltService.findById` |
|
||||||
|
| 등록 | POST | `/elapr-tmplt` | `ElaprTmpltSaveRequest` | `ElaprTmplt` (201) | `elaprTmpltService.create` |
|
||||||
|
| 수정 | PUT | `/elapr-tmplt/{elaprTmpltId}` | `ElaprTmpltUpdateRequest` | `ElaprTmplt` | `elaprTmpltService.update` |
|
||||||
|
| 삭제 | DELETE | `/elapr-tmplt/{elaprTmpltId}` | — | 204 | `elaprTmpltService.remove` |
|
||||||
|
|
||||||
|
**ElaprTmplt (응답)**
|
||||||
|
|
||||||
|
| Field | 타입 | 설명 |
|
||||||
|
| ----------------- | ------- | ------------------ |
|
||||||
|
| `elaprTmpltId` | string | 전자결재서식아이디 |
|
||||||
|
| `elaprTmpltNm` | string | 결재서식명 |
|
||||||
|
| `elaprTmpltExpln` | string? | 서식 설명 |
|
||||||
|
| `docSeComCd` | string? | 문서구분 코드 |
|
||||||
|
| `docSeComNm` | string? | 문서구분명 |
|
||||||
|
| `regDt` | string? | 등록일시 |
|
||||||
|
|
||||||
|
**ElaprTmpltSaveRequest**: `elaprTmpltNm`\_, `elaprTmpltExpln?`, `docSeComCd?`
|
||||||
|
|
||||||
|
**ElaprTmpltUpdateRequest**: `elaprTmpltNm`\*, `elaprTmpltExpln?`, `docSeComCd?`
|
||||||
|
|
||||||
|
**ElaprTmpltSearchParams**: `elaprTmpltNm?`, `docSeComCd?`, `regDtStart?`, `regDtEnd?` + `page`, `size`, `sort`
|
||||||
|
|
||||||
|
### 6-3. 결재선 (영역 B) — `elapr-apln`
|
||||||
|
|
||||||
|
| 기능 | Method | URL | Request / Query | Response | 클라이언트 |
|
||||||
|
| --------- | ------ | ---------------------- | ------------------------------- | ----------------- | --------------------------- |
|
||||||
|
| 목록 조회 | GET | `/elapr-apln` | Query: `elaprTmpltId`, Pageable | `Page<ElaprApln>` | `elaprAplnService.findPage` |
|
||||||
|
| 단건 조회 | GET | `/elapr-apln/{aplnId}` | — | `ElaprApln` | `elaprAplnService.findById` |
|
||||||
|
| 등록 | POST | `/elapr-apln` | `ElaprAplnSaveRequest` | `ElaprApln` (201) | `elaprAplnService.create` |
|
||||||
|
| 수정 | PUT | `/elapr-apln/{aplnId}` | `ElaprAplnUpdateRequest` | `ElaprApln` | `elaprAplnService.update` |
|
||||||
|
| 삭제 | DELETE | `/elapr-apln/{aplnId}` | — | 204 | `elaprAplnService.remove` |
|
||||||
|
|
||||||
|
> **일괄 저장 API 없음** — UI의 [결재선 저장]은 변경된 행에 대해 POST/PUT을 순차(또는 병렬) 호출하는 클라이언트 오케스트레이션으로 구현.
|
||||||
|
|
||||||
|
**ElaprApln (응답)**
|
||||||
|
|
||||||
|
| Field | 타입 | 설명 |
|
||||||
|
| -------------- | ------- | ------------------ |
|
||||||
|
| `aplnId` | string | 결재선아이디 |
|
||||||
|
| `elaprTmpltId` | string | 전자결재서식아이디 |
|
||||||
|
| `aprvrUuid` | string? | 결재자 UUID |
|
||||||
|
| `atrzSeComCd` | string? | 결재구분 코드 |
|
||||||
|
| `atrzSeComNm` | string? | 결재구분명 |
|
||||||
|
| `atrzSeqNo` | number? | 결재순서번호 |
|
||||||
|
| `regDt` | string? | 등록일시 |
|
||||||
|
|
||||||
|
**ElaprAplnSaveRequest**: `elaprTmpltId`\_, `aprvrUuid?`, `atrzSeComCd?`, `atrzSeqNo?`
|
||||||
|
|
||||||
|
**ElaprAplnUpdateRequest**: `elaprTmpltId`\*, `aprvrUuid?`, `atrzSeComCd?`, `atrzSeqNo?`
|
||||||
|
|
||||||
|
### 6-4. 검토인력 (보조)
|
||||||
|
|
||||||
|
| 기능 | Method | URL | 비고 |
|
||||||
|
| ------------------ | ------ | --- | --------------------------- |
|
||||||
|
| 검토인력 목록 조회 | TBD | TBD | 사용자 서비스 또는 별도 API |
|
||||||
|
|
||||||
|
### 6-5. Backend ↔ 화면 필드 매핑 (구 SPEC 대비)
|
||||||
|
|
||||||
|
| 구 SPEC 필드 | 백엔드 필드 |
|
||||||
|
| ----------------- | ---------------------------------------------------- |
|
||||||
|
| `elctAtrzTmpltId` | `elaprTmpltId` |
|
||||||
|
| `atrzTmpltNm` | `elaprTmpltNm` |
|
||||||
|
| `docSeNm` | `docSeComNm` |
|
||||||
|
| `atrzLineId` | `aplnId` |
|
||||||
|
| `atrzSeNm` | `atrzSeComNm` |
|
||||||
|
| `atrzUserNm` | (없음) `aprvrUuid` + 사용자 조회/선택 시 로컬 표시명 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. UI 구현 가이드
|
||||||
|
|
||||||
|
### 7-1. 기술 스택·원칙
|
||||||
|
|
||||||
|
- **공통 컴포넌트**: `@common/components`
|
||||||
|
- **테이블**: `@tanstack/react-table` + 인라인 편집 셀 (`Select`, `Input`, `Button`)
|
||||||
|
- **드래그**: `@dnd-kit` — B-2 행 정렬 (POC 필수)
|
||||||
|
- **데이터**: React Query — `@/entities/elapr` hooks
|
||||||
|
- **상태**: 선택된 `elaprTmpltId`, `editingRowId` (단일 행 편집 잠금), B-2 행 배열(dirty·신규·`aprvrNm`·수정 전 스냅샷)
|
||||||
|
- **모의 데이터**: API 연동 전 `@faker-js/faker`
|
||||||
|
|
||||||
|
### 7-2. 모듈·파일 배치(제안)
|
||||||
|
|
||||||
|
| 구분 | 경로 |
|
||||||
|
| ------ | -------------------------------------------------------------------------------------- |
|
||||||
|
| 라우트 | `apps/as/app/(with-base-layout)/approval-line-management/page.tsx` |
|
||||||
|
| 페이지 | `apps/as/src/pages/approval-line-management/` (Public API: page만 export) |
|
||||||
|
| UI | `.../ui/elapr-tmplt-list.tsx`, `elapr-tmplt-form-dialog.tsx`, `elapr-apln-grid.tsx` 등 |
|
||||||
|
| model | `.../model/columns.tsx`, `apln-row-types.ts`, `mock-reviewers.ts` |
|
||||||
|
| lib | `.../lib/use-apln-rows.ts`, `validators.ts`, `use-dnd-sensors.ts` |
|
||||||
|
| 엔티티 | `apps/as/src/entities/elapr/` |
|
||||||
|
|
||||||
|
### 7-3. 영역별 UI 매핑
|
||||||
|
|
||||||
|
| 영역 | 주요 UI |
|
||||||
|
| ------ | -------------------------------------------------------------------------------------------- |
|
||||||
|
| A | DataTable + 행 선택 + 서식 등록/수정 다이얼로그 |
|
||||||
|
| B 헤더 | 상태 라벨 + `행 추가`, `결재선 저장` |
|
||||||
|
| B-2 | 인라인 편집 DataTable + `editingRowId` 단일 행 잠금 + 드래그 핸들 + 행별 수정/저장/삭제/취소 |
|
||||||
|
| 공통 | 서식 Dialog, 검토인력 선택 Dialog만 |
|
||||||
|
|
||||||
|
### 7-4. 데이터 흐름(요약)
|
||||||
|
|
||||||
|
- **진입**: `useElaprTmpltPage` → 영역 A. B 비활성.
|
||||||
|
- **서식 선택**: `useElaprAplnPage({ elaprTmpltId })` → B-2.
|
||||||
|
- **행 추가**: `editingRowId` 없을 때만 가능 → 신규 행 1건 편집 잠금 → 저장/취소 후 해제.
|
||||||
|
- **인라인 수정**: [수정]으로 `editingRowId` 설정 → 해당 행만 편집 → `useUpdateElaprApln` 후 해제.
|
||||||
|
- **드래그**: `editingRowId == null` 일 때만 가능 → 로컬 `atrzSeqNo` 재부여 → 일괄 PUT.
|
||||||
|
- **삭제**: `useDeleteElaprApln` 또는 신규 행 로컬 제거.
|
||||||
|
|
||||||
|
### 7-5. 미확정 / 검증 필요
|
||||||
|
|
||||||
|
- 검토인력 API 경로·DTO.
|
||||||
|
- `@dnd-kit` + react-table 행 인라인 Input 동시 적용 POC.
|
||||||
|
- 결재자 성명 표시: `aprvrUuid` → 사용자명 조회 API.
|
||||||
|
- 영역 A·B 페이지네이션·검색 UI 노출 여부.
|
||||||
|
- 권한(역할별 CRUD).
|
||||||
@@ -0,0 +1,487 @@
|
|||||||
|
# 화면설계서: 체크리스트관리
|
||||||
|
|
||||||
|
## 1. 기본 정보
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| ---------- | -------------------------------------------- |
|
||||||
|
| 버전 | 0.1 |
|
||||||
|
| 프로세스명 | UI설계 |
|
||||||
|
| 화면명 | 체크리스트관리 |
|
||||||
|
| 화면 유형 | [v] 조회 [v] 입력 [v] 수정 [v] 삭제 [ ] 출력 |
|
||||||
|
| 메뉴 경로 | 디지털행정지원 > 시스템관리 > 체크리스트관리 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 화면 목적
|
||||||
|
|
||||||
|
업무별·문서별 **점검표**(체크리스트)를 등록·관리하고, **점검항목** 마스터를 유지한다. 상단 좌측에서 점검표를 선택하면 하단 **체크리스트 항목** 영역에 해당 점검표의 검토 구성(계층형 검토내용)을 편집한다. 상단 우측 **점검항목 관리**는 점검표에 연결할 항목 풀을 등록·수정·삭제한다.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 화면 구성
|
||||||
|
|
||||||
|
### 3-1. 전체 레이아웃
|
||||||
|
|
||||||
|
```
|
||||||
|
┌───────────────────────────────────────────────────────────────────────────────────────────────┐
|
||||||
|
│ 페이지 타이틀: 체크리스트관리 브레드크럼: 디지털행정지원 > … > │
|
||||||
|
├──────────────────────────────────────────────┬────────────────────────────────────────────────┤
|
||||||
|
│ [영역 A] 점검표 관리 │ [영역 B] 점검항목 관리 │
|
||||||
|
│ [점검표 추가] │ [점검항목 추가] │
|
||||||
|
│ ┌────────────────────────────────────────┐ │ ┌──────────────────────────────────────────┐ │
|
||||||
|
│ │ 점검표일련번호 | 점검표명 | 문서구분 │ │ │ 점검항목코드 | 점검항목명 | 사용여부 │ │
|
||||||
|
│ │ 업무구분 | 사용여부 | 등록일시 | 관리 │ │ │ 등록일시 | 관리 │ │
|
||||||
|
│ ├────────────────────────────────────────┤ │ ├──────────────────────────────────────────┤ │
|
||||||
|
│ │ 1 (선택 행 강조) [관리] [삭제] │ │ │ ITEM_001 요건검토 … [관리][삭제] │ │
|
||||||
|
│ │ │ │ │ ITEM_002 법령검토 … [관리][삭제] │ │
|
||||||
|
│ └────────────────────────────────────────┘ │ └──────────────────────────────────────────┘ │
|
||||||
|
├──────────────────────────────────────────────┴────────────────────────────────────────────────┤
|
||||||
|
│ [영역 C] 체크리스트 항목 [미리보기] [추가] [저장] │
|
||||||
|
│ ┌─────────────────────────────────────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ 점검항목 ▼ | 주요 검토내용 | 사용 여부 | 구분 | 관리 │ │
|
||||||
|
│ │ L1 [요건검토 ▼] | (입력) | ○예 ○아니오 | 1단계 | [하위추가]│ │
|
||||||
|
│ │ L2 [요건검토 ▼] | (입력) | ○예 ○아니오 | 2단계 | [삭제] │ │
|
||||||
|
│ └─────────────────────────────────────────────────────────────────────────────────────────┘ │
|
||||||
|
└───────────────────────────────────────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3-2. 화면 데이터 흐름
|
||||||
|
|
||||||
|
```
|
||||||
|
BEGIN
|
||||||
|
|
||||||
|
// 최초 진입
|
||||||
|
CALL GET /as-checklist-service/api/v1/cklst
|
||||||
|
DISPLAY 점검표 그리드 (영역 A)
|
||||||
|
CALL GET /as-checklist-service/api/v1/cklst-artcl
|
||||||
|
DISPLAY 점검항목 그리드 (영역 B)
|
||||||
|
DISPLAY 빈 상태 안내 (영역 C) // 점검표 미선택 시 C 비활성
|
||||||
|
|
||||||
|
// 영역 A: 점검표 행 선택
|
||||||
|
ON 영역 A 행 CLICK DO
|
||||||
|
SET 선택된 점검표 = 행.cklstSn
|
||||||
|
CALL GET /as-checklist-service/api/v1/cklst-rvw?cklstSn={cklstSn}
|
||||||
|
// TBD: 점검표 단위 전체 검토 트리 조회 API — 현재는 항목별 by-artcl 조합 또는 클라이언트 병합
|
||||||
|
DISPLAY 체크리스트 항목 그리드 (영역 C)
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 A: 점검표 추가
|
||||||
|
ON [점검표 추가] 버튼 CLICK DO
|
||||||
|
OPEN 점검표 추가 다이얼로그
|
||||||
|
ON [저장] DO
|
||||||
|
VALIDATE cklstNm, taskSeComCd
|
||||||
|
CALL POST /as-checklist-service/api/v1/cklst
|
||||||
|
CALL GET /as-checklist-service/api/v1/cklst
|
||||||
|
CLOSE 다이얼로그
|
||||||
|
END ON
|
||||||
|
ON [취소] / [닫기] DO
|
||||||
|
CLOSE 다이얼로그
|
||||||
|
END ON
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 A: 점검표 수정·삭제
|
||||||
|
ON 영역 A 행 [관리] CLICK DO
|
||||||
|
OPEN 점검표 수정 다이얼로그 (기존 값 초기화)
|
||||||
|
ON [저장] DO
|
||||||
|
CALL PUT /as-checklist-service/api/v1/cklst/{cklstSn}
|
||||||
|
CALL GET /as-checklist-service/api/v1/cklst
|
||||||
|
END ON
|
||||||
|
END ON
|
||||||
|
|
||||||
|
ON 영역 A 행 [삭제] CLICK DO
|
||||||
|
CONFIRM "선택한 점검표를 삭제하시겠습니까?"
|
||||||
|
CALL DELETE /as-checklist-service/api/v1/cklst/{cklstSn}
|
||||||
|
IF 삭제 대상 == 선택된 점검표 THEN RESET 영역 C
|
||||||
|
CALL GET /as-checklist-service/api/v1/cklst
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 B: 점검항목 추가
|
||||||
|
ON [점검항목 추가] 버튼 CLICK DO
|
||||||
|
OPEN 점검항목 추가 다이얼로그
|
||||||
|
ON [저장] DO
|
||||||
|
VALIDATE cklstArtclNm
|
||||||
|
// TBD: cklstSn 필수 — UI에 소속 점검표 선택 없음. 백엔드 정책 확인
|
||||||
|
CALL POST /as-checklist-service/api/v1/cklst-artcl
|
||||||
|
CALL GET /as-checklist-service/api/v1/cklst-artcl
|
||||||
|
CLOSE 다이얼로그
|
||||||
|
END ON
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 B: 점검항목 수정·삭제
|
||||||
|
ON 영역 B 행 [관리] CLICK DO
|
||||||
|
OPEN 점검항목 수정 다이얼로그
|
||||||
|
ON [저장] DO
|
||||||
|
CALL PUT /as-checklist-service/api/v1/cklst-artcl/{cklstArtclSn}/{cklstSn}
|
||||||
|
END ON
|
||||||
|
END ON
|
||||||
|
|
||||||
|
ON 영역 B 행 [삭제] CLICK DO
|
||||||
|
CONFIRM "선택한 점검항목을 삭제하시겠습니까?"
|
||||||
|
CALL DELETE /as-checklist-service/api/v1/cklst-artcl/{cklstArtclSn}/{cklstSn}
|
||||||
|
CALL GET /as-checklist-service/api/v1/cklst-artcl
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 C: 검토 행 추가
|
||||||
|
ON [추가] 버튼 CLICK DO
|
||||||
|
VALIDATE 선택된 점검표 존재
|
||||||
|
ADD 영역 C 그리드 맨 아래 편집 가능 행 (1단계, rvwCnLvNo=1)
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 C: 하위 검토 추가
|
||||||
|
ON 행 [하위추가] CLICK DO
|
||||||
|
ADD 부모행 하위 편집 행 (2단계, upCklstRvwSn=부모.cklstRvwSn, rvwCnLvNo=2)
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 C: 일괄 저장
|
||||||
|
ON [저장] 버튼 CLICK DO
|
||||||
|
VALIDATE 선택된 점검표 존재
|
||||||
|
FOR EACH 신규·변경된 검토 행 DO
|
||||||
|
IF 신규 THEN
|
||||||
|
CALL POST /as-checklist-service/api/v1/cklst-rvw
|
||||||
|
ELSE
|
||||||
|
CALL PUT /as-checklist-service/api/v1/cklst-rvw/{cklstRvwSn}/{cklstArtclSn}/{cklstSn}
|
||||||
|
END IF
|
||||||
|
END FOR
|
||||||
|
CALL GET /as-checklist-service/api/v1/cklst-rvw?cklstSn={cklstSn}
|
||||||
|
TOAST "체크리스트 항목이 저장되었습니다."
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 C: 행 삭제
|
||||||
|
ON 행 [삭제] CLICK DO
|
||||||
|
CONFIRM "선택한 항목을 삭제하시겠습니까?"
|
||||||
|
IF 서버 저장된 행 THEN
|
||||||
|
CALL DELETE /as-checklist-service/api/v1/cklst-rvw/{cklstRvwSn}/{cklstArtclSn}/{cklstSn}
|
||||||
|
END IF
|
||||||
|
REMOVE 그리드 행 (미저장 행은 API 호출 없이 제거)
|
||||||
|
END ON
|
||||||
|
|
||||||
|
// 영역 C: 미리보기
|
||||||
|
ON [미리보기] 버튼 CLICK DO
|
||||||
|
OPEN 체크리스트 미리보기 다이얼로그 (읽기 전용 트리)
|
||||||
|
// TBD: 미리보기 UI·API
|
||||||
|
END ON
|
||||||
|
|
||||||
|
END
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 영역 A: 점검표 관리
|
||||||
|
|
||||||
|
선택된 점검표가 영역 C의 편집 대상이 된다. 행 클릭으로 선택 상태를 표시한다.
|
||||||
|
|
||||||
|
### 4-1. 헤더 / 툴바
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| ----------- | ------------------------------------------ |
|
||||||
|
| 섹션 타이틀 | 점검표 관리 |
|
||||||
|
| 우측 버튼 | **[점검표 추가]** — 점검표 등록 다이얼로그 |
|
||||||
|
|
||||||
|
### 4-2. 그리드 컬럼
|
||||||
|
|
||||||
|
| 컬럼명 | Field | 타입 | 비고 |
|
||||||
|
| ---------------- | ------------- | ------ | ---------------------------------------------------- |
|
||||||
|
| 점검표일련번호 | `cklstSn` | number | PK |
|
||||||
|
| 점검표명 | `cklstNm` | string | |
|
||||||
|
| 문서구분공통코드 | `docSeComCd` | string | 코드명 표시 — `ASDOCSECD` 등 공통코드 (TBD 상위코드) |
|
||||||
|
| 업무구분공통코드 | `taskSeComCd` | string | RE/SF/SP 등 — 공통코드 (TBD 상위코드) |
|
||||||
|
| 사용여부 | `useYn` | string | `Y`→예, `N`→아니오 |
|
||||||
|
| 등록일시 | `regDt` | string | `yyyy-MM-dd HH:mm:ss` |
|
||||||
|
| 관리 | — | — | 행별 **[관리] · [삭제]** |
|
||||||
|
|
||||||
|
- 행 클릭 시: `cklstSn` 선택 → 영역 C 헤더·그리드 갱신.
|
||||||
|
- 페이지네이션: Spring `Pageable` (`page`, `size`, `sort`).
|
||||||
|
|
||||||
|
### 4-3. 버튼
|
||||||
|
|
||||||
|
| 버튼명 | 위치 | 동작 |
|
||||||
|
| ----------- | -------------- | ------------------------------------------------- |
|
||||||
|
| 점검표 추가 | 섹션 우측 상단 | 점검표 추가 다이얼로그 오픈 |
|
||||||
|
| 관리 | 행별 | 점검표 수정 다이얼로그 (기존 값 초기화) |
|
||||||
|
| 삭제 | 행별 | 확인 후 삭제. 선택 중인 점검표이면 영역 C 초기화. |
|
||||||
|
|
||||||
|
### 4-4. 다이얼로그: 점검표 추가 / 수정
|
||||||
|
|
||||||
|
| 표시명 | 입력 유형 | 필수 | 기본값 | API 파라미터 매핑 | 비고 |
|
||||||
|
| -------- | ---------------- | ---- | ------ | ----------------- | ------------------------------------------------ |
|
||||||
|
| 점검표명 | Text | Y | — | `cklstNm` | placeholder: "예: 설치인가 체크리스트" |
|
||||||
|
| 문서구분 | Select(공통코드) | N | — | `docSeComCd` | 예: FNRS, INSTL, PWRK, DESIGN |
|
||||||
|
| 업무구분 | Select(공통코드) | Y | — | `taskSeComCd` | 예: RE(재이용수), SF(하수처리시설), SP(하수관로) |
|
||||||
|
| 사용여부 | Select | N | Y | `useYn` | Y/N, UI 표시: 예/아니오 |
|
||||||
|
|
||||||
|
| 버튼명 | 동작 |
|
||||||
|
| ------ | -------------------------------------- |
|
||||||
|
| 저장 | POST(등록) 또는 PUT(수정) 후 목록 갱신 |
|
||||||
|
| 취소 | 다이얼로그 닫기, 입력값 폐기 |
|
||||||
|
| 닫기 | 다이얼로그 닫기 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. 영역 B: 점검항목 관리
|
||||||
|
|
||||||
|
점검표 하단(영역 C)에서 선택할 **점검항목** 마스터를 관리한다.
|
||||||
|
|
||||||
|
### 5-1. 헤더 / 툴바
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| ----------- | ---------------------------------------------- |
|
||||||
|
| 섹션 타이틀 | 점검항목 관리 |
|
||||||
|
| 우측 버튼 | **[점검항목 추가]** — 점검항목 등록 다이얼로그 |
|
||||||
|
|
||||||
|
### 5-2. 그리드 컬럼
|
||||||
|
|
||||||
|
| 컬럼명 | Field | 타입 | 비고 |
|
||||||
|
| ------------ | -------------- | ------ | ------------------------------------- |
|
||||||
|
| 점검항목코드 | `cklstArtclSn` | number | UI mock `ITEM_001` 형식 표시 여부 TBD |
|
||||||
|
| 점검항목명 | `cklstArtclNm` | string | |
|
||||||
|
| 사용여부 | `useYn` | string | `Y`→예, `N`→아니오 |
|
||||||
|
| 등록일시 | `regDt` | string | `yyyy-MM-dd HH:mm:ss` |
|
||||||
|
| 관리 | — | — | 행별 **[관리] · [삭제]** |
|
||||||
|
|
||||||
|
> **TBD**: 백엔드 `CklstArtcl`은 복합 PK(`cklstArtclSn`, `cklstSn`)이며 등록 시 `cklstSn` 필수. UI 다이얼로그에는 `cklstSn` 입력이 없음 — 소속 점검표 지정 방식·전역 마스터 여부 백엔드 정책 확인.
|
||||||
|
|
||||||
|
### 5-3. 다이얼로그: 점검항목 추가 / 수정
|
||||||
|
|
||||||
|
| 표시명 | 입력 유형 | 필수 | 기본값 | API 파라미터 매핑 | 비고 |
|
||||||
|
| ---------- | --------- | ---- | ------ | ----------------- | --------------------------- |
|
||||||
|
| 점검항목명 | Text | Y | — | `cklstArtclNm` | placeholder: "예: 법령검토" |
|
||||||
|
| 사용여부 | Select | N | Y | `useYn` | Y/N |
|
||||||
|
|
||||||
|
| 버튼명 | 동작 |
|
||||||
|
| ------ | -------------------------------------- |
|
||||||
|
| 저장 | POST(등록) 또는 PUT(수정) 후 목록 갱신 |
|
||||||
|
| 취소 | 다이얼로그 닫기 |
|
||||||
|
| 닫기 | 다이얼로그 닫기 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. 영역 C: 체크리스트 항목 (선택된 점검표)
|
||||||
|
|
||||||
|
영역 A에서 선택된 `cklstSn` 기준으로 **점검표검토**(계층형 검토내용)를 구성한다.
|
||||||
|
|
||||||
|
### 6-1. 헤더 / 툴바
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| ----------- | -------------------------------------------------------------------- |
|
||||||
|
| 섹션 타이틀 | 체크리스트 항목 (선택된 점검표: {cklstNm}) |
|
||||||
|
| 우측 버튼 | **[미리보기]** · **[추가]** · **[저장]** — 점검표 미선택 시 C 비활성 |
|
||||||
|
|
||||||
|
### 6-2. 그리드 컬럼
|
||||||
|
|
||||||
|
| 컬럼명 | Field | 입력 UI | 비고 |
|
||||||
|
| ------------- | -------------- | ------------------------------------- | ------------------------------------ |
|
||||||
|
| 점검항목 | `cklstArtclSn` | Select (영역 B 항목 목록) | L1/L2 접두 표시, `cklstArtclNm` 라벨 |
|
||||||
|
| 주요 검토내용 | `rvwCn` | Text / Textarea | 최대 4000자 |
|
||||||
|
| 사용 여부 | `useYn` | Radio (예/아니오) | `Y` / `N` |
|
||||||
|
| 구분 | `rvwCnLvNo` | 읽기 전용 | 1→1단계, 2→2단계, 3→3단계 |
|
||||||
|
| 관리 | — | **[하위추가]** (1·2단계, 저장 후) · **[삭제]** | 3단계 행은 [하위추가] 미표시 |
|
||||||
|
|
||||||
|
#### 계층 정책
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| -------------- | -------------------------------------------------------------------- |
|
||||||
|
| 최대 깊이 | 3단계 (`rvwCnLvNo`: 1, 2, 3) |
|
||||||
|
| 상위-하위 연결 | `upCklstRvwSn` — 2단계 행은 부모 1단계 `cklstRvwSn` 참조 |
|
||||||
|
| 정렬 | `sortSeq` — 동일 레벨 내 순서 (TBD: UI 드래그 정렬 여부) |
|
||||||
|
| 체크 사용 | `bchckUseYn` — 미리보기·실사용 화면 체크박스 노출 여부 (TBD UI 반영) |
|
||||||
|
|
||||||
|
### 6-3. 버튼
|
||||||
|
|
||||||
|
| 버튼명 | 동작 |
|
||||||
|
| -------- | ---------------------------------------------------- |
|
||||||
|
| 추가 | 1단계 검토 행 1건 추가 (편집 가능) |
|
||||||
|
| 저장 | 변경·신규 검토 행 일괄 POST/PUT (일괄 저장 API 없음) |
|
||||||
|
| 미리보기 | 선택 점검표 체크리스트 읽기 전용 미리보기 (TBD) |
|
||||||
|
| 하위추가 | 선택 1·2단계 행 아래 하위 단계(2·3단계) 자식 행 추가 |
|
||||||
|
| 삭제 | 확인 후 DELETE 또는 미저장 행 로컬 제거 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. API/DTO 명세
|
||||||
|
|
||||||
|
### 7-1. 공통
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
| ------------- | ------------------------------------------------------------- |
|
||||||
|
| 서비스 | `as-checklist-service` |
|
||||||
|
| Base prefix | `/as-checklist-service/api/v1` (게이트웨이 프록시 경유) |
|
||||||
|
| 인증 | JWT (`Authorization` 헤더), `X-Site-Id`, `token-id` |
|
||||||
|
| 페이징 | Spring `Pageable`: `page`, `size`, `sort` → `PageResponse<T>` |
|
||||||
|
| 엔티티 | `@/entities/cklst` (`cklstMngService`, `cklstArtclService`, `cklstRvwService`) |
|
||||||
|
|
||||||
|
### 7-2. 점검표 (영역 A) — `cklst`
|
||||||
|
|
||||||
|
| 기능 | Method | URL | Request / Query | Response | 클라이언트 |
|
||||||
|
| --------- | ------ | ------------------ | --------------------------------- | ------------------ | -------------------------- |
|
||||||
|
| 목록 조회 | GET | `/cklst` | `CklstMngSearchParams` + Pageable | `Page<CklstMng>` | `cklstMngService.findPage` |
|
||||||
|
| 단건 조회 | GET | `/cklst/{cklstSn}` | — | `CklstMng` | `cklstMngService.findById` |
|
||||||
|
| 등록 | POST | `/cklst` | `CklstMngSaveRequest` | `number` (cklstSn) | `cklstMngService.create` |
|
||||||
|
| 수정 | PUT | `/cklst/{cklstSn}` | `CklstMngSaveRequest` | `number` (cklstSn) | `cklstMngService.update` |
|
||||||
|
| 삭제 | DELETE | `/cklst/{cklstSn}` | — | `number` (cklstSn) | `cklstMngService.remove` |
|
||||||
|
|
||||||
|
**CklstMng (응답)**
|
||||||
|
|
||||||
|
| Field | 타입 | 설명 |
|
||||||
|
| ------------- | ------- | ---------------- |
|
||||||
|
| `cklstSn` | number | 점검표일련번호 |
|
||||||
|
| `cklstNm` | string | 점검표명 |
|
||||||
|
| `taskSeComCd` | string | 업무구분공통코드 |
|
||||||
|
| `useYn` | string? | 사용여부 |
|
||||||
|
| `docSeComCd` | string? | 문서구분공통코드 |
|
||||||
|
| `rgtr` | string? | 등록자 UUID |
|
||||||
|
| `rgtrNm` | string? | 등록자명 |
|
||||||
|
| `mdfr` | string? | 수정자 UUID |
|
||||||
|
| `regDt` | string? | 등록일시 |
|
||||||
|
| `mdfcnDt` | string? | 수정일시 |
|
||||||
|
|
||||||
|
**CklstMngSaveRequest**: `cklstNm`\*, `taskSeComCd`\*, `useYn?`, `docSeComCd?`
|
||||||
|
|
||||||
|
**CklstMngSearchParams**: `cklstNm?`, `taskSeComCd?`, `useYn?`, `docSeComCd?` + `page`, `size`, `sort`
|
||||||
|
|
||||||
|
**React Query hooks**: `useCklstMngPage`, `useCklstMng`, `useCreateCklstMng`, `useUpdateCklstMng`, `useDeleteCklstMng`
|
||||||
|
|
||||||
|
### 7-3. 점검표항목 (영역 B) — `cklst-artcl`
|
||||||
|
|
||||||
|
| 기능 | Method | URL | Request / Query | Response | 클라이언트 |
|
||||||
|
| ------------------ | ------ | --------------------------------------- | ----------------------------------- | ------------------ | --------------------------------- |
|
||||||
|
| 목록 조회 (페이징) | GET | `/cklst-artcl` | `CklstArtclSearchParams` + Pageable | `Page<CklstArtcl>` | `cklstArtclService.findPage` |
|
||||||
|
| 점검표별 전체 목록 | GET | `/cklst-artcl/by-cklst/{cklstSn}` | — | `CklstArtcl[]` | `cklstArtclService.findByCklstSn` |
|
||||||
|
| 단건 조회 | GET | `/cklst-artcl/{cklstArtclSn}/{cklstSn}` | — | `CklstArtcl` | `cklstArtclService.findById` |
|
||||||
|
| 등록 | POST | `/cklst-artcl` | `CklstArtclSaveRequest` | `CklstArtclId` | `cklstArtclService.create` |
|
||||||
|
| 수정 | PUT | `/cklst-artcl/{cklstArtclSn}/{cklstSn}` | `CklstArtclUpdateRequest` | `CklstArtclId` | `cklstArtclService.update` |
|
||||||
|
| 삭제 | DELETE | `/cklst-artcl/{cklstArtclSn}/{cklstSn}` | — | `CklstArtclId` | `cklstArtclService.remove` |
|
||||||
|
|
||||||
|
**CklstArtcl (응답)**
|
||||||
|
|
||||||
|
| Field | 타입 | 설명 |
|
||||||
|
| ----------------- | ------- | ------------------ |
|
||||||
|
| `cklstArtclSn` | number | 점검표항목일련번호 |
|
||||||
|
| `cklstSn` | number | 점검표일련번호 |
|
||||||
|
| `cklstArtclNm` | string? | 점검표항목명 |
|
||||||
|
| `useYn` | string? | 사용여부 |
|
||||||
|
| `rgtr` / `rgtrNm` | string? | 등록자 |
|
||||||
|
| `regDt` | string? | 등록일시 |
|
||||||
|
|
||||||
|
**CklstArtclSaveRequest**: `cklstSn`\*, `cklstArtclNm?`, `useYn?`
|
||||||
|
|
||||||
|
**CklstArtclUpdateRequest**: `cklstArtclNm?`, `useYn?`
|
||||||
|
|
||||||
|
**CklstArtclId**: `{ cklstArtclSn: number; cklstSn: number }`
|
||||||
|
|
||||||
|
**React Query hooks**: `useCklstArtclPage`, `useCklstArtclList`, `useCklstArtcl`, `useCreateCklstArtcl`, `useUpdateCklstArtcl`, `useDeleteCklstArtcl`
|
||||||
|
|
||||||
|
### 7-4. 점검표검토 (영역 C) — `cklst-rvw`
|
||||||
|
|
||||||
|
| 기능 | Method | URL | Request / Query | Response | 클라이언트 |
|
||||||
|
| --------------------- | ------ | -------------------------------------------------- | ------------------------------ | ---------------- | ------------------------------- |
|
||||||
|
| 목록 조회 (페이징) | GET | `/cklst-rvw` | `CklstRvwSearchParams` + Pageable | `Page<CklstRvw>` | `cklstRvwService.findPage` |
|
||||||
|
| 항목별 검토 전체 목록 | GET | `/cklst-rvw/by-artcl/{cklstSn}/{cklstArtclSn}` | — | `CklstRvw[]` | `cklstRvwService.findByArtcl` |
|
||||||
|
| 단건 조회 | GET | `/cklst-rvw/{cklstRvwSn}/{cklstArtclSn}/{cklstSn}` | — | `CklstRvw` | `cklstRvwService.findById` |
|
||||||
|
| 등록 | POST | `/cklst-rvw` | `CklstRvwSaveRequest` | `CklstRvwId` | `cklstRvwService.create` |
|
||||||
|
| 수정 | PUT | `/cklst-rvw/{cklstRvwSn}/{cklstArtclSn}/{cklstSn}` | `CklstRvwUpdateRequest` | `CklstRvwId` | `cklstRvwService.update` |
|
||||||
|
| 삭제 | DELETE | `/cklst-rvw/{cklstRvwSn}/{cklstArtclSn}/{cklstSn}` | — | `CklstRvwId` | `cklstRvwService.remove` |
|
||||||
|
|
||||||
|
**CklstRvw (응답)**
|
||||||
|
|
||||||
|
| Field | 타입 | 설명 |
|
||||||
|
| -------------- | ------- | ---------------------- |
|
||||||
|
| `cklstRvwSn` | number | 점검표검토일련번호 |
|
||||||
|
| `cklstArtclSn` | number | 점검표항목일련번호 |
|
||||||
|
| `cklstSn` | number | 점검표일련번호 |
|
||||||
|
| `upCklstRvwSn` | number? | 상위점검표검토일련번호 |
|
||||||
|
| `rvwCnLvNo` | number? | 검토내용레벨번호 |
|
||||||
|
| `rvwCn` | string? | 검토내용 |
|
||||||
|
| `bchckUseYn` | string? | 체크사용여부 |
|
||||||
|
| `sortSeq` | number? | 정렬순서 |
|
||||||
|
| `useYn` | string? | 사용여부 |
|
||||||
|
| `regDt` | string? | 등록일시 |
|
||||||
|
|
||||||
|
**CklstRvwSaveRequest**: `cklstArtclSn`\*, `cklstSn`\*, `upCklstRvwSn?`, `rvwCnLvNo?`, `rvwCn?`, `bchckUseYn?`, `sortSeq?`, `useYn?`
|
||||||
|
|
||||||
|
**CklstRvwUpdateRequest**: `upCklstRvwSn?`, `rvwCnLvNo?`, `rvwCn?`, `bchckUseYn?`, `sortSeq?`, `useYn?`
|
||||||
|
|
||||||
|
**CklstRvwSearchParams**: `cklstSn?`, `cklstArtclSn?`, `useYn?` + `page`, `size`, `sort`
|
||||||
|
|
||||||
|
**CklstRvwId**: `{ cklstRvwSn: number; cklstArtclSn: number; cklstSn: number }`
|
||||||
|
|
||||||
|
**React Query hooks**: `useCklstRvwPage`, `useCklstRvwByArtcl`, `useCklstRvw`, `useCreateCklstRvw`, `useUpdateCklstRvw`, `useDeleteCklstRvw`
|
||||||
|
|
||||||
|
### 7-5. 공통코드 (보조)
|
||||||
|
|
||||||
|
| UI 필드 | 코드 그룹 (TBD) | 예시 값 |
|
||||||
|
| -------- | --------------- | -------------------------------------------- |
|
||||||
|
| 문서구분 | `ASDOCSECD` 등 | FNRS, INSTL, PWRK, DESIGN |
|
||||||
|
| 업무구분 | TBD | RE(재이용수), SF(하수처리시설), SP(하수관로) |
|
||||||
|
| 사용여부 | 고정 | Y, N |
|
||||||
|
|
||||||
|
공통코드 조회: `@/entities/code` — `codeService`, `CodeSelect`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. UI 구현 가이드
|
||||||
|
|
||||||
|
### 8-1. 기술 스택·원칙
|
||||||
|
|
||||||
|
- **공통 컴포넌트**: `@common/components` (`Dialog`, `Button`, `Input`, `Select`, `RadioGroup` 등)
|
||||||
|
- **테이블**: `@tanstack/react-table` + `useDataTable`
|
||||||
|
- **데이터**: React Query — `@/entities/cklst` hooks (`useCklstRvwPage` 등 영역 C 포함)
|
||||||
|
- **공통코드**: `@/entities/code` — `CodeSelect`, `findCodeLabel`
|
||||||
|
- **상태**: 선택된 `cklstSn`, 영역 C 검토 행 배열(신규·dirty·계층 트리)
|
||||||
|
- **모의 데이터**: API 연동 전 `@faker-js/faker`
|
||||||
|
|
||||||
|
### 8-2. 모듈·파일 배치(제안)
|
||||||
|
|
||||||
|
| 구분 | 경로 |
|
||||||
|
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||||
|
| 라우트 | `apps/as/app/(with-base-layout)/checklist-management/page.tsx` |
|
||||||
|
| 페이지 | `apps/as/src/pages/checklist-management/` (Public API: page만 export) |
|
||||||
|
| UI | `.../ui/cklst-mng-list.tsx`, `cklst-mng-form-dialog.tsx`, `cklst-artcl-list.tsx`, `cklst-artcl-form-dialog.tsx`, `cklst-rvw-grid.tsx`, `cklst-preview-dialog.tsx` |
|
||||||
|
| model | `.../model/cklst-mng-columns.tsx`, `cklst-artcl-columns.tsx`, `cklst-rvw-row-types.ts` |
|
||||||
|
| lib | `.../lib/use-cklst-rvw-rows.ts`, `validators.ts`, `build-rvw-tree.ts` |
|
||||||
|
| 엔티티 | `apps/as/src/entities/cklst/` (`cklstMng`, `cklstArtcl`, `cklstRvw` 서비스·hooks) |
|
||||||
|
| 페이지 | `apps/as/src/pages/checklist-management/` — `/checklist-management` |
|
||||||
|
| 문서 | `apps/as/docs/checklist-management/SPEC.md` |
|
||||||
|
|
||||||
|
### 8-3. 영역별 UI 매핑
|
||||||
|
|
||||||
|
| 영역 | 주요 UI |
|
||||||
|
| ---- | ---------------------------------------------------------------------------- |
|
||||||
|
| A | DataTable + 행 선택 + 점검표 추가/수정 Dialog |
|
||||||
|
| B | DataTable + 점검항목 추가/수정 Dialog |
|
||||||
|
| C | 계층형 편집 그리드(1·2단계) + [추가][저장][미리보기] + 행별 [하위추가][삭제] |
|
||||||
|
| 공통 | `CodeSelect` (문서구분·업무구분), 사용여부 Y/N Select/Radio |
|
||||||
|
|
||||||
|
### 8-4. 다이얼로그·라우팅
|
||||||
|
|
||||||
|
| 다이얼로그명 | 트리거 | API 연동 |
|
||||||
|
| ------------------- | --------------- | ------------------------- |
|
||||||
|
| 점검표 추가 | [점검표 추가] | `useCreateCklstMng` |
|
||||||
|
| 점검표 수정 | 행 [관리] | `useUpdateCklstMng` |
|
||||||
|
| 점검표 삭제 확인 | 행 [삭제] | `useDeleteCklstMng` |
|
||||||
|
| 점검항목 추가 | [점검항목 추가] | `useCreateCklstArtcl` |
|
||||||
|
| 점검항목 수정 | 행 [관리] | `useUpdateCklstArtcl` |
|
||||||
|
| 체크리스트 미리보기 | [미리보기] | TBD — 읽기 전용 트리 렌더 |
|
||||||
|
|
||||||
|
라우트: `/checklist-management` (메뉴 URL은 CMS 등록값과 일치시킴)
|
||||||
|
|
||||||
|
### 8-5. 데이터 흐름(요약)
|
||||||
|
|
||||||
|
- **진입**: `useCklstMngPage` → 영역 A, `useCklstArtclPage` → 영역 B. C 비활성.
|
||||||
|
- **점검표 선택**: `cklstSn` 설정 → 영역 C 활성 → `useCklstRvwPage({ cklstSn })` → 트리 그리드 표시.
|
||||||
|
- **점검표 CRUD**: Dialog → `useCreateCklstMng` / `useUpdateCklstMng` / `useDeleteCklstMng`.
|
||||||
|
- **점검항목 CRUD**: Dialog → `useCreateCklstArtcl` / `useUpdateCklstArtcl` / `useDeleteCklstArtcl`.
|
||||||
|
- **검토 저장**: [저장] → 신규 POST / 기존 PUT 순차 호출 (일괄 API 없음).
|
||||||
|
- **영역 C 점검항목 Select**: `useCklstArtclList(cklstSn)` 또는 영역 B 전체 목록과 교차 — **TBD**.
|
||||||
|
|
||||||
|
### 8-6. 미확정 / 검증 필요
|
||||||
|
|
||||||
|
- [ ] 영역 B 점검항목 등록 시 `cklstSn` 필수 vs UI 무소속 마스터 — 백엔드·기획 확인
|
||||||
|
- [ ] `점검항목코드`(ITEM_001) 표시 형식 vs `cklstArtclSn` 숫자 PK
|
||||||
|
- [ ] 영역 C 전체 검토 트리 조회: `cklstSn` 단위 일괄 API 부재 — `by-artcl` 다건 호출 또는 백엔드 확장
|
||||||
|
- [x] `@/entities/cklst` — `cklstRvwService`·hooks 구현
|
||||||
|
- [x] `pages/checklist-management` — 영역 A·B·C UI 구현 (`/checklist-management`)
|
||||||
|
- [ ] 문서구분·업무구분 공통코드 상위코드 ID (`ASDOCSECD` 등)
|
||||||
|
- [ ] [미리보기] 다이얼로그 UI·데이터 소스
|
||||||
|
- [ ] `bchckUseYn` UI 반영 여부
|
||||||
|
- [ ] 영역 A·B 페이지네이션·검색 UI 노출 여부
|
||||||
|
- [ ] 권한(역할별 CRUD)
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
import { FlatCompat } from "@eslint/eslintrc";
|
||||||
|
import { dirname } from "path";
|
||||||
|
import { fileURLToPath } from "url";
|
||||||
|
import baseEsLintConfig from "../../eslint.config.mjs";
|
||||||
|
|
||||||
|
const __filename = fileURLToPath(import.meta.url);
|
||||||
|
const __dirname = dirname(__filename);
|
||||||
|
|
||||||
|
const compat = new FlatCompat({
|
||||||
|
baseDirectory: __dirname,
|
||||||
|
});
|
||||||
|
|
||||||
|
const eslintConfig = [
|
||||||
|
...compat.extends("next/core-web-vitals", "next/typescript"),
|
||||||
|
...baseEsLintConfig,
|
||||||
|
{
|
||||||
|
rules: {
|
||||||
|
"react-hooks/exhaustive-deps": "off",
|
||||||
|
"@typescript-eslint/no-unused-vars": [
|
||||||
|
"warn",
|
||||||
|
{
|
||||||
|
argsIgnorePattern: "^_",
|
||||||
|
varsIgnorePattern: "^_",
|
||||||
|
caughtErrorsIgnorePattern: "^_",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
"@typescript-eslint/no-explicit-any": "warn",
|
||||||
|
"@typescript-eslint/no-wrapper-object-types": "warn",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
];
|
||||||
|
|
||||||
|
export default eslintConfig;
|
||||||
@@ -0,0 +1,73 @@
|
|||||||
|
import { NextRequest, NextResponse } from "next/server";
|
||||||
|
|
||||||
|
import { AUTH_USER_ID, CLAIM_NAME, PORT, PROXY_HOST, SERVER_API_URL, SITE_ID } from "@/shared/config";
|
||||||
|
|
||||||
|
const serverApiUrl = process.env.SERVER_API_URL;
|
||||||
|
|
||||||
|
// CSP 헤더 설정 함수 (img-src만)
|
||||||
|
function addSecurityHeaders(response: NextResponse): NextResponse {
|
||||||
|
response.headers.set("Content-Security-Policy", "img-src 'self' data: https: blob:;");
|
||||||
|
return response;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function middleware(req: NextRequest) {
|
||||||
|
const pathname = req.nextUrl.pathname;
|
||||||
|
const searchParams = req.nextUrl.searchParams;
|
||||||
|
|
||||||
|
const logMessages: string[] = [
|
||||||
|
`[Middleware Request] ${new Date().toISOString()}`,
|
||||||
|
`[Environment]\n Mode: ${process.env.NODE_ENV}\n Port: ${PORT}\n Proxy Host: ${PROXY_HOST}\n Server API URL: ${SERVER_API_URL}\n Site ID: ${SITE_ID}`,
|
||||||
|
`[Request]\n Original Pathname: ${pathname}`,
|
||||||
|
];
|
||||||
|
|
||||||
|
if (pathname.startsWith("/server")) {
|
||||||
|
const queryParams = searchParams.toString();
|
||||||
|
const newUrl = `${serverApiUrl}${pathname.replace("/server", "")}${
|
||||||
|
queryParams ? `?${queryParams}` : ""
|
||||||
|
}`;
|
||||||
|
|
||||||
|
logMessages.push(` Rewritten URL: ${newUrl}`);
|
||||||
|
logMessages.push("\n--------------------------------\n");
|
||||||
|
console.log(logMessages.join("\n"));
|
||||||
|
|
||||||
|
const response = NextResponse.rewrite(new URL(newUrl));
|
||||||
|
return addSecurityHeaders(response);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
// tus-js-client PATCH 요청: Location 헤더로 /server 없이 반환된 경로 직접 처리
|
||||||
|
// (예: /attach-service/api/v1/tus/upload/{id})
|
||||||
|
if (pathname.startsWith("/attach-service")) {
|
||||||
|
const requestHeaders = new Headers(req.headers);
|
||||||
|
const token = req.cookies.get(CLAIM_NAME)?.value;
|
||||||
|
const userId = req.cookies.get(AUTH_USER_ID)?.value;
|
||||||
|
const newUrl = `${serverApiUrl}${pathname}`;
|
||||||
|
|
||||||
|
if (token) requestHeaders.set(CLAIM_NAME, token);
|
||||||
|
if (userId) requestHeaders.set(AUTH_USER_ID, userId);
|
||||||
|
|
||||||
|
logMessages.push(` [TUS Proxy] Rewritten URL: ${newUrl}`);
|
||||||
|
logMessages.push("\n--------------------------------\n");
|
||||||
|
console.log(logMessages.join("\n"));
|
||||||
|
|
||||||
|
const response = NextResponse.rewrite(new URL(newUrl), {
|
||||||
|
headers: requestHeaders,
|
||||||
|
});
|
||||||
|
return addSecurityHeaders(response);
|
||||||
|
}
|
||||||
|
|
||||||
|
// if (pathname === "/") {
|
||||||
|
// const response = NextResponse.redirect(new URL("/dashboard", req.url));
|
||||||
|
// return addSecurityHeaders(response);
|
||||||
|
// }
|
||||||
|
|
||||||
|
logMessages.push("\n--------------------------------\n");
|
||||||
|
console.log(logMessages.join("\n"));
|
||||||
|
|
||||||
|
const response = NextResponse.next();
|
||||||
|
return addSecurityHeaders(response);
|
||||||
|
}
|
||||||
|
|
||||||
|
export const config = {
|
||||||
|
matcher: ["/server/:path*", "/attach-service/:path*", "/"],
|
||||||
|
};
|
||||||
Vendored
+1
@@ -1,5 +1,6 @@
|
|||||||
/// <reference types="next" />
|
/// <reference types="next" />
|
||||||
/// <reference types="next/image-types/global" />
|
/// <reference types="next/image-types/global" />
|
||||||
|
/// <reference types="next/navigation-types/compat/navigation" />
|
||||||
|
|
||||||
// NOTE: This file should not be edited
|
// NOTE: This file should not be edited
|
||||||
// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
|
// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
|
||||||
|
|||||||
@@ -0,0 +1,8 @@
|
|||||||
|
import type { NextConfig } from "next";
|
||||||
|
|
||||||
|
const nextConfig: NextConfig = {
|
||||||
|
reactStrictMode: true,
|
||||||
|
transpilePackages: ["@common/assets"],
|
||||||
|
};
|
||||||
|
|
||||||
|
export default nextConfig;
|
||||||
@@ -0,0 +1,47 @@
|
|||||||
|
{
|
||||||
|
"name": "as",
|
||||||
|
"version": "0.1.0",
|
||||||
|
"private": true,
|
||||||
|
"scripts": {
|
||||||
|
"dev": "next dev -p 3003",
|
||||||
|
"build": "next build",
|
||||||
|
"start": "next start -p 3003",
|
||||||
|
"lint": "next lint",
|
||||||
|
"lint:fsd": "steiger ."
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"@common/assets": "workspace:*",
|
||||||
|
"@common/components": "workspace:*",
|
||||||
|
"@common/network": "workspace:*",
|
||||||
|
"@dnd-kit/core": "^6.3.1",
|
||||||
|
"@dnd-kit/sortable": "^10.0.0",
|
||||||
|
"@dnd-kit/utilities": "^3.2.2",
|
||||||
|
"@faker-js/faker": "^9.9.0",
|
||||||
|
"@frontend-opensource/use-react-hooks": "^1.1.4",
|
||||||
|
"@hookform/resolvers": "^4.1.3",
|
||||||
|
"@tanstack/react-query": "^5.75.5",
|
||||||
|
"@tanstack/react-query-devtools": "^5.75.5",
|
||||||
|
"@tanstack/react-table": "^8.21.2",
|
||||||
|
"axios": "^1.8.1",
|
||||||
|
"dayjs": "^1.11.13",
|
||||||
|
"js-cookie": "^3.0.5",
|
||||||
|
"lucide-react": "^0.474.0",
|
||||||
|
"next": "15.3.8",
|
||||||
|
"react-hook-form": "^7.54.2",
|
||||||
|
"tus-js-client": "^4.3.1",
|
||||||
|
"zod": "^3.24.2"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@eslint/eslintrc": "^3",
|
||||||
|
"@types/js-cookie": "^3.0.6",
|
||||||
|
"eslint": "^9.0.0",
|
||||||
|
"eslint-config-next": "15.3.8",
|
||||||
|
"eslint-plugin-react-hooks": "^5.0.0",
|
||||||
|
"postcss": "^8.4.49",
|
||||||
|
"prettier": "^3.4.2",
|
||||||
|
"prettier-plugin-tailwindcss": "^0.6.11",
|
||||||
|
"steiger": "^0.5.11",
|
||||||
|
"tailwindcss": "^3.4.14",
|
||||||
|
"typescript": "^5.7.2"
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
# 이 폴더는 비워 둡니다 (FSD + Next.js App Router)
|
||||||
|
|
||||||
|
Next.js가 `src/pages`를 **Pages Router**용 `pages` 디렉터리로 인식하지 않도록,
|
||||||
|
프로젝트 루트에 **빈 `pages` 폴더**를 두는 것이 FSD 공식 가이드 권장사항입니다.
|
||||||
|
|
||||||
|
- 실제 페이지(FSD Pages 레이어)는 **`src/pages`**에 있습니다.
|
||||||
|
- Next.js 라우트는 **`app/`** 에서 `src/pages`를 re-export 하는 방식으로 연결됩니다.
|
||||||
|
|
||||||
|
[Feature-Sliced Design - Usage with Next.js (App Router)](https://feature-sliced.design/docs/guides/tech/with-nextjs)
|
||||||
Executable
BIN
Binary file not shown.
|
After Width: | Height: | Size: 132 KiB |
@@ -0,0 +1,41 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useCallback } from "react";
|
||||||
|
import { usePathname, useRouter } from "next/navigation";
|
||||||
|
|
||||||
|
import { useQueryClient } from "@tanstack/react-query";
|
||||||
|
|
||||||
|
import { useMenuStore } from "@/shared/lib";
|
||||||
|
import { PageLayout } from "@/shared/ui/page-layout";
|
||||||
|
import type { MenuItem } from "@/entities/menu";
|
||||||
|
import { BaseLayout } from "@common/components";
|
||||||
|
|
||||||
|
interface BaseLayoutWrapperProps {
|
||||||
|
children: React.ReactNode;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function BaseLayoutWrapper({ children }: BaseLayoutWrapperProps) {
|
||||||
|
const router = useRouter();
|
||||||
|
const pathname = usePathname();
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
const setCurrentMenuInfo = useMenuStore((state) => state.setCurrentMenuInfo);
|
||||||
|
|
||||||
|
const handleMenuClick = useCallback(
|
||||||
|
(item: MenuItem) => {
|
||||||
|
setCurrentMenuInfo(item);
|
||||||
|
router.push(item.urlPath);
|
||||||
|
},
|
||||||
|
[router, setCurrentMenuInfo],
|
||||||
|
);
|
||||||
|
|
||||||
|
return (
|
||||||
|
<BaseLayout
|
||||||
|
queryClient={queryClient}
|
||||||
|
currentPath={pathname ?? ""}
|
||||||
|
handleMenuClick={handleMenuClick}
|
||||||
|
>
|
||||||
|
<PageLayout>{children}</PageLayout>
|
||||||
|
</BaseLayout>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { ConfirmProvider } from "@frontend-opensource/use-react-hooks";
|
||||||
|
import { QueryClientProvider } from "@tanstack/react-query";
|
||||||
|
import { ReactQueryDevtools } from "@tanstack/react-query-devtools";
|
||||||
|
|
||||||
|
import { queryClient } from "@/shared/lib";
|
||||||
|
import { StoreProvider } from "@/shared/providers";
|
||||||
|
import { AlertDialog } from "@/shared/ui/alert-dialog";
|
||||||
|
import { ConfirmDialog } from "@/shared/ui/confirm-dialog";
|
||||||
|
import { AuthWrapper } from "@/entities/auth";
|
||||||
|
import { MenuWrapper } from "@/entities/menu";
|
||||||
|
|
||||||
|
interface ProvidersProps {
|
||||||
|
children: React.ReactNode;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function Providers({ children }: ProvidersProps) {
|
||||||
|
return (
|
||||||
|
<QueryClientProvider client={queryClient}>
|
||||||
|
<StoreProvider>
|
||||||
|
<ConfirmProvider>
|
||||||
|
<AuthWrapper>
|
||||||
|
<MenuWrapper>{children}</MenuWrapper>
|
||||||
|
<AlertDialog />
|
||||||
|
<ConfirmDialog />
|
||||||
|
</AuthWrapper>
|
||||||
|
</ConfirmProvider>
|
||||||
|
</StoreProvider>
|
||||||
|
<ReactQueryDevtools initialIsOpen={false} />
|
||||||
|
</QueryClientProvider>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
@import "@common/assets/styles/base.css";
|
||||||
|
@import "@common/assets/styles/diveicon.css";
|
||||||
|
@import "@common/components/index.css";
|
||||||
|
|
||||||
|
@tailwind base;
|
||||||
|
@tailwind components;
|
||||||
|
@tailwind utilities;
|
||||||
|
|
||||||
|
html,
|
||||||
|
body {
|
||||||
|
color: var(--foreground);
|
||||||
|
background: var(--background);
|
||||||
|
font-family: "Noto Sans KR", sans-serif;
|
||||||
|
font-size: 10px;
|
||||||
|
}
|
||||||
@@ -0,0 +1,114 @@
|
|||||||
|
# Entities Layer
|
||||||
|
|
||||||
|
**Entities**는 프로젝트가 다루는 실제 비즈니스 개념을 나타내는 레이어입니다. 비즈니스에서 제품을 설명할 때 사용하는 용어들(예: User, Product, Order)이 주로 엔티티가 됩니다.
|
||||||
|
|
||||||
|
## 목적
|
||||||
|
|
||||||
|
- 비즈니스 엔티티의 데이터 모델 및 타입 정의
|
||||||
|
- 엔티티 관련 API 요청 함수 관리
|
||||||
|
- 엔티티의 시각적 표현 제공 (재사용 가능한 UI)
|
||||||
|
- 여러 페이지에서 동일한 외관을 재사용할 수 있도록 지원
|
||||||
|
|
||||||
|
## 구조
|
||||||
|
|
||||||
|
각 엔티티 슬라이스는 다음 세그먼트로 구성됩니다:
|
||||||
|
|
||||||
|
```
|
||||||
|
entities/
|
||||||
|
└── [entity-name]/
|
||||||
|
├── model/ # 데이터 저장소, 검증 스키마, 상태 관리
|
||||||
|
├── api/ # 엔티티 관련 API 요청 함수
|
||||||
|
├── ui/ # 엔티티 시각적 표현 (선택적)
|
||||||
|
├── lib/ # 엔티티 관련 유틸리티 (선택적)
|
||||||
|
├── @x/ # 다른 엔티티로부터의 cross-import용 Public API (선택적)
|
||||||
|
└── index.ts # Public API
|
||||||
|
```
|
||||||
|
|
||||||
|
### 세그먼트 설명
|
||||||
|
|
||||||
|
- **model**: 데이터 모델, 타입 정의, 상태 저장소 (Zustand 등)
|
||||||
|
- **api**: 백엔드 API 호출 함수
|
||||||
|
- **ui**: 엔티티를 표시하는 UI 컴포넌트 (완전한 UI 블록이 아니라 재사용 가능한 표현)
|
||||||
|
- **lib**: 엔티티 관련 유틸리티 함수
|
||||||
|
- **@x**: 다른 엔티티가 이 엔티티를 import할 때 사용하는 명시적 cross-import API
|
||||||
|
- **index.ts**: 슬라이스의 Public API (외부에서 사용할 수 있는 것만 export)
|
||||||
|
|
||||||
|
## 예시
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// entities/user/model/user.ts
|
||||||
|
export interface User {
|
||||||
|
id: string;
|
||||||
|
name: string;
|
||||||
|
email: string;
|
||||||
|
role: 'admin' | 'user';
|
||||||
|
}
|
||||||
|
|
||||||
|
// entities/user/api/get-user.ts
|
||||||
|
import type { User } from '../model/user';
|
||||||
|
|
||||||
|
export async function getUser(id: string): Promise<User> {
|
||||||
|
const response = await fetch(`/api/users/${id}`);
|
||||||
|
return response.json();
|
||||||
|
}
|
||||||
|
|
||||||
|
// entities/user/ui/user-card.tsx
|
||||||
|
import type { User } from '../model/user';
|
||||||
|
|
||||||
|
interface UserCardProps {
|
||||||
|
user: User;
|
||||||
|
onClick?: () => void;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function UserCard({ user, onClick }: UserCardProps) {
|
||||||
|
return (
|
||||||
|
<div onClick={onClick}>
|
||||||
|
<h3>{user.name}</h3>
|
||||||
|
<p>{user.email}</p>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// entities/user/index.ts
|
||||||
|
export { type User } from './model/user';
|
||||||
|
export { getUser } from './api/get-user';
|
||||||
|
export { UserCard } from './ui/user-card';
|
||||||
|
```
|
||||||
|
|
||||||
|
## 엔티티 간 관계
|
||||||
|
|
||||||
|
엔티티가 서로 연결되어 있을 때는 `@x` 표기법을 사용하여 명시적으로 cross-import를 관리하는 것이 권장됩니다:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// entities/artist/model/artist.ts
|
||||||
|
import type { Song } from 'entities/song/@x/artist';
|
||||||
|
|
||||||
|
export interface Artist {
|
||||||
|
name: string;
|
||||||
|
songs: Array<Song>;
|
||||||
|
}
|
||||||
|
|
||||||
|
// entities/song/@x/artist.ts
|
||||||
|
export type { Song } from '../model/song';
|
||||||
|
```
|
||||||
|
|
||||||
|
> `@x` 폴더를 사용하면 엔티티 간 연결을 명확하게 만들어 함께 리팩터링이 필요한 코드를 쉽게 찾을 수 있습니다.
|
||||||
|
|
||||||
|
## 레이어 의존성 규칙
|
||||||
|
|
||||||
|
✅ **허용되는 의존성**:
|
||||||
|
- `shared` 레이어의 모듈
|
||||||
|
- 같은 엔티티 슬라이스 내의 다른 세그먼트
|
||||||
|
- 다른 엔티티 슬라이스 (필요한 경우, `@x` 표기법 권장)
|
||||||
|
|
||||||
|
❌ **금지된 의존성**:
|
||||||
|
- `features` 레이어
|
||||||
|
- `widgets` 레이어
|
||||||
|
- `pages` 레이어
|
||||||
|
- `app` 레이어
|
||||||
|
|
||||||
|
## 주의사항
|
||||||
|
|
||||||
|
1. **UI 컴포넌트는 완전한 비즈니스 로직을 포함하지 않음**: UI는 주로 props나 slots를 통해 다양한 비즈니스 로직을 연결할 수 있도록 설계
|
||||||
|
2. **엔티티 간 비즈니스 로직은 상위 레이어에**: 엔티티 간 상호작용의 비즈니스 로직은 Features나 Pages 레이어에서 처리
|
||||||
|
3. **데이터 관리에 집중**: 복잡한 비즈니스 로직보다는 데이터 모델, 검증, 저장에 집중
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
import { client } from "@/shared/api";
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
|
||||||
|
import type { AcntgSeMngTreeDto, AcntgService } from "../model/acntg-interface";
|
||||||
|
|
||||||
|
async function findTree(): Promise<AcntgSeMngTreeDto[]> {
|
||||||
|
const response = await client.get<AcntgSeMngTreeDto[]>(
|
||||||
|
`${ENDPOINT.AS_COMMON_SERVICE.ACNTG_SE}/list/tree`,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const acntgService = {
|
||||||
|
findTree,
|
||||||
|
} satisfies AcntgService;
|
||||||
@@ -0,0 +1,2 @@
|
|||||||
|
export type { AcntgSeMngTreeDto, AcntgService } from "./model/acntg-interface";
|
||||||
|
export { acntgService } from "./api/acntg-service";
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
/** 회계구분 트리 노드 DTO */
|
||||||
|
export interface AcntgSeMngTreeDto {
|
||||||
|
/** 들여쓰기 포함 표시명 (앞 공백 수 = 레벨 인디케이터) */
|
||||||
|
indAcntgSeCdNm: string;
|
||||||
|
/** 회계구분코드 */
|
||||||
|
acntgSeCd: string;
|
||||||
|
/** 회계구분코드명 */
|
||||||
|
acntgSeCdNm: string;
|
||||||
|
/** 상위 회계구분코드 (null = 최상위) */
|
||||||
|
upAcntgSeCd: string | null;
|
||||||
|
/** 사용여부 */
|
||||||
|
useYn: string;
|
||||||
|
/** 트리 레벨 (1 = 총사업비, 2 = 1.공사비/2.보상비/3.부대경비, …) */
|
||||||
|
treeLevel: number;
|
||||||
|
/** 최상위~현재 노드까지 "|" 구분 경로 */
|
||||||
|
treePath: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 회계구분 서비스 인터페이스 */
|
||||||
|
export interface AcntgService {
|
||||||
|
/** 회계구분 트리 전체 조회 */
|
||||||
|
findTree(): Promise<AcntgSeMngTreeDto[]>;
|
||||||
|
}
|
||||||
+20
-24
@@ -1,13 +1,15 @@
|
|||||||
import { AxiosError } from "axios";
|
import { AxiosError } from "axios";
|
||||||
|
|
||||||
import {
|
import {
|
||||||
ENDPOINT,
|
|
||||||
JWT_EXPIRATION_TIME,
|
|
||||||
ACCESS_TOKEN,
|
ACCESS_TOKEN,
|
||||||
AUTH_USER_ID,
|
AUTH_USER_ID,
|
||||||
CLAIM_NAME,
|
CLAIM_NAME,
|
||||||
|
ENDPOINT,
|
||||||
|
JWT_EXPIRATION_TIME,
|
||||||
} from "@/shared/config";
|
} from "@/shared/config";
|
||||||
import type { LoginService, ILogin } from "../model/login-interface";
|
|
||||||
import { tokenManager } from "../lib/token-manager";
|
import { tokenManager } from "../lib/token-manager";
|
||||||
|
import type { ILogin, LoginService } from "../model/login-interface";
|
||||||
|
|
||||||
export class LoginApiService implements LoginService {
|
export class LoginApiService implements LoginService {
|
||||||
private static instance: LoginApiService;
|
private static instance: LoginApiService;
|
||||||
@@ -32,30 +34,27 @@ export class LoginApiService implements LoginService {
|
|||||||
});
|
});
|
||||||
|
|
||||||
const data = await response.json();
|
const data = await response.json();
|
||||||
console.log('data ', data)
|
console.log("data ", data);
|
||||||
const accessToken = data[ACCESS_TOKEN];
|
const accessToken = data[ACCESS_TOKEN];
|
||||||
const tokenId = data[AUTH_USER_ID];
|
const tokenId = data[AUTH_USER_ID];
|
||||||
|
|
||||||
if (!accessToken || !tokenId) {
|
if (!accessToken || !tokenId) {
|
||||||
if (data.message == 'Invalid Credentials' ) {
|
if (data.message == "Invalid Credentials") {
|
||||||
throw new Error('아이디와 비밀번호가 일치하지 않습니다.');
|
throw new Error("아이디와 비밀번호가 일치하지 않습니다.");
|
||||||
} else if (data.message == 'User not found') {
|
} else if (data.message == "User not found") {
|
||||||
throw new Error('존재하지 않는 아이디입니다.');
|
throw new Error("존재하지 않는 아이디입니다.");
|
||||||
} else if (data.message == 'User is not active') {
|
} else if (data.message == "User is not active") {
|
||||||
throw new Error('활성화되지 않은 계정입니다.');
|
throw new Error("활성화되지 않은 계정입니다.");
|
||||||
} else if (data.message == 'User is not verified') {
|
} else if (data.message == "User is not verified") {
|
||||||
throw new Error('이메일 인증이 필요합니다.');
|
throw new Error("이메일 인증이 필요합니다.");
|
||||||
} else {
|
} else {
|
||||||
throw new Error(data.message);
|
throw new Error(data.message);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
tokenManager.setToken(CLAIM_NAME, accessToken);
|
tokenManager.setToken(CLAIM_NAME, accessToken);
|
||||||
tokenManager.setToken(AUTH_USER_ID, tokenId);
|
tokenManager.setToken(AUTH_USER_ID, tokenId);
|
||||||
tokenManager.setupRefreshTimer(
|
tokenManager.setupRefreshTimer(() => this.silentRefresh(), JWT_EXPIRATION_TIME);
|
||||||
() => this.silentRefresh(),
|
|
||||||
JWT_EXPIRATION_TIME,
|
|
||||||
);
|
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
if (error instanceof AxiosError) {
|
if (error instanceof AxiosError) {
|
||||||
throw new Error(`Login 실패 ${error.response?.data?.message}`);
|
throw new Error(`Login 실패 ${error.response?.data?.message}`);
|
||||||
@@ -66,10 +65,9 @@ export class LoginApiService implements LoginService {
|
|||||||
|
|
||||||
public async silentRefresh(): Promise<void> {
|
public async silentRefresh(): Promise<void> {
|
||||||
try {
|
try {
|
||||||
const response = await fetch(
|
const response = await fetch(`/api/proxy${ENDPOINT.USER_SERVICE.SILENT_REFRESH}`, {
|
||||||
`/api/proxy${ENDPOINT.USER_SERVICE.SILENT_REFRESH}`,
|
method: "PUT",
|
||||||
{ method: "PUT" },
|
});
|
||||||
);
|
|
||||||
|
|
||||||
const data = await response.json();
|
const data = await response.json();
|
||||||
const accessToken = data[ACCESS_TOKEN];
|
const accessToken = data[ACCESS_TOKEN];
|
||||||
@@ -84,9 +82,7 @@ export class LoginApiService implements LoginService {
|
|||||||
} catch (error) {
|
} catch (error) {
|
||||||
tokenManager.clearAuthToken();
|
tokenManager.clearAuthToken();
|
||||||
if (error instanceof AxiosError) {
|
if (error instanceof AxiosError) {
|
||||||
throw new Error(
|
throw new Error(`Silent refresh failed: ${error.response?.data?.message}`);
|
||||||
`Silent refresh failed: ${error.response?.data?.message}`,
|
|
||||||
);
|
|
||||||
}
|
}
|
||||||
throw new Error(`Silent refresh failed: ${error}`);
|
throw new Error(`Silent refresh failed: ${error}`);
|
||||||
}
|
}
|
||||||
@@ -0,0 +1,2 @@
|
|||||||
|
export { LoginApi } from "./api/login-service";
|
||||||
|
export { AuthWrapper } from "./lib/auth-wrapper";
|
||||||
@@ -0,0 +1,45 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useEffect } from "react";
|
||||||
|
|
||||||
|
import { client } from "@/shared/api";
|
||||||
|
import { AUTH_LOGIN_REDIRECT_URL, AUTH_USER_ID, ENDPOINT } from "@/shared/config";
|
||||||
|
import { getCookie, useUserStore } from "@/shared/lib";
|
||||||
|
import type { IUserInfo } from "@/shared/store";
|
||||||
|
import { isAtLoginRedirectUrl } from "@common/network";
|
||||||
|
|
||||||
|
const AuthWrapper = ({ children }: { children: React.ReactNode }) => {
|
||||||
|
const { userInfo, setUserInfo } = useUserStore((state) => state);
|
||||||
|
|
||||||
|
async function authCheck() {
|
||||||
|
if (isAtLoginRedirectUrl(AUTH_LOGIN_REDIRECT_URL)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const userId = getCookie(AUTH_USER_ID);
|
||||||
|
if (!userId) {
|
||||||
|
throw new Error("Missing required authentication tokens");
|
||||||
|
}
|
||||||
|
|
||||||
|
const response = await client.get<IUserInfo>(`${ENDPOINT.USER_SERVICE.USERS}/info/me`);
|
||||||
|
if (!userInfo) setUserInfo(response.data);
|
||||||
|
}
|
||||||
|
|
||||||
|
useEffect(() => {
|
||||||
|
(async () => {
|
||||||
|
try {
|
||||||
|
await authCheck();
|
||||||
|
} catch (error) {
|
||||||
|
console.error(error);
|
||||||
|
setUserInfo(null);
|
||||||
|
if (!isAtLoginRedirectUrl(AUTH_LOGIN_REDIRECT_URL)) {
|
||||||
|
window.location.assign(AUTH_LOGIN_REDIRECT_URL);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
})();
|
||||||
|
}, []);
|
||||||
|
|
||||||
|
return <>{children}</>;
|
||||||
|
};
|
||||||
|
|
||||||
|
export { AuthWrapper };
|
||||||
+26
-3
@@ -1,5 +1,5 @@
|
|||||||
import { AUTH_USER_ID, CLAIM_NAME } from "@/src/shared/config";
|
import { AUTH_USER_ID, CLAIM_NAME } from "@/shared/config";
|
||||||
import { getCookie, removeCookie, setCookie } from "@/src/shared/lib/cookie";
|
import { getCookie, removeCookie,setCookie } from "@/shared/lib";
|
||||||
|
|
||||||
export class TokenManager {
|
export class TokenManager {
|
||||||
private static instance: TokenManager;
|
private static instance: TokenManager;
|
||||||
@@ -19,14 +19,37 @@ export class TokenManager {
|
|||||||
}
|
}
|
||||||
|
|
||||||
public setToken(key: string, value: string): void {
|
public setToken(key: string, value: string): void {
|
||||||
|
const domain = this.getCookieDomain();
|
||||||
|
|
||||||
setCookie(key, value, {
|
setCookie(key, value, {
|
||||||
secure: window.location.protocol === "https:",
|
secure: window.location.protocol === "https:",
|
||||||
sameSite: "lax",
|
sameSite: "lax",
|
||||||
|
domain: domain,
|
||||||
|
path: "/", // 모든 경로에서 접근 가능
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
private getCookieDomain(): string | undefined {
|
||||||
|
const hostname = window.location.hostname;
|
||||||
|
|
||||||
|
// 개발 환경에서는 localhost 도메인 사용
|
||||||
|
if (hostname === "localhost" || hostname === "127.0.0.1") {
|
||||||
|
return undefined; // localhost에서는 도메인 설정하지 않음
|
||||||
|
}
|
||||||
|
|
||||||
|
// 운영 환경에서는 서브도메인을 포함한 최상위 도메인 사용
|
||||||
|
if (hostname.includes("hasuon.or.kr")) {
|
||||||
|
return ".hasuon.or.kr";
|
||||||
|
}
|
||||||
|
|
||||||
|
// 기타 환경에서는 현재 호스트명 사용
|
||||||
|
return hostname;
|
||||||
|
}
|
||||||
|
|
||||||
public removeToken(key: string): void {
|
public removeToken(key: string): void {
|
||||||
removeCookie(key);
|
const domain = this.getCookieDomain();
|
||||||
|
removeCookie(key, { domain, path: "/" });
|
||||||
}
|
}
|
||||||
|
|
||||||
public setupRefreshTimer(
|
public setupRefreshTimer(
|
||||||
@@ -0,0 +1,70 @@
|
|||||||
|
import { client } from "@/shared/api";
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
import type { PageResponse } from "@/shared/model";
|
||||||
|
|
||||||
|
import type {
|
||||||
|
CklstArtcl,
|
||||||
|
CklstArtclId,
|
||||||
|
CklstArtclSaveRequest,
|
||||||
|
CklstArtclSearchParams,
|
||||||
|
CklstArtclService,
|
||||||
|
CklstArtclUpdateRequest,
|
||||||
|
} from "../model/cklst-artcl-interface";
|
||||||
|
|
||||||
|
async function findPage(params: CklstArtclSearchParams): Promise<PageResponse<CklstArtcl>> {
|
||||||
|
const response = await client.get<PageResponse<CklstArtcl>>(
|
||||||
|
ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_ARTCL,
|
||||||
|
{ params },
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function findByCklstSn(cklstSn: number): Promise<CklstArtcl[]> {
|
||||||
|
const response = await client.get<CklstArtcl[]>(
|
||||||
|
`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_ARTCL}/by-cklst/${cklstSn}`,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function findById(cklstArtclSn: number, cklstSn: number): Promise<CklstArtcl> {
|
||||||
|
const response = await client.get<CklstArtcl>(
|
||||||
|
`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_ARTCL}/${cklstArtclSn}/${cklstSn}`,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function create(body: CklstArtclSaveRequest): Promise<CklstArtclId> {
|
||||||
|
const response = await client.post<CklstArtclId>(
|
||||||
|
ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_ARTCL,
|
||||||
|
body,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function update(
|
||||||
|
cklstArtclSn: number,
|
||||||
|
cklstSn: number,
|
||||||
|
body: CklstArtclUpdateRequest,
|
||||||
|
): Promise<CklstArtclId> {
|
||||||
|
const response = await client.put<CklstArtclId>(
|
||||||
|
`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_ARTCL}/${cklstArtclSn}/${cklstSn}`,
|
||||||
|
body,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function remove(cklstArtclSn: number, cklstSn: number): Promise<CklstArtclId> {
|
||||||
|
const response = await client.delete<CklstArtclId>(
|
||||||
|
`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_ARTCL}/${cklstArtclSn}/${cklstSn}`,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const cklstArtclService = {
|
||||||
|
findPage,
|
||||||
|
findByCklstSn,
|
||||||
|
findById,
|
||||||
|
create,
|
||||||
|
update,
|
||||||
|
remove,
|
||||||
|
} satisfies CklstArtclService;
|
||||||
@@ -0,0 +1,58 @@
|
|||||||
|
import { client } from "@/shared/api";
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
import type { PageResponse } from "@/shared/model";
|
||||||
|
|
||||||
|
import type {
|
||||||
|
CklstMng,
|
||||||
|
CklstMngSaveRequest,
|
||||||
|
CklstMngSearchParams,
|
||||||
|
CklstMngService,
|
||||||
|
CklstTreeNode,
|
||||||
|
CklstTreeSearchParams,
|
||||||
|
} from "../model/cklst-mng-interface";
|
||||||
|
|
||||||
|
async function findPage(params: CklstMngSearchParams): Promise<PageResponse<CklstMng>> {
|
||||||
|
const response = await client.get<PageResponse<CklstMng>>(ENDPOINT.AS_CHECKLIST_SERVICE.CKLST, {
|
||||||
|
params,
|
||||||
|
});
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function findById(cklstSn: number): Promise<CklstMng> {
|
||||||
|
const response = await client.get<CklstMng>(`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST}/${cklstSn}`);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function findTree(params: CklstTreeSearchParams): Promise<CklstTreeNode[]> {
|
||||||
|
const response = await client.get<CklstTreeNode[]>(`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST}/list/tree`, {
|
||||||
|
params,
|
||||||
|
});
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function create(body: CklstMngSaveRequest): Promise<number> {
|
||||||
|
const response = await client.post<number>(ENDPOINT.AS_CHECKLIST_SERVICE.CKLST, body);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function update(cklstSn: number, body: CklstMngSaveRequest): Promise<number> {
|
||||||
|
const response = await client.put<number>(
|
||||||
|
`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST}/${cklstSn}`,
|
||||||
|
body,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function remove(cklstSn: number): Promise<number> {
|
||||||
|
const response = await client.delete<number>(`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST}/${cklstSn}`);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const cklstMngService = {
|
||||||
|
findPage,
|
||||||
|
findById,
|
||||||
|
findTree,
|
||||||
|
create,
|
||||||
|
update,
|
||||||
|
remove,
|
||||||
|
} satisfies CklstMngService;
|
||||||
@@ -0,0 +1,79 @@
|
|||||||
|
import { client } from "@/shared/api";
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
import type { PageResponse } from "@/shared/model";
|
||||||
|
|
||||||
|
import type {
|
||||||
|
CklstRvw,
|
||||||
|
CklstRvwId,
|
||||||
|
CklstRvwSaveRequest,
|
||||||
|
CklstRvwSearchParams,
|
||||||
|
CklstRvwService,
|
||||||
|
CklstRvwUpdateRequest,
|
||||||
|
} from "../model/cklst-rvw-interface";
|
||||||
|
|
||||||
|
async function findPage(params: CklstRvwSearchParams): Promise<PageResponse<CklstRvw>> {
|
||||||
|
const response = await client.get<PageResponse<CklstRvw>>(
|
||||||
|
ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_RVW,
|
||||||
|
{ params },
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function findByArtcl(cklstSn: number, cklstArtclSn: number): Promise<CklstRvw[]> {
|
||||||
|
const response = await client.get<CklstRvw[]>(
|
||||||
|
`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_RVW}/by-artcl/${cklstSn}/${cklstArtclSn}`,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function findById(
|
||||||
|
cklstRvwSn: number,
|
||||||
|
cklstArtclSn: number,
|
||||||
|
cklstSn: number,
|
||||||
|
): Promise<CklstRvw> {
|
||||||
|
const response = await client.get<CklstRvw>(
|
||||||
|
`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_RVW}/${cklstRvwSn}/${cklstArtclSn}/${cklstSn}`,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function create(body: CklstRvwSaveRequest): Promise<CklstRvwId> {
|
||||||
|
const response = await client.post<CklstRvwId>(
|
||||||
|
ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_RVW,
|
||||||
|
body,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function update(
|
||||||
|
cklstRvwSn: number,
|
||||||
|
cklstArtclSn: number,
|
||||||
|
cklstSn: number,
|
||||||
|
body: CklstRvwUpdateRequest,
|
||||||
|
): Promise<CklstRvwId> {
|
||||||
|
const response = await client.put<CklstRvwId>(
|
||||||
|
`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_RVW}/${cklstRvwSn}/${cklstArtclSn}/${cklstSn}`,
|
||||||
|
body,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function remove(
|
||||||
|
cklstRvwSn: number,
|
||||||
|
cklstArtclSn: number,
|
||||||
|
cklstSn: number,
|
||||||
|
): Promise<CklstRvwId> {
|
||||||
|
const response = await client.delete<CklstRvwId>(
|
||||||
|
`${ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_RVW}/${cklstRvwSn}/${cklstArtclSn}/${cklstSn}`,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const cklstRvwService = {
|
||||||
|
findPage,
|
||||||
|
findByArtcl,
|
||||||
|
findById,
|
||||||
|
create,
|
||||||
|
update,
|
||||||
|
remove,
|
||||||
|
} satisfies CklstRvwService;
|
||||||
@@ -0,0 +1,281 @@
|
|||||||
|
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
|
||||||
|
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
|
||||||
|
import type {
|
||||||
|
CklstArtclSaveRequest,
|
||||||
|
CklstArtclSearchParams,
|
||||||
|
CklstArtclUpdateRequest,
|
||||||
|
} from "../model/cklst-artcl-interface";
|
||||||
|
import type { CklstMngSaveRequest, CklstMngSearchParams } from "../model/cklst-mng-interface";
|
||||||
|
import type {
|
||||||
|
CklstRvwSaveRequest,
|
||||||
|
CklstRvwSearchParams,
|
||||||
|
CklstRvwUpdateRequest,
|
||||||
|
} from "../model/cklst-rvw-interface";
|
||||||
|
|
||||||
|
import { cklstArtclService } from "./cklst-artcl-service";
|
||||||
|
import { cklstMngService } from "./cklst-mng-service";
|
||||||
|
import { cklstRvwService } from "./cklst-rvw-service";
|
||||||
|
|
||||||
|
const cklstMngBaseKey = [ENDPOINT.AS_CHECKLIST_SERVICE.CKLST] as const;
|
||||||
|
const cklstArtclBaseKey = [ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_ARTCL] as const;
|
||||||
|
const cklstRvwBaseKey = [ENDPOINT.AS_CHECKLIST_SERVICE.CKLST_RVW] as const;
|
||||||
|
|
||||||
|
export function useCklstMngPage(params: CklstMngSearchParams) {
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...cklstMngBaseKey, "page", params],
|
||||||
|
queryFn: () => cklstMngService.findPage(params),
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCklstMng(cklstSn: number | null | undefined) {
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...cklstMngBaseKey, cklstSn],
|
||||||
|
queryFn: () => cklstMngService.findById(cklstSn!),
|
||||||
|
enabled: cklstSn != null,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCreateCklstMng() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: (body: CklstMngSaveRequest) => cklstMngService.create(body),
|
||||||
|
onSuccess: () => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: cklstMngBaseKey });
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useUpdateCklstMng() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: ({ cklstSn, body }: { cklstSn: number; body: CklstMngSaveRequest }) =>
|
||||||
|
cklstMngService.update(cklstSn, body),
|
||||||
|
onSuccess: (_data, { cklstSn }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: cklstMngBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstMngBaseKey, cklstSn],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useDeleteCklstMng() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: (cklstSn: number) => cklstMngService.remove(cklstSn),
|
||||||
|
onSuccess: () => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: cklstMngBaseKey });
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCklstArtclPage(params: CklstArtclSearchParams) {
|
||||||
|
const { cklstSn } = params;
|
||||||
|
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...cklstArtclBaseKey, "page", params],
|
||||||
|
queryFn: () => cklstArtclService.findPage(params),
|
||||||
|
enabled: cklstSn != null,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCklstArtclList(cklstSn: number | null | undefined) {
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...cklstArtclBaseKey, "by-cklst", cklstSn],
|
||||||
|
queryFn: () => cklstArtclService.findByCklstSn(cklstSn!),
|
||||||
|
enabled: cklstSn != null,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCklstArtcl(params: {
|
||||||
|
cklstArtclSn: number | null | undefined;
|
||||||
|
cklstSn: number | null | undefined;
|
||||||
|
}) {
|
||||||
|
const { cklstArtclSn, cklstSn } = params;
|
||||||
|
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...cklstArtclBaseKey, cklstArtclSn, cklstSn],
|
||||||
|
queryFn: () => cklstArtclService.findById(cklstArtclSn!, cklstSn!),
|
||||||
|
enabled: cklstArtclSn != null && cklstSn != null,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCreateCklstArtcl() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: (body: CklstArtclSaveRequest) => cklstArtclService.create(body),
|
||||||
|
onSuccess: (_data, { cklstSn }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: cklstArtclBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstArtclBaseKey, "page", { cklstSn }],
|
||||||
|
});
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstArtclBaseKey, "by-cklst", cklstSn],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useUpdateCklstArtcl() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: ({
|
||||||
|
cklstArtclSn,
|
||||||
|
cklstSn,
|
||||||
|
body,
|
||||||
|
}: {
|
||||||
|
cklstArtclSn: number;
|
||||||
|
cklstSn: number;
|
||||||
|
body: CklstArtclUpdateRequest;
|
||||||
|
}) => cklstArtclService.update(cklstArtclSn, cklstSn, body),
|
||||||
|
onSuccess: (_data, { cklstArtclSn, cklstSn }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: cklstArtclBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstArtclBaseKey, cklstArtclSn, cklstSn],
|
||||||
|
});
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstArtclBaseKey, "page", { cklstSn }],
|
||||||
|
});
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstArtclBaseKey, "by-cklst", cklstSn],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useDeleteCklstArtcl() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: ({
|
||||||
|
cklstArtclSn,
|
||||||
|
cklstSn,
|
||||||
|
}: {
|
||||||
|
cklstArtclSn: number;
|
||||||
|
cklstSn: number;
|
||||||
|
}) => cklstArtclService.remove(cklstArtclSn, cklstSn),
|
||||||
|
onSuccess: (_data, { cklstSn }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: cklstArtclBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstArtclBaseKey, "page", { cklstSn }],
|
||||||
|
});
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstArtclBaseKey, "by-cklst", cklstSn],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCklstRvwPage(params: CklstRvwSearchParams) {
|
||||||
|
const { cklstSn } = params;
|
||||||
|
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...cklstRvwBaseKey, "page", params],
|
||||||
|
queryFn: () => cklstRvwService.findPage(params),
|
||||||
|
enabled: cklstSn != null,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCklstRvwByArtcl(
|
||||||
|
cklstSn: number | null | undefined,
|
||||||
|
cklstArtclSn: number | null | undefined,
|
||||||
|
) {
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...cklstRvwBaseKey, "by-artcl", cklstSn, cklstArtclSn],
|
||||||
|
queryFn: () => cklstRvwService.findByArtcl(cklstSn!, cklstArtclSn!),
|
||||||
|
enabled: cklstSn != null && cklstArtclSn != null,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCklstRvw(params: {
|
||||||
|
cklstRvwSn: number | null | undefined;
|
||||||
|
cklstArtclSn: number | null | undefined;
|
||||||
|
cklstSn: number | null | undefined;
|
||||||
|
}) {
|
||||||
|
const { cklstRvwSn, cklstArtclSn, cklstSn } = params;
|
||||||
|
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...cklstRvwBaseKey, cklstRvwSn, cklstArtclSn, cklstSn],
|
||||||
|
queryFn: () => cklstRvwService.findById(cklstRvwSn!, cklstArtclSn!, cklstSn!),
|
||||||
|
enabled: cklstRvwSn != null && cklstArtclSn != null && cklstSn != null,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCreateCklstRvw() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: (body: CklstRvwSaveRequest) => cklstRvwService.create(body),
|
||||||
|
onSuccess: (_data, { cklstSn, cklstArtclSn }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: cklstRvwBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstRvwBaseKey, "page", { cklstSn }],
|
||||||
|
});
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstRvwBaseKey, "by-artcl", cklstSn, cklstArtclSn],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useUpdateCklstRvw() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: ({
|
||||||
|
cklstRvwSn,
|
||||||
|
cklstArtclSn,
|
||||||
|
cklstSn,
|
||||||
|
body,
|
||||||
|
}: {
|
||||||
|
cklstRvwSn: number;
|
||||||
|
cklstArtclSn: number;
|
||||||
|
cklstSn: number;
|
||||||
|
body: CklstRvwUpdateRequest;
|
||||||
|
}) => cklstRvwService.update(cklstRvwSn, cklstArtclSn, cklstSn, body),
|
||||||
|
onSuccess: (_data, { cklstRvwSn, cklstArtclSn, cklstSn }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: cklstRvwBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstRvwBaseKey, cklstRvwSn, cklstArtclSn, cklstSn],
|
||||||
|
});
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstRvwBaseKey, "page", { cklstSn }],
|
||||||
|
});
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstRvwBaseKey, "by-artcl", cklstSn, cklstArtclSn],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useDeleteCklstRvw() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: ({
|
||||||
|
cklstRvwSn,
|
||||||
|
cklstArtclSn,
|
||||||
|
cklstSn,
|
||||||
|
}: {
|
||||||
|
cklstRvwSn: number;
|
||||||
|
cklstArtclSn: number;
|
||||||
|
cklstSn: number;
|
||||||
|
}) => cklstRvwService.remove(cklstRvwSn, cklstArtclSn, cklstSn),
|
||||||
|
onSuccess: (_data, { cklstSn, cklstArtclSn }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: cklstRvwBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstRvwBaseKey, "page", { cklstSn }],
|
||||||
|
});
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...cklstRvwBaseKey, "by-artcl", cklstSn, cklstArtclSn],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
@@ -0,0 +1,46 @@
|
|||||||
|
export { cklstArtclService } from "./api/cklst-artcl-service";
|
||||||
|
export { cklstMngService } from "./api/cklst-mng-service";
|
||||||
|
export { cklstRvwService } from "./api/cklst-rvw-service";
|
||||||
|
export {
|
||||||
|
useCklstArtcl,
|
||||||
|
useCklstArtclList,
|
||||||
|
useCklstArtclPage,
|
||||||
|
useCklstMng,
|
||||||
|
useCklstMngPage,
|
||||||
|
useCklstRvw,
|
||||||
|
useCklstRvwByArtcl,
|
||||||
|
useCklstRvwPage,
|
||||||
|
useCreateCklstArtcl,
|
||||||
|
useCreateCklstMng,
|
||||||
|
useCreateCklstRvw,
|
||||||
|
useDeleteCklstArtcl,
|
||||||
|
useDeleteCklstMng,
|
||||||
|
useDeleteCklstRvw,
|
||||||
|
useUpdateCklstArtcl,
|
||||||
|
useUpdateCklstMng,
|
||||||
|
useUpdateCklstRvw,
|
||||||
|
} from "./api/queries";
|
||||||
|
export type {
|
||||||
|
CklstArtcl,
|
||||||
|
CklstArtclId,
|
||||||
|
CklstArtclSaveRequest,
|
||||||
|
CklstArtclSearchParams,
|
||||||
|
CklstArtclService,
|
||||||
|
CklstArtclUpdateRequest,
|
||||||
|
} from "./model/cklst-artcl-interface";
|
||||||
|
export type {
|
||||||
|
CklstMng,
|
||||||
|
CklstMngSaveRequest,
|
||||||
|
CklstMngSearchParams,
|
||||||
|
CklstMngService,
|
||||||
|
CklstTreeNode,
|
||||||
|
CklstTreeSearchParams,
|
||||||
|
} from "./model/cklst-mng-interface";
|
||||||
|
export type {
|
||||||
|
CklstRvw,
|
||||||
|
CklstRvwId,
|
||||||
|
CklstRvwSaveRequest,
|
||||||
|
CklstRvwSearchParams,
|
||||||
|
CklstRvwService,
|
||||||
|
CklstRvwUpdateRequest,
|
||||||
|
} from "./model/cklst-rvw-interface";
|
||||||
@@ -0,0 +1,48 @@
|
|||||||
|
import type { PageableParams, PageResponse } from "@/shared/model";
|
||||||
|
|
||||||
|
export interface CklstArtclId {
|
||||||
|
cklstArtclSn: number;
|
||||||
|
cklstSn: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstArtcl {
|
||||||
|
cklstArtclSn: number;
|
||||||
|
cklstSn: number;
|
||||||
|
cklstArtclNm?: string;
|
||||||
|
useYn?: "Y" | "N";
|
||||||
|
rgtr?: string;
|
||||||
|
rgtrNm?: string;
|
||||||
|
mdfr?: string;
|
||||||
|
regDt?: string;
|
||||||
|
mdfcnDt?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstArtclSearchParams extends PageableParams {
|
||||||
|
cklstSn?: number;
|
||||||
|
cklstArtclNm?: string;
|
||||||
|
useYn?: "Y" | "N";
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstArtclSaveRequest {
|
||||||
|
cklstSn: number;
|
||||||
|
cklstArtclNm?: string;
|
||||||
|
useYn?: "Y" | "N";
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstArtclUpdateRequest {
|
||||||
|
cklstArtclNm?: string;
|
||||||
|
useYn?: "Y" | "N";
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstArtclService {
|
||||||
|
findPage(params: CklstArtclSearchParams): Promise<PageResponse<CklstArtcl>>;
|
||||||
|
findByCklstSn(cklstSn: number): Promise<CklstArtcl[]>;
|
||||||
|
findById(cklstArtclSn: number, cklstSn: number): Promise<CklstArtcl>;
|
||||||
|
create(body: CklstArtclSaveRequest): Promise<CklstArtclId>;
|
||||||
|
update(
|
||||||
|
cklstArtclSn: number,
|
||||||
|
cklstSn: number,
|
||||||
|
body: CklstArtclUpdateRequest,
|
||||||
|
): Promise<CklstArtclId>;
|
||||||
|
remove(cklstArtclSn: number, cklstSn: number): Promise<CklstArtclId>;
|
||||||
|
}
|
||||||
@@ -0,0 +1,55 @@
|
|||||||
|
import type { PageableParams, PageResponse } from "@/shared/model";
|
||||||
|
|
||||||
|
export interface CklstMng {
|
||||||
|
cklstSn: number;
|
||||||
|
cklstNm: string;
|
||||||
|
taskSeComCd: string;
|
||||||
|
useYn?: "Y" | "N";
|
||||||
|
docSeComCd?: string;
|
||||||
|
rgtr?: string;
|
||||||
|
rgtrNm?: string;
|
||||||
|
mdfr?: string;
|
||||||
|
regDt?: string;
|
||||||
|
mdfcnDt?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstTreeNode {
|
||||||
|
cklstSn: number;
|
||||||
|
cklstNm: string;
|
||||||
|
cklstArtclSn: number;
|
||||||
|
cklstArtclNm: string;
|
||||||
|
cklstRvwSn: number;
|
||||||
|
upCklstRvwSn: number | null;
|
||||||
|
treeLevel: number;
|
||||||
|
rvwCn: string;
|
||||||
|
bchckUseYn: "Y" | "N";
|
||||||
|
sortSeq: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstTreeSearchParams {
|
||||||
|
docSeComCd?: string;
|
||||||
|
taskSeComCd?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstMngSearchParams extends PageableParams {
|
||||||
|
cklstNm?: string;
|
||||||
|
taskSeComCd?: string;
|
||||||
|
useYn?: "Y" | "N";
|
||||||
|
docSeComCd?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstMngSaveRequest {
|
||||||
|
cklstNm: string;
|
||||||
|
taskSeComCd: string;
|
||||||
|
useYn?: "Y" | "N";
|
||||||
|
docSeComCd?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstMngService {
|
||||||
|
findPage(params: CklstMngSearchParams): Promise<PageResponse<CklstMng>>;
|
||||||
|
findById(cklstSn: number): Promise<CklstMng>;
|
||||||
|
findTree(params: CklstTreeSearchParams): Promise<CklstTreeNode[]>;
|
||||||
|
create(body: CklstMngSaveRequest): Promise<number>;
|
||||||
|
update(cklstSn: number, body: CklstMngSaveRequest): Promise<number>;
|
||||||
|
remove(cklstSn: number): Promise<number>;
|
||||||
|
}
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
import type { PageableParams, PageResponse } from "@/shared/model";
|
||||||
|
|
||||||
|
export interface CklstRvwId {
|
||||||
|
cklstRvwSn: number;
|
||||||
|
cklstArtclSn: number;
|
||||||
|
cklstSn: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstRvw {
|
||||||
|
cklstRvwSn: number;
|
||||||
|
cklstArtclSn: number;
|
||||||
|
cklstSn: number;
|
||||||
|
upCklstRvwSn?: number;
|
||||||
|
rvwCnLvNo?: number;
|
||||||
|
rvwCn?: string;
|
||||||
|
bchckUseYn?: "Y" | "N";
|
||||||
|
sortSeq?: number;
|
||||||
|
useYn?: "Y" | "N";
|
||||||
|
rgtr?: string;
|
||||||
|
rgtrNm?: string;
|
||||||
|
mdfr?: string;
|
||||||
|
regDt?: string;
|
||||||
|
mdfcnDt?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstRvwSearchParams extends PageableParams {
|
||||||
|
cklstSn?: number;
|
||||||
|
cklstArtclSn?: number;
|
||||||
|
useYn?: "Y" | "N";
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstRvwSaveRequest {
|
||||||
|
cklstArtclSn: number;
|
||||||
|
cklstSn: number;
|
||||||
|
upCklstRvwSn?: number;
|
||||||
|
rvwCnLvNo?: number;
|
||||||
|
rvwCn?: string;
|
||||||
|
bchckUseYn?: "Y" | "N";
|
||||||
|
sortSeq?: number;
|
||||||
|
useYn?: "Y" | "N";
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstRvwUpdateRequest {
|
||||||
|
upCklstRvwSn?: number;
|
||||||
|
rvwCnLvNo?: number;
|
||||||
|
rvwCn?: string;
|
||||||
|
bchckUseYn?: "Y" | "N";
|
||||||
|
sortSeq?: number;
|
||||||
|
useYn?: "Y" | "N";
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CklstRvwService {
|
||||||
|
findPage(params: CklstRvwSearchParams): Promise<PageResponse<CklstRvw>>;
|
||||||
|
findByArtcl(cklstSn: number, cklstArtclSn: number): Promise<CklstRvw[]>;
|
||||||
|
findById(cklstRvwSn: number, cklstArtclSn: number, cklstSn: number): Promise<CklstRvw>;
|
||||||
|
create(body: CklstRvwSaveRequest): Promise<CklstRvwId>;
|
||||||
|
update(
|
||||||
|
cklstRvwSn: number,
|
||||||
|
cklstArtclSn: number,
|
||||||
|
cklstSn: number,
|
||||||
|
body: CklstRvwUpdateRequest,
|
||||||
|
): Promise<CklstRvwId>;
|
||||||
|
remove(cklstRvwSn: number, cklstArtclSn: number, cklstSn: number): Promise<CklstRvwId>;
|
||||||
|
}
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
import { client } from "@/shared/api";
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
|
||||||
|
import type { CnstpSeMngTreeDto, CnstpService } from "../model/cnstp-interface";
|
||||||
|
|
||||||
|
async function findTree(): Promise<CnstpSeMngTreeDto[]> {
|
||||||
|
const response = await client.get<CnstpSeMngTreeDto[]>(
|
||||||
|
`${ENDPOINT.AS_COMMON_SERVICE.CNSTP_SE}/list/tree`,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const cnstpService = {
|
||||||
|
findTree,
|
||||||
|
} satisfies CnstpService;
|
||||||
@@ -0,0 +1,2 @@
|
|||||||
|
export type { CnstpSeMngTreeDto, CnstpService } from "./model/cnstp-interface";
|
||||||
|
export { cnstpService } from "./api/cnstp-service";
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
/** 공종구분 트리 노드 DTO */
|
||||||
|
export interface CnstpSeMngTreeDto {
|
||||||
|
/** 들여쓰기 포함 표시명 */
|
||||||
|
indCnstpSeCdNm: string;
|
||||||
|
/** 공종구분코드 */
|
||||||
|
cnstpSeCd: string;
|
||||||
|
/** 공종구분코드명 */
|
||||||
|
cnstpSeCdNm: string;
|
||||||
|
/** 상위 공종구분코드 (null = 최상위) */
|
||||||
|
upCnstpCd: string | null;
|
||||||
|
/** 사용여부 */
|
||||||
|
useYn: string;
|
||||||
|
/** 트리 레벨 */
|
||||||
|
treeLevel: number;
|
||||||
|
/** 최상위~현재 노드까지 "|" 구분 경로 */
|
||||||
|
treePath: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 공종구분 서비스 인터페이스 */
|
||||||
|
export interface CnstpService {
|
||||||
|
/** 공종구분 트리 전체 조회 */
|
||||||
|
findTree(): Promise<CnstpSeMngTreeDto[]>;
|
||||||
|
}
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
import { client } from "@/shared/api";
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
|
||||||
|
import type { Code, CodeService } from "../model/code-interface";
|
||||||
|
|
||||||
|
async function getList(upCd: string): Promise<Code[]> {
|
||||||
|
const response = await client.get<Code[]>(`${ENDPOINT.CMS_SERVICE.CODE}/${upCd}`);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function getListByUseYn(upCd: string, useYn: string): Promise<Code[]> {
|
||||||
|
const response = await client.get<Code[]>(`${ENDPOINT.CMS_SERVICE.CODE}/${upCd}/${useYn}`);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function getCodeName(upCd: string, lwpoCd: string): Promise<string> {
|
||||||
|
const response = await client.get<string>(
|
||||||
|
`${ENDPOINT.CMS_SERVICE.CODE}/${upCd}/lwpoCd/${lwpoCd}`,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const codeService = {
|
||||||
|
getList,
|
||||||
|
getListByUseYn,
|
||||||
|
getCodeName,
|
||||||
|
} satisfies CodeService;
|
||||||
@@ -0,0 +1,36 @@
|
|||||||
|
import { useQuery } from "@tanstack/react-query";
|
||||||
|
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
|
||||||
|
import { codeService } from "./code-service";
|
||||||
|
|
||||||
|
const codeBaseKey = [ENDPOINT.CMS_SERVICE.CODE] as const;
|
||||||
|
|
||||||
|
const CODE_STALE_TIME = 1000 * 60 * 10;
|
||||||
|
|
||||||
|
export function useCodeList(upCd: string | undefined) {
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...codeBaseKey, upCd],
|
||||||
|
queryFn: () => codeService.getList(upCd!),
|
||||||
|
enabled: Boolean(upCd),
|
||||||
|
staleTime: CODE_STALE_TIME,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCodeListByUseYn(upCd: string | undefined, useYn: string) {
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...codeBaseKey, upCd, useYn],
|
||||||
|
queryFn: () => codeService.getListByUseYn(upCd!, useYn),
|
||||||
|
enabled: Boolean(upCd && useYn),
|
||||||
|
staleTime: CODE_STALE_TIME,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCodeName(upCd: string | undefined, lwpoCd: string | undefined) {
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...codeBaseKey, upCd, "name", lwpoCd],
|
||||||
|
queryFn: () => codeService.getCodeName(upCd!, lwpoCd!),
|
||||||
|
enabled: Boolean(upCd && lwpoCd),
|
||||||
|
staleTime: CODE_STALE_TIME,
|
||||||
|
});
|
||||||
|
}
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
export { codeService } from "./api/code-service";
|
||||||
|
export { useCodeList, useCodeListByUseYn, useCodeName } from "./api/queries";
|
||||||
|
export { findCodeLabel } from "./lib/find-code-label";
|
||||||
|
export type { Code, CodeService } from "./model/code-interface";
|
||||||
|
export { CodeSelect } from "./ui/code-select";
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
import type { Code } from "../model/code-interface";
|
||||||
|
|
||||||
|
export function findCodeLabel(codes: Code[] | undefined, lwpoCd?: string): string {
|
||||||
|
if (!lwpoCd) return "";
|
||||||
|
if (!codes?.length) return lwpoCd;
|
||||||
|
return codes.find((c) => c.lwpoCd === lwpoCd)?.lwpoCdNm ?? lwpoCd;
|
||||||
|
}
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
/** cms-service CodeResponseDto */
|
||||||
|
export interface Code {
|
||||||
|
lwpoCd: string;
|
||||||
|
upCd: string;
|
||||||
|
lwpoCdNm: string;
|
||||||
|
unit?: string;
|
||||||
|
prntLwpoCd?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CodeService {
|
||||||
|
getList(upCd: string): Promise<Code[]>;
|
||||||
|
getListByUseYn(upCd: string, useYn: string): Promise<Code[]>;
|
||||||
|
getCodeName(upCd: string, lwpoCd: string): Promise<string>;
|
||||||
|
}
|
||||||
@@ -0,0 +1,50 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import {
|
||||||
|
cn,
|
||||||
|
Select,
|
||||||
|
SelectContent,
|
||||||
|
SelectItem,
|
||||||
|
SelectTrigger,
|
||||||
|
SelectValue,
|
||||||
|
} from "@common/components";
|
||||||
|
|
||||||
|
import { useCodeList, useCodeListByUseYn } from "../api/queries";
|
||||||
|
|
||||||
|
interface CodeSelectProps extends React.ComponentPropsWithoutRef<typeof Select> {
|
||||||
|
upCd: string;
|
||||||
|
useYn?: string;
|
||||||
|
placeholder?: string;
|
||||||
|
className?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
function CodeSelect({
|
||||||
|
upCd,
|
||||||
|
useYn,
|
||||||
|
placeholder = "선택",
|
||||||
|
className,
|
||||||
|
...props
|
||||||
|
}: CodeSelectProps) {
|
||||||
|
const listQuery = useCodeList(useYn ? undefined : upCd);
|
||||||
|
const listByUseYnQuery = useCodeListByUseYn(useYn ? upCd : undefined, useYn ?? "");
|
||||||
|
|
||||||
|
const codes = useYn ? listByUseYnQuery.data : listQuery.data;
|
||||||
|
const isLoading = useYn ? listByUseYnQuery.isPending : listQuery.isPending;
|
||||||
|
|
||||||
|
return (
|
||||||
|
<Select {...props} disabled={props.disabled || isLoading}>
|
||||||
|
<SelectTrigger className={cn("w-[12rem]", className)}>
|
||||||
|
<SelectValue placeholder={isLoading ? "로딩 중…" : placeholder} />
|
||||||
|
</SelectTrigger>
|
||||||
|
<SelectContent>
|
||||||
|
{codes?.map((item) => (
|
||||||
|
<SelectItem key={item.lwpoCd} value={item.lwpoCd}>
|
||||||
|
{item.lwpoCdNm}
|
||||||
|
</SelectItem>
|
||||||
|
))}
|
||||||
|
</SelectContent>
|
||||||
|
</Select>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
export { CodeSelect };
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
import { client } from "@/shared/api";
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
import type { PageResponse } from "@/shared/model";
|
||||||
|
|
||||||
|
import type {
|
||||||
|
ElaprApln,
|
||||||
|
ElaprAplnListParams,
|
||||||
|
ElaprAplnReorderRequest,
|
||||||
|
ElaprAplnSaveRequest,
|
||||||
|
ElaprAplnService,
|
||||||
|
ElaprAplnUpdateRequest,
|
||||||
|
} from "../model/elapr-apln-interface";
|
||||||
|
|
||||||
|
async function findPage(params: ElaprAplnListParams): Promise<PageResponse<ElaprApln>> {
|
||||||
|
const response = await client.get<PageResponse<ElaprApln>>(ENDPOINT.AS_ELAPR_SERVICE.ELAPR_APLN, {
|
||||||
|
params,
|
||||||
|
});
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function findById(aplnId: string): Promise<ElaprApln> {
|
||||||
|
const response = await client.get<ElaprApln>(`${ENDPOINT.AS_ELAPR_SERVICE.ELAPR_APLN}/${aplnId}`);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function saveMulti(body: ElaprAplnSaveRequest[]): Promise<ElaprApln[]> {
|
||||||
|
const response = await client.post<ElaprApln[]>(ENDPOINT.AS_ELAPR_SERVICE.ELAPR_APLN, body);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function update(aplnId: string, body: ElaprAplnUpdateRequest): Promise<ElaprApln> {
|
||||||
|
const response = await client.put<ElaprApln>(
|
||||||
|
`${ENDPOINT.AS_ELAPR_SERVICE.ELAPR_APLN}/${aplnId}`,
|
||||||
|
body,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function remove(aplnId: string): Promise<void> {
|
||||||
|
await client.delete(`${ENDPOINT.AS_ELAPR_SERVICE.ELAPR_APLN}/${aplnId}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
async function reorder(body: ElaprAplnReorderRequest): Promise<void> {
|
||||||
|
await client.put(`${ENDPOINT.AS_ELAPR_SERVICE.ELAPR_APLN}/reorder`, body);
|
||||||
|
}
|
||||||
|
|
||||||
|
export const elaprAplnService = {
|
||||||
|
findPage,
|
||||||
|
findById,
|
||||||
|
saveMulti,
|
||||||
|
update,
|
||||||
|
remove,
|
||||||
|
reorder,
|
||||||
|
} satisfies ElaprAplnService;
|
||||||
@@ -0,0 +1,51 @@
|
|||||||
|
import { client } from "@/shared/api";
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
import type { PageResponse } from "@/shared/model";
|
||||||
|
|
||||||
|
import type {
|
||||||
|
ElaprTmplt,
|
||||||
|
ElaprTmpltSaveRequest,
|
||||||
|
ElaprTmpltSearchParams,
|
||||||
|
ElaprTmpltService,
|
||||||
|
ElaprTmpltUpdateRequest,
|
||||||
|
} from "../model/elapr-tmplt-interface";
|
||||||
|
|
||||||
|
async function findPage(params: ElaprTmpltSearchParams): Promise<PageResponse<ElaprTmplt>> {
|
||||||
|
const response = await client.get<PageResponse<ElaprTmplt>>(
|
||||||
|
ENDPOINT.AS_ELAPR_SERVICE.ELAPR_TMPLT,
|
||||||
|
{ params },
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function findById(elaprTmpltId: string): Promise<ElaprTmplt> {
|
||||||
|
const response = await client.get<ElaprTmplt>(
|
||||||
|
`${ENDPOINT.AS_ELAPR_SERVICE.ELAPR_TMPLT}/${elaprTmpltId}`,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function create(body: ElaprTmpltSaveRequest): Promise<ElaprTmplt> {
|
||||||
|
const response = await client.post<ElaprTmplt>(ENDPOINT.AS_ELAPR_SERVICE.ELAPR_TMPLT, body);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function update(elaprTmpltId: string, body: ElaprTmpltUpdateRequest): Promise<ElaprTmplt> {
|
||||||
|
const response = await client.put<ElaprTmplt>(
|
||||||
|
`${ENDPOINT.AS_ELAPR_SERVICE.ELAPR_TMPLT}/${elaprTmpltId}`,
|
||||||
|
body,
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function remove(elaprTmpltId: string): Promise<void> {
|
||||||
|
await client.delete(`${ENDPOINT.AS_ELAPR_SERVICE.ELAPR_TMPLT}/${elaprTmpltId}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
export const elaprTmpltService = {
|
||||||
|
findPage,
|
||||||
|
findById,
|
||||||
|
create,
|
||||||
|
update,
|
||||||
|
remove,
|
||||||
|
} satisfies ElaprTmpltService;
|
||||||
@@ -0,0 +1,176 @@
|
|||||||
|
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
|
||||||
|
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
|
||||||
|
import type {
|
||||||
|
ElaprAplnListParams,
|
||||||
|
ElaprAplnReorderRequest,
|
||||||
|
ElaprAplnSaveRequest,
|
||||||
|
ElaprAplnUpdateRequest,
|
||||||
|
} from "../model/elapr-apln-interface";
|
||||||
|
import type {
|
||||||
|
ElaprTmpltSaveRequest,
|
||||||
|
ElaprTmpltSearchParams,
|
||||||
|
ElaprTmpltUpdateRequest,
|
||||||
|
} from "../model/elapr-tmplt-interface";
|
||||||
|
|
||||||
|
import { elaprAplnService } from "./elapr-apln-service";
|
||||||
|
import { elaprTmpltService } from "./elapr-tmplt-service";
|
||||||
|
|
||||||
|
const elaprTmpltBaseKey = [ENDPOINT.AS_ELAPR_SERVICE.ELAPR_TMPLT] as const;
|
||||||
|
const elaprAplnBaseKey = [ENDPOINT.AS_ELAPR_SERVICE.ELAPR_APLN] as const;
|
||||||
|
|
||||||
|
export function useElaprTmpltPage(params: ElaprTmpltSearchParams) {
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...elaprTmpltBaseKey, "page", params],
|
||||||
|
queryFn: () => elaprTmpltService.findPage(params),
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useElaprTmplt(elaprTmpltId: string | null | undefined) {
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...elaprTmpltBaseKey, elaprTmpltId],
|
||||||
|
queryFn: () => elaprTmpltService.findById(elaprTmpltId!),
|
||||||
|
enabled: Boolean(elaprTmpltId),
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useCreateElaprTmplt() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: (body: ElaprTmpltSaveRequest) => elaprTmpltService.create(body),
|
||||||
|
onSuccess: () => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: elaprTmpltBaseKey });
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useUpdateElaprTmplt() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: ({
|
||||||
|
elaprTmpltId,
|
||||||
|
body,
|
||||||
|
}: {
|
||||||
|
elaprTmpltId: string;
|
||||||
|
body: ElaprTmpltUpdateRequest;
|
||||||
|
}) => elaprTmpltService.update(elaprTmpltId, body),
|
||||||
|
onSuccess: (_data, { elaprTmpltId }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: elaprTmpltBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...elaprTmpltBaseKey, elaprTmpltId],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useDeleteElaprTmplt() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: (elaprTmpltId: string) => elaprTmpltService.remove(elaprTmpltId),
|
||||||
|
onSuccess: () => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: elaprTmpltBaseKey });
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useElaprAplnPage(params: ElaprAplnListParams) {
|
||||||
|
const { elaprTmpltId } = params;
|
||||||
|
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...elaprAplnBaseKey, "page", params],
|
||||||
|
queryFn: () => elaprAplnService.findPage(params),
|
||||||
|
enabled: Boolean(elaprTmpltId),
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useElaprApln(aplnId: string | null | undefined) {
|
||||||
|
return useQuery({
|
||||||
|
queryKey: [...elaprAplnBaseKey, aplnId],
|
||||||
|
queryFn: () => elaprAplnService.findById(aplnId!),
|
||||||
|
enabled: Boolean(aplnId),
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useSaveMultiElaprApln() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: ({
|
||||||
|
body,
|
||||||
|
}: {
|
||||||
|
body: ElaprAplnSaveRequest[];
|
||||||
|
elaprTmpltId: string;
|
||||||
|
}) => elaprAplnService.saveMulti(body),
|
||||||
|
onSuccess: (_data, { elaprTmpltId }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: elaprAplnBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...elaprAplnBaseKey, "page", { elaprTmpltId }],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useUpdateElaprApln() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: ({
|
||||||
|
aplnId,
|
||||||
|
body,
|
||||||
|
}: {
|
||||||
|
aplnId: string;
|
||||||
|
body: ElaprAplnUpdateRequest;
|
||||||
|
}) => elaprAplnService.update(aplnId, body),
|
||||||
|
onSuccess: (_data, { body, aplnId }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: elaprAplnBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...elaprAplnBaseKey, aplnId],
|
||||||
|
});
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...elaprAplnBaseKey, "page", { elaprTmpltId: body.elaprTmpltId }],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useDeleteElaprApln() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: ({
|
||||||
|
aplnId,
|
||||||
|
}: {
|
||||||
|
aplnId: string;
|
||||||
|
elaprTmpltId: string;
|
||||||
|
}) => elaprAplnService.remove(aplnId),
|
||||||
|
onSuccess: (_data, { elaprTmpltId }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: elaprAplnBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...elaprAplnBaseKey, "page", { elaprTmpltId }],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useReorderElaprApln() {
|
||||||
|
const queryClient = useQueryClient();
|
||||||
|
|
||||||
|
return useMutation({
|
||||||
|
mutationFn: ({
|
||||||
|
body,
|
||||||
|
}: {
|
||||||
|
body: ElaprAplnReorderRequest;
|
||||||
|
elaprTmpltId: string;
|
||||||
|
}) => elaprAplnService.reorder(body),
|
||||||
|
onSuccess: (_data, { elaprTmpltId }) => {
|
||||||
|
queryClient.invalidateQueries({ queryKey: elaprAplnBaseKey });
|
||||||
|
queryClient.invalidateQueries({
|
||||||
|
queryKey: [...elaprAplnBaseKey, "page", { elaprTmpltId }],
|
||||||
|
});
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
export { elaprAplnService } from "./api/elapr-apln-service";
|
||||||
|
export { elaprTmpltService } from "./api/elapr-tmplt-service";
|
||||||
|
export {
|
||||||
|
useCreateElaprTmplt,
|
||||||
|
useDeleteElaprApln,
|
||||||
|
useDeleteElaprTmplt,
|
||||||
|
useElaprApln,
|
||||||
|
useElaprAplnPage,
|
||||||
|
useElaprTmplt,
|
||||||
|
useElaprTmpltPage,
|
||||||
|
useReorderElaprApln,
|
||||||
|
useSaveMultiElaprApln,
|
||||||
|
useUpdateElaprApln,
|
||||||
|
useUpdateElaprTmplt,
|
||||||
|
} from "./api/queries";
|
||||||
|
export {
|
||||||
|
ELAPR_APLN_SAVE_MODE,
|
||||||
|
type ElaprApln,
|
||||||
|
type ElaprAplnListParams,
|
||||||
|
type ElaprAplnReorderItem,
|
||||||
|
type ElaprAplnReorderRequest,
|
||||||
|
type ElaprAplnSaveMode,
|
||||||
|
type ElaprAplnSaveRequest,
|
||||||
|
type ElaprAplnService,
|
||||||
|
type ElaprAplnUpdateRequest,
|
||||||
|
} from "./model/elapr-apln-interface";
|
||||||
|
export type {
|
||||||
|
ElaprTmplt,
|
||||||
|
ElaprTmpltSaveRequest,
|
||||||
|
ElaprTmpltSearchParams,
|
||||||
|
ElaprTmpltService,
|
||||||
|
ElaprTmpltUpdateRequest,
|
||||||
|
} from "./model/elapr-tmplt-interface";
|
||||||
@@ -0,0 +1,62 @@
|
|||||||
|
import type { PageableParams, PageResponse } from "@/shared/model";
|
||||||
|
|
||||||
|
export const ELAPR_APLN_SAVE_MODE = {
|
||||||
|
CREATE: "C",
|
||||||
|
UPDATE: "U",
|
||||||
|
DELETE: "D",
|
||||||
|
} as const;
|
||||||
|
|
||||||
|
export type ElaprAplnSaveMode =
|
||||||
|
(typeof ELAPR_APLN_SAVE_MODE)[keyof typeof ELAPR_APLN_SAVE_MODE];
|
||||||
|
|
||||||
|
export interface ElaprApln {
|
||||||
|
aplnId: string;
|
||||||
|
elaprTmpltId: string;
|
||||||
|
aprvrUuid?: string;
|
||||||
|
aprvrNm?: string;
|
||||||
|
atrzSeComCd?: string;
|
||||||
|
atrzSeComNm?: string;
|
||||||
|
atrzSeqNo?: number;
|
||||||
|
regDt?: string;
|
||||||
|
rgtrUuid?: string;
|
||||||
|
mdfcnDt?: string;
|
||||||
|
mdfrUuid?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ElaprAplnListParams extends PageableParams {
|
||||||
|
elaprTmpltId?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ElaprAplnSaveRequest {
|
||||||
|
mode: ElaprAplnSaveMode;
|
||||||
|
aplnId?: string;
|
||||||
|
elaprTmpltId?: string;
|
||||||
|
aprvrUuid?: string;
|
||||||
|
atrzSeComCd?: string;
|
||||||
|
atrzSeqNo?: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ElaprAplnUpdateRequest {
|
||||||
|
elaprTmpltId: string;
|
||||||
|
aprvrUuid?: string;
|
||||||
|
atrzSeComCd?: string;
|
||||||
|
atrzSeqNo?: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ElaprAplnReorderItem {
|
||||||
|
aplnId: string;
|
||||||
|
atrzSeqNo: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ElaprAplnReorderRequest {
|
||||||
|
items: ElaprAplnReorderItem[];
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ElaprAplnService {
|
||||||
|
findPage(params: ElaprAplnListParams): Promise<PageResponse<ElaprApln>>;
|
||||||
|
findById(aplnId: string): Promise<ElaprApln>;
|
||||||
|
saveMulti(body: ElaprAplnSaveRequest[]): Promise<ElaprApln[]>;
|
||||||
|
update(aplnId: string, body: ElaprAplnUpdateRequest): Promise<ElaprApln>;
|
||||||
|
remove(aplnId: string): Promise<void>;
|
||||||
|
reorder(body: ElaprAplnReorderRequest): Promise<void>;
|
||||||
|
}
|
||||||
@@ -0,0 +1,40 @@
|
|||||||
|
import type { PageableParams, PageResponse } from "@/shared/model";
|
||||||
|
|
||||||
|
export interface ElaprTmplt {
|
||||||
|
elaprTmpltId: string;
|
||||||
|
elaprTmpltNm: string;
|
||||||
|
elaprTmpltExpln?: string;
|
||||||
|
docSeComCd?: string;
|
||||||
|
docSeComNm?: string;
|
||||||
|
regDt?: string;
|
||||||
|
rgtrUuid?: string;
|
||||||
|
mdfcnDt?: string;
|
||||||
|
mdfrUuid?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ElaprTmpltSearchParams extends PageableParams {
|
||||||
|
elaprTmpltNm?: string;
|
||||||
|
docSeComCd?: string;
|
||||||
|
regDtStart?: string;
|
||||||
|
regDtEnd?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ElaprTmpltSaveRequest {
|
||||||
|
elaprTmpltNm: string;
|
||||||
|
elaprTmpltExpln?: string;
|
||||||
|
docSeComCd?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ElaprTmpltUpdateRequest {
|
||||||
|
elaprTmpltNm: string;
|
||||||
|
elaprTmpltExpln?: string;
|
||||||
|
docSeComCd?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ElaprTmpltService {
|
||||||
|
findPage(params: ElaprTmpltSearchParams): Promise<PageResponse<ElaprTmplt>>;
|
||||||
|
findById(elaprTmpltId: string): Promise<ElaprTmplt>;
|
||||||
|
create(body: ElaprTmpltSaveRequest): Promise<ElaprTmplt>;
|
||||||
|
update(elaprTmpltId: string, body: ElaprTmpltUpdateRequest): Promise<ElaprTmplt>;
|
||||||
|
remove(elaprTmpltId: string): Promise<void>;
|
||||||
|
}
|
||||||
@@ -0,0 +1,22 @@
|
|||||||
|
import { client } from "@/shared/api";
|
||||||
|
import { ENDPOINT } from "@/shared/config";
|
||||||
|
|
||||||
|
import type {
|
||||||
|
EsntlAtchFileMngSearchParams,
|
||||||
|
EsntlAtchFileMngService,
|
||||||
|
EsntlAtchFileMngTreeResponseDto,
|
||||||
|
} from "../model/esntl-interface";
|
||||||
|
|
||||||
|
async function findTree(
|
||||||
|
params: EsntlAtchFileMngSearchParams,
|
||||||
|
): Promise<EsntlAtchFileMngTreeResponseDto[]> {
|
||||||
|
const response = await client.get<EsntlAtchFileMngTreeResponseDto[]>(
|
||||||
|
`${ENDPOINT.AS_COMMON_SERVICE.ESNTL_ATCH_FILE}/list/tree`,
|
||||||
|
{ params },
|
||||||
|
);
|
||||||
|
return response.data;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const esntlAtchFileMngService = {
|
||||||
|
findTree,
|
||||||
|
} satisfies EsntlAtchFileMngService;
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
export type {
|
||||||
|
EsntlAtchFileMngSearchParams,
|
||||||
|
EsntlAtchFileMngService,
|
||||||
|
EsntlAtchFileMngTreeResponseDto,
|
||||||
|
} from "./model/esntl-interface";
|
||||||
|
export { esntlAtchFileMngService } from "./api/esntl-service";
|
||||||
@@ -0,0 +1,25 @@
|
|||||||
|
/** 필수첨부파일관리 트리 조회 응답 DTO */
|
||||||
|
export interface EsntlAtchFileMngTreeResponseDto {
|
||||||
|
/** 필수첨부파일아이디 */
|
||||||
|
esntlAtchFileId: string;
|
||||||
|
/** 문서구분공통코드 */
|
||||||
|
docSeComCd: string;
|
||||||
|
/** 필수첨부파일명 */
|
||||||
|
esntlAtchFileNm: string;
|
||||||
|
/** 필수첨부여부 ("Y" | "N") */
|
||||||
|
esntlAtchYn: "Y" | "N";
|
||||||
|
/** 필수첨부파일비고 (파일형식 등) */
|
||||||
|
esntlAtchFileRmrk: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 필수첨부파일관리 조회 파라미터 */
|
||||||
|
export interface EsntlAtchFileMngSearchParams {
|
||||||
|
/** 문서구분공통코드 (예: "INSTL") */
|
||||||
|
docSeComCd: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 필수첨부파일관리 서비스 인터페이스 */
|
||||||
|
export interface EsntlAtchFileMngService {
|
||||||
|
/** 필수첨부파일 트리 조회 */
|
||||||
|
findTree(params: EsntlAtchFileMngSearchParams): Promise<EsntlAtchFileMngTreeResponseDto[]>;
|
||||||
|
}
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user