๋ธ”๋กœ๊ทธ๋กœ ๋Œ์•„๊ฐ€๊ธฐ

๐Ÿ‘ค NestJS + Next.js ERP ์‹œ์Šคํ…œ ๊ฐœ๋ฐœ์ผ์ง€ #7: ์‚ฌ์šฉ์ž ํ”„๋กœํ•„ ์‹œ์Šคํ…œ ๊ตฌ์ถ•

๐Ÿ“ 2025๋…„ 9์›” 24์ผ ๊ฐœ๋ฐœ ํ™œ๋™

์•ˆ๋…•ํ•˜์„ธ์š”! ์˜ค๋Š˜์€ ERP ์‹œ์Šคํ…œ์˜ ์‚ฌ์šฉ์ž ํ”„๋กœํ•„ ๋ฐ ์„ค์ • ์‹œ์Šคํ…œ์„ ๊ตฌ์ถ•ํ•˜๊ณ , ์‹œ์Šคํ…œ ์•ˆ์ •์„ฑ์„ ๊ฐœ์„ ํ•œ ํ•˜๋ฃจ์˜€์Šต๋‹ˆ๋‹ค. ๊ฐœ๋ฐœ ๊ณผ์ •๊ณผ ๋ฐฐ์šด ์ ๋“ค์„ ๊ณต์œ ํ•ด๋“œ๋ฆฌ๊ฒ ์Šต๋‹ˆ๋‹ค.

๐ŸŽฏ ์˜ค๋Š˜์˜ ๊ฐœ๋ฐœ ๋ชฉํ‘œ

  • ์‚ฌ์šฉ์ž ํ”„๋กœํ•„ ๊ด€๋ฆฌ ์‹œ์Šคํ…œ ๊ตฌ์ถ•
  • ์„ค์ • ํŽ˜์ด์ง€ ๊ธฐ๋ณธ ๊ตฌ์กฐ ๊ตฌํ˜„
  • ์‹œ์Šคํ…œ ์•ˆ์ •์„ฑ ๊ฐœ์„  ๋ฐ ๋ฒ„๊ทธ ์ˆ˜์ •

๐Ÿ› ๏ธ ์ฃผ์š” ๊ฐœ๋ฐœ ๋‚ด์šฉ

1. ํ”„๋กœํ•„ ๋ฐ ์„ค์ • ํŽ˜์ด์ง€ ์ถ”๊ฐ€

โœ… ๊ตฌํ˜„ํ•œ ๊ธฐ๋Šฅ

  • ์‚ฌ์šฉ์ž ํ”„๋กœํ•„ ์กฐํšŒ ๋ฐ ์ˆ˜์ • ํŽ˜์ด์ง€
  • ์„ค์ • ํŽ˜์ด์ง€ ๊ธฐ๋ณธ ๊ตฌ์กฐ
  • ๋ชจ๋“  ์‚ฌ์šฉ์ž๊ฐ€ ์ ‘๊ทผ ๊ฐ€๋Šฅํ•œ ์ƒ๋‹จ ๋ฐ” ๊ธฐ๋Šฅ

๊ธฐ์ˆ ์  ํŠน์ง•

// ํ”„๋กœํ•„ ํŽ˜์ด์ง€ ์ฃผ์š” ๊ธฐ๋Šฅ const ProfilePage = () => { const { user, refreshUserProfile } = useAuth(); const [isEditing, setIsEditing] = useState(false); const handleSave = async () => { await apiClient.patch(API_ENDPOINTS.USERS.UPDATE_PROFILE, formData); await refreshUserProfile(); }; };

์‚ฌ์šฉ์ž ๊ฒฝํ—˜ ๊ฐœ์„ 

  • ์ง๊ด€์ ์ธ ํ”„๋กœํ•„ ์ˆ˜์ • ์ธํ„ฐํŽ˜์ด์Šค
  • ์‹ค์‹œ๊ฐ„ ๋ฐ์ดํ„ฐ ๋™๊ธฐํ™”
  • ๋ฐ˜์‘ํ˜• ๋””์ž์ธ ์ ์šฉ

2. ์‚ฌ์šฉ์ž ํ”„๋กœํ•„ ์—…๋ฐ์ดํŠธ API ๊ตฌํ˜„

๐Ÿ”ง ๋ฐฑ์—”๋“œ API ๊ฐœ๋ฐœ

  • RESTful API ํŒจํ„ด ์ ์šฉ
  • ๊ถŒํ•œ๋ณ„ ํ•„๋“œ ๋ณ€๊ฒฝ ์ œํ•œ
  • ์•ˆ์ „ํ•œ ๋ฐ์ดํ„ฐ ์—…๋ฐ์ดํŠธ
// ๋ฐฑ์—”๋“œ API ๊ตฌํ˜„ @Patch('profile') @ApiOperation({ summary: '๋‚ด ํ”„๋กœํ•„ ์ˆ˜์ •' }) async updateProfile( @Request() req, @Body() updateUserDto: UpdateUserDto, ): Promise<ApiResponseDto<UserResponseDto>> { const user = await this.usersService.updateProfile(req.user.id, updateUserDto); return new ApiResponseDto(user, true, 'ํ”„๋กœํ•„์ด ์ˆ˜์ •๋˜์—ˆ์Šต๋‹ˆ๋‹ค.'); }

๋ณด์•ˆ ๊ฐ•ํ™”

  • ์—ญํ• , ์กฐ์ง, ํ™œ์„ฑํ™” ์ƒํƒœ ๋ณ€๊ฒฝ ์ œํ•œ
  • ์‚ฌ์šฉ์ž๋ณ„ ๊ถŒํ•œ ๊ฒ€์ฆ
  • ์•ˆ์ „ํ•œ ๋ฐ์ดํ„ฐ ์—…๋ฐ์ดํŠธ

3. useAuth ํ›… ์•ˆ์ •์„ฑ ๊ฐœ์„ 

โŒ ๋ฌธ์ œ ์ƒํ™ฉ

์ˆœํ™˜ ์ฐธ์กฐ ๋ฌธ์ œ๋กœ ์ธํ•œ useAuth ํ›… ๋ถˆ์•ˆ์ •์„ฑ

โœ… ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•

์ˆœํ™˜ ์ฐธ์กฐ ํ•ด๊ฒฐ์„ ํ†ตํ•œ ์•ˆ์ •์„ฑ ๊ฐœ์„ 

// ๋ฌธ์ œ ์ƒํ™ฉ: ์ˆœํ™˜ ์ฐธ์กฐ const fetchUserProfile = useCallback(async () => { try { // ... API ํ˜ธ์ถœ } catch (error) { logout(); // โŒ ์ˆœํ™˜ ์ฐธ์กฐ ๋ฐœ์ƒ } }, [logout]); // ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•: ์ˆœํ™˜ ์ฐธ์กฐ ํ•ด๊ฒฐ const fetchUserProfile = useCallback(async () => { try { // ... API ํ˜ธ์ถœ } catch (error) { // ๋กœ๊ทธ์•„์›ƒ ๋กœ์ง์„ ์ง์ ‘ ๊ตฌํ˜„ apiClient.clearToken(); setUser(null); localStorage.removeItem('user'); } }, []);

4. ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ ์˜ค๋ฅ˜ ์ˆ˜์ •

โŒ ๋ฌธ์ œ ์ƒํ™ฉ

Error: column applicant.isblocked does not exist

โœ… ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•

User ์—”ํ‹ฐํ‹ฐ ๊ตฌ์กฐ์™€ ๋ถˆ์ผ์น˜ํ•˜๋Š” ํ•„๋“œ ์ฐธ์กฐ ์ˆ˜์ •

// ์ˆ˜์ • ์ „ .groupBy('...applicant.isBlocked, applicant.blockReason...') // ์ˆ˜์ • ํ›„ .groupBy('...applicant.memo...')

๐Ÿ”ง ๊ธฐ์ˆ ์  ๊ฐœ์„ ์‚ฌํ•ญ

๋ฐฑ์—”๋“œ ๊ฐœ์„ 

๐Ÿ”ง
API ์„ค๊ณ„
RESTful API ํŒจํ„ด ์ ์šฉ
๐Ÿ”’
๋ณด์•ˆ
๊ถŒํ•œ๋ณ„ ํ•„๋“œ ๋ณ€๊ฒฝ ์ œํ•œ
๐Ÿ—„๏ธ
๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค
์ฟผ๋ฆฌ ์ตœ์ ํ™” ๋ฐ ์˜ค๋ฅ˜ ์ˆ˜์ •

ํ”„๋ก ํŠธ์—”๋“œ ๊ฐœ์„ 

โš›๏ธ
์ƒํƒœ ๊ด€๋ฆฌ
useAuth ํ›… ์•ˆ์ •์„ฑ ํ–ฅ์ƒ
๐ŸŽจ
UI/UX
์ง๊ด€์ ์ธ ํ”„๋กœํ•„ ๊ด€๋ฆฌ ์ธํ„ฐํŽ˜์ด์Šค
๐Ÿ”—
API ํ†ตํ•ฉ
์ผ๊ด€๋œ API ํด๋ผ์ด์–ธํŠธ ์‚ฌ์šฉ

์‹œ์Šคํ…œ ์•ˆ์ •์„ฑ

โœ… ๊ฐœ์„ ๋œ ์•ˆ์ •์„ฑ

  • ์ˆœํ™˜ ์ฐธ์กฐ ํ•ด๊ฒฐ: useAuth ํ›… ์•ˆ์ •์„ฑ ๊ฐœ์„ 
  • ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์˜ค๋ฅ˜ ์ˆ˜์ •: ์ฟผ๋ฆฌ ์•ˆ์ •์„ฑ ํ–ฅ์ƒ
  • API ์˜ค๋ฅ˜ ํ•ด๊ฒฐ: 500 ์—๋Ÿฌ ์ˆ˜์ •

๐Ÿ“Š ๊ฐœ๋ฐœ ํ†ต๊ณ„

5
์ด ์ปค๋ฐ‹
2
๊ธฐ๋Šฅ ์ถ”๊ฐ€
3
๋ฒ„๊ทธ ์ˆ˜์ •
659
์ฝ”๋“œ ์ถ”๊ฐ€

ํŒŒ์ผ ๋ณ€๊ฒฝ

  • ๋ฐฑ์—”๋“œ: 3๊ฐœ ํŒŒ์ผ ์ˆ˜์ •
  • ํ”„๋ก ํŠธ์—”๋“œ: 4๊ฐœ ํŒŒ์ผ ์ˆ˜์ •
  • ์ƒˆ๋กœ์šด ํŽ˜์ด์ง€: 2๊ฐœ ์ถ”๊ฐ€

๐Ÿ† ์ฃผ์š” ์„ฑ๊ณผ

์‚ฌ์šฉ์ž ๊ฒฝํ—˜ ๊ฐœ์„ 

โœ… ๋‹ฌ์„ฑํ•œ ๊ธฐ๋Šฅ๋“ค

  • ๊ฐœ์ธ ํ”„๋กœํ•„ ๊ด€๋ฆฌ ๊ธฐ๋Šฅ ์ถ”๊ฐ€
  • ์„ค์ • ํŽ˜์ด์ง€ ๊ธฐ๋ณธ ๊ตฌ์กฐ ๊ตฌ์ถ•
  • ์ง๊ด€์ ์ธ ๋„ค๋น„๊ฒŒ์ด์…˜ ๊ตฌ์กฐ

์‹œ์Šคํ…œ ์•ˆ์ •์„ฑ ํ–ฅ์ƒ

โœ… ๊ฐœ์„ ๋œ ์•ˆ์ •์„ฑ

  • ์ˆœํ™˜ ์ฐธ์กฐ ๋ฌธ์ œ ํ•ด๊ฒฐ
  • ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ ์˜ค๋ฅ˜ ์ˆ˜์ •
  • API ์•ˆ์ •์„ฑ ๊ฐœ์„ 

์ฝ”๋“œ ํ’ˆ์งˆ ํ–ฅ์ƒ

โœ… ๊ฐœ์„ ๋œ ์ฝ”๋“œ ํ’ˆ์งˆ

  • ๊ธฐ๋Šฅ๋ณ„ ๋ช…ํ™•ํ•œ ์ปค๋ฐ‹ ๋ถ„๋ฆฌ
  • ์ƒ์„ธํ•œ ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€
  • ์ฒด๊ณ„์ ์ธ ๊ฐœ๋ฐœ ํ”„๋กœ์„ธ์Šค

๐Ÿš€ ๋ฐฐ์šด ์ ๊ณผ ์ธ์‚ฌ์ดํŠธ

1. ์ˆœํ™˜ ์ฐธ์กฐ ๋ฌธ์ œ ํ•ด๊ฒฐ

๐Ÿ’ก ํ•ต์‹ฌ ๊ตํ›ˆ

  • ๋ฌธ์ œ: useAuth ํ›…์—์„œ logout ํ•จ์ˆ˜ ์ฐธ์กฐ๋กœ ์ธํ•œ ์ˆœํ™˜ ์ฐธ์กฐ
  • ํ•ด๊ฒฐ: ๋กœ๊ทธ์•„์›ƒ ๋กœ์ง์„ ์ง์ ‘ ๊ตฌํ˜„ํ•˜์—ฌ ์˜์กด์„ฑ ์ œ๊ฑฐ
  • ๊ตํ›ˆ: ํ›… ๊ฐ„ ์˜์กด์„ฑ์„ ์ตœ์†Œํ™”ํ•˜๊ณ  ๋‹จ์ˆœํ•œ ๊ตฌ์กฐ ์œ ์ง€

2. ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ ์ตœ์ ํ™”

๐Ÿ’ก ํ•ต์‹ฌ ๊ตํ›ˆ

  • ๋ฌธ์ œ: ์กด์žฌํ•˜์ง€ ์•Š๋Š” ํ•„๋“œ ์ฐธ์กฐ๋กœ ์ธํ•œ 500 ์—๋Ÿฌ
  • ํ•ด๊ฒฐ: ์—”ํ‹ฐํ‹ฐ ๊ตฌ์กฐ์™€ ์ฟผ๋ฆฌ ์ผ์น˜์„ฑ ํ™•์ธ
  • ๊ตํ›ˆ: ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์Šคํ‚ค๋งˆ ๋ณ€๊ฒฝ ์‹œ ๊ด€๋ จ ์ฟผ๋ฆฌ ์ „์ฒด ๊ฒ€ํ†  ํ•„์š”

3. ์‚ฌ์šฉ์ž ๊ฒฝํ—˜ ์ค‘์‹ฌ ๊ฐœ๋ฐœ

๐Ÿ’ก ํ•ต์‹ฌ ๊ตํ›ˆ

  • ์ ‘๊ทผ: ๋ชจ๋“  ์‚ฌ์šฉ์ž๊ฐ€ ์ ‘๊ทผ ๊ฐ€๋Šฅํ•œ ์ƒ๋‹จ ๋ฐ” ๊ธฐ๋Šฅ
  • ๊ตฌํ˜„: ์ง๊ด€์ ์ธ ํ”„๋กœํ•„ ๊ด€๋ฆฌ ์ธํ„ฐํŽ˜์ด์Šค
  • ๊ตํ›ˆ: ์‚ฌ์šฉ์ž ๊ด€์ ์—์„œ ๊ธฐ๋Šฅ ์„ค๊ณ„์˜ ์ค‘์š”์„ฑ

๐Ÿ”ฎ ํ–ฅํ›„ ๊ณ„ํš

๋‹จ๊ธฐ ๊ณ„ํš

  • ์„ค์ • ํŽ˜์ด์ง€ ๊ธฐ๋Šฅ ํ™•์žฅ
  • ์‚ฌ์šฉ์ž ์ฐธ์—ฌ ์ด๋ ฅ ๊ด€๋ฆฌ ์‹œ์Šคํ…œ
  • ๊ณ ๊ธ‰ ํ”„๋กœํ•„ ๊ด€๋ฆฌ ๊ธฐ๋Šฅ

์žฅ๊ธฐ ๊ณ„ํš

  • AI ๊ธฐ๋ฐ˜ ์‚ฌ์šฉ์ž ์ถ”์ฒœ ์‹œ์Šคํ…œ
  • ๊ณ ๊ธ‰ ๋ถ„์„ ๋ฐ ๋ฆฌํฌํŒ… ๊ธฐ๋Šฅ
  • ๋ชจ๋ฐ”์ผ ์•ฑ ์—ฐ๋™

๐Ÿ’ก ๊ฐœ๋ฐœ ํŒ

1. ์ปค๋ฐ‹ ์ „๋žต

# ๊ธฐ๋Šฅ๋ณ„ ๋ช…ํ™•ํ•œ ์ปค๋ฐ‹ ๋ถ„๋ฆฌ feat: ์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ ์ถ”๊ฐ€ fix: ๋ฒ„๊ทธ ์ˆ˜์ • refactor: ์ฝ”๋“œ ๋ฆฌํŒฉํ† ๋ง docs: ๋ฌธ์„œ ์ˆ˜์ •

2. ์—๋Ÿฌ ์ฒ˜๋ฆฌ

// ์ˆœํ™˜ ์ฐธ์กฐ ๋ฐฉ์ง€ const handleError = useCallback(() => { // ์ง์ ‘ ๊ตฌํ˜„์œผ๋กœ ์˜์กด์„ฑ ์ œ๊ฑฐ }, []);

3. API ์„ค๊ณ„

// ๋ณด์•ˆ ๊ฐ•ํ™” const updateProfile = async (userId: string, data: UpdateUserDto) => { // ๊ถŒํ•œ๋ณ„ ํ•„๋“œ ๋ณ€๊ฒฝ ์ œํ•œ const { role, organizationId, isActive, ...allowedFields } = data; return await this.userRepository.update(userId, allowedFields); };

๐ŸŽ‰ ๋งˆ๋ฌด๋ฆฌ

๐Ÿ’ญ ๊ฐœ๋ฐœ์„ ๋งˆ์น˜๋ฉฐ ๋А๋‚€ ์ 

์˜ค๋Š˜์€ ์‚ฌ์šฉ์ž ํ”„๋กœํ•„ ์‹œ์Šคํ…œ์„ ๊ตฌ์ถ•ํ•˜๊ณ  ์‹œ์Šคํ…œ ์•ˆ์ •์„ฑ์„ ํฌ๊ฒŒ ๊ฐœ์„ ํ•œ ํ•˜๋ฃจ์˜€์Šต๋‹ˆ๋‹ค. ์ˆœํ™˜ ์ฐธ์กฐ ๋ฌธ์ œ ํ•ด๊ฒฐ๊ณผ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ ์˜ค๋ฅ˜ ์ˆ˜์ •์„ ํ†ตํ•ด ์‹œ์Šคํ…œ์˜ ์•ˆ์ •์„ฑ์„ ๋†’์˜€๊ณ , ์‚ฌ์šฉ์ž ๊ฒฝํ—˜์„ ๊ฐœ์„ ํ•  ์ˆ˜ ์žˆ์—ˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ”ง ๊ธฐ์ˆ ์  ์„ฑ์žฅ

์ˆœํ™˜ ์ฐธ์กฐ ๋ฌธ์ œ ํ•ด๊ฒฐ์„ ํ†ตํ•ด React ํ›…์˜ ์˜ฌ๋ฐ”๋ฅธ ์‚ฌ์šฉ๋ฒ•์„ ๋ฐฐ์› ๊ณ , ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ ์ตœ์ ํ™”๋ฅผ ํ†ตํ•ด ๋ฐฑ์—”๋“œ ๊ฐœ๋ฐœ ์—ญ๋Ÿ‰์„ ํ–ฅ์ƒ์‹œํ‚ฌ ์ˆ˜ ์žˆ์—ˆ์Šต๋‹ˆ๋‹ค.

๐ŸŽจ ์‚ฌ์šฉ์ž ์ค‘์‹ฌ ๊ฐœ๋ฐœ

๋ชจ๋“  ์‚ฌ์šฉ์ž๊ฐ€ ์ ‘๊ทผ ๊ฐ€๋Šฅํ•œ ํ”„๋กœํ•„ ๊ด€๋ฆฌ ์‹œ์Šคํ…œ์„ ๊ตฌ์ถ•ํ•˜๋ฉด์„œ ์‚ฌ์šฉ์ž ๊ฒฝํ—˜์˜ ์ค‘์š”์„ฑ์„ ๋‹ค์‹œ ํ•œ๋ฒˆ ๊นจ๋‹ฌ์•˜์Šต๋‹ˆ๋‹ค. ์ž‘์€ ๊ฐœ์„ ์ด ์ „์ฒด ์‹œ์Šคํ…œ์˜ ์‚ฌ์šฉ์„ฑ์„ ํฌ๊ฒŒ ํ–ฅ์ƒ์‹œํ‚จ๋‹ค๋Š” ๊ฒƒ์„ ์‹ค๊ฐํ–ˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ›ก๏ธ ์‹œ์Šคํ…œ ์•ˆ์ •์„ฑ

์ˆœํ™˜ ์ฐธ์กฐ์™€ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ฟผ๋ฆฌ ์˜ค๋ฅ˜๋ฅผ ํ•ด๊ฒฐํ•˜๋ฉด์„œ ์‹œ์Šคํ…œ์˜ ์•ˆ์ •์„ฑ์„ ํฌ๊ฒŒ ํ–ฅ์ƒ์‹œํ‚ฌ ์ˆ˜ ์žˆ์—ˆ์Šต๋‹ˆ๋‹ค. ์ด๋Ÿฌํ•œ ๊ฒฝํ—˜์€ ์•ž์œผ๋กœ ๋”์šฑ ๊ฒฌ๊ณ ํ•œ ์‹œ์Šคํ…œ์„ ๊ตฌ์ถ•ํ•˜๋Š” ๋ฐ ํฐ ๋„์›€์ด ๋  ๊ฒƒ์ž…๋‹ˆ๋‹ค.

๐Ÿš€ ์•ž์œผ๋กœ์˜ ๋‹ค์ง

์•ž์œผ๋กœ๋„ ์‚ฌ์šฉ์ž ์ค‘์‹ฌ์˜ ๊ฐœ๋ฐœ์„ ํ†ตํ•ด ๋” ๋‚˜์€ ERP ์‹œ์Šคํ…œ์„ ๋งŒ๋“ค์–ด๊ฐ€๊ฒ ์Šต๋‹ˆ๋‹ค! ์ง€์†์ ์ธ ๊ฐœ์„ ๊ณผ ์•ˆ์ •์„ฑ ํ–ฅ์ƒ์„ ํ†ตํ•ด ์‚ฌ์šฉ์ž์—๊ฒŒ ์ง„์ •ํ•œ ๊ฐ€์น˜๋ฅผ ์ œ๊ณตํ•˜๋Š” ์‹œ์Šคํ…œ์„ ๊ตฌ์ถ•ํ•˜๊ฒ ์Šต๋‹ˆ๋‹ค.

ํ•จ๊ป˜ ์„ฑ์žฅํ•˜๋Š” ๊ฐœ๋ฐœ์ž๊ฐ€ ๋˜๊ฒ ์Šต๋‹ˆ๋‹ค! ๐Ÿš€