๐ NestJS + Next.js ERP ์์คํ ๊ฐ๋ฐ์ผ์ง #5: ํ๋ก๊ทธ๋จ ์ ์ฒญ์ ์ฌ์ฌ ์์คํ ๊ฐ๋ฐ - ๋ฌธ์ ํด๊ฒฐ ๊ณผ์ ์์ธ ๊ธฐ๋ก
๐ฏ ํ๋ก์ ํธ ๊ฐ์
ERP ์์คํ ์ ํ๋ก๊ทธ๋จ ์ ์ฒญ์ ๊ด๋ฆฌ ๊ธฐ๋ฅ์ ํ์ฅํ์ฌ, ๊ด๋ฆฌ์๊ฐ ์ ์ฒญ์๋ฅผ ์ฌ์ฌํ๊ณ ์ ๊ธ ์ํ๋ฅผ ๊ด๋ฆฌํ ์ ์๋ ์์คํ ์ ๊ฐ๋ฐํ์ต๋๋ค. ์ด ๊ธ์์๋ ๊ฐ๋ฐ ๊ณผ์ ์์ ๋ฐ์ํ ๋ชจ๋ ๋ฌธ์ ์ ๋ค๊ณผ ํด๊ฒฐ ๋ฐฉ๋ฒ์ ์์๋๋ก ์์ธํ ๊ธฐ๋กํฉ๋๋ค.
๐ ๋ชฉ์ฐจ
๐ ํ๋ก์ ํธ ๊ฐ์
ERP ์์คํ ์ ํ๋ก๊ทธ๋จ ์ ์ฒญ์ ๊ด๋ฆฌ ๊ธฐ๋ฅ์ ํ์ฅํ์ฌ, ๊ด๋ฆฌ์๊ฐ ์ ์ฒญ์๋ฅผ ์ฌ์ฌํ๊ณ ์ ๊ธ ์ํ๋ฅผ ๊ด๋ฆฌํ ์ ์๋ ์์คํ ์ ๊ฐ๋ฐํ์ต๋๋ค. ์ด๋ฒ ํ๋ก์ ํธ์์๋ Docker ํ๊ฒฝ์์์ ๊ฐ๋ฐ, ๋ฐ์ดํฐ๋ฒ ์ด์ค ์คํค๋ง ๊ด๋ฆฌ, React ์ปดํฌ๋ํธ ๊ฐ๋ฐ ๋ฑ ๋ค์ํ ๋ฌธ์ ๋ค์ ๊ฒฝํํ๋ฉฐ ํด๊ฒฐํ๋ ๊ณผ์ ์ ์์ธํ ๊ธฐ๋กํฉ๋๋ค.
๐ ๏ธ ๊ธฐ์ ์คํ
โก ๊ตฌํํ ๊ธฐ๋ฅ
1. ๋ฐ์ดํฐ๋ฒ ์ด์ค ์คํค๋ง ํ์ฅ
- Application ์ํฐํฐ์
isPaymentReceived,paymentReceivedAtํ๋ ์ถ๊ฐ - Program ์ํฐํฐ์
revenueํ๋ ์ถ๊ฐ
2. ๋ฐฑ์๋ API ๊ฐ๋ฐ
/api/applications/:id/review- ์ ์ฒญ์ ์ฌ์ฌ (ํฉ๊ฒฉ/๋ถํฉ๊ฒฉ)/api/applications/:id/payment- ์ ๊ธ ์ํ ์ ๋ฐ์ดํธ
3. ํ๋ก ํธ์๋ UI ๊ฐ๋ฐ
- ์ฌ์ฌํ๊ธฐ Dialog ์ปดํฌ๋ํธ
- ์ ๊ธ ํ์ธ ์ฒดํฌ๋ฐ์ค
- ๋งค์ถ ํ์ ๊ธฐ๋ฅ
๐ง ๋ฐ์ํ ๋ฌธ์ ๋ค๊ณผ ํด๊ฒฐ ๊ณผ์
๋ฌธ์ 1: Docker ๋น๋ ์บ์๋ก ์ธํ ์ฝ๋ ๋ฐ์ ์คํจ
๋ฌธ์ ์ํฉ
- ์ฝ๋ ๋ณ๊ฒฝ ํ
docker-compose up์คํํ์ง๋ง ์๋ก์ด API ์๋ํฌ์ธํธ๊ฐ ๋ฑ๋ก๋์ง ์์ - ๋ฐฑ์๋ ๋ก๊ทธ์์
/api/applications/:id/review,/api/applications/:id/payment์๋ํฌ์ธํธ๊ฐ ๋ณด์ด์ง ์์
์์ธ ๋ถ์
- Docker์ ๋น๋ ์บ์๊ฐ ์ด์ ์ฝ๋๋ฅผ ์ ์งํ๊ณ ์์
- TypeScript ์ปดํ์ผ ๊ณผ์ ์์ ์๋ก์ด ์ฝ๋๊ฐ ๋ฐ์๋์ง ์์
ํด๊ฒฐ ๋ฐฉ๋ฒ
# 1. ๋ชจ๋ ์ปจํ
์ด๋ ์ค์ง
docker-compose down
# 2. Docker ์์คํ
์บ์ ์์ ์ญ์
docker system prune -a -f
# 3. ๊ฐ์ ์ฌ๋น๋ ๋ฐ ์ฌ์์ฑ
docker-compose up --build --force-recreate -d postgres redis backend
๋ฌธ์ 2: ๋ฐ์ดํฐ๋ฒ ์ด์ค ์คํค๋ง ๋๊ธฐํ ์คํจ
๋ฌธ์ ์ํฉ
- TypeORM์
synchronize: true์ค์ ์ด Docker ํ๊ฒฝ์์ ์๋ํ์ง ์์ - ์๋ก์ด ์ปฌ๋ผ๋ค์ด ๋ฐ์ดํฐ๋ฒ ์ด์ค์ ์ถ๊ฐ๋์ง ์์
์์ธ ๋ถ์
- Docker ์ปจํ ์ด๋ ๋ด๋ถ์ TypeORM ์ค์ ๋ฌธ์
- ๋ฐ์ดํฐ๋ฒ ์ด์ค ๋ง์ด๊ทธ๋ ์ด์ ์ด ์๋์ผ๋ก ์คํ๋์ง ์์
ํด๊ฒฐ ๋ฐฉ๋ฒ
-- ์๋์ผ๋ก ์ปฌ๋ผ ์ถ๊ฐ
ALTER TABLE applications ADD COLUMN "isPaymentReceived" boolean DEFAULT false;
ALTER TABLE applications ADD COLUMN "paymentReceivedAt" timestamp;
ALTER TABLE programs ADD COLUMN revenue integer DEFAULT 0;
ALTER TABLE users ADD COLUMN "isBlocked" boolean DEFAULT false;
ALTER TABLE users ADD COLUMN "blockReason" text;
๋ฌธ์ 3: Dialog ์ปดํฌ๋ํธ undefined prop ๊ฒฝ๊ณ
๋ฌธ์ ์ํฉ
- React ๊ฐ๋ฐ์ ๋๊ตฌ์์
{undefined}for {DialogContent} ๊ฒฝ๊ณ ๋ฐ์ - Dialog ์ปดํฌ๋ํธ๊ฐ ์ ์์ ์ผ๋ก ์๋ํ์ง ์์
์์ธ ๋ถ์
DialogTrigger์asChildprop๊ณผButton์ปดํฌ๋ํธ ๊ฐ์ ํธํ์ฑ ๋ฌธ์ - Button ์ปดํฌ๋ํธ์ ํ์ํ props๊ฐ ๋๋ฝ๋จ
ํด๊ฒฐ ๋ฐฉ๋ฒ
// ์์ ์
<DialogTrigger asChild>
<Button variant="outline" size="sm">
์ฌ์ฌํ๊ธฐ
</Button>
</DialogTrigger>
// ์์ ํ
<DialogTrigger asChild>
<Button variant="outline" size="sm" type="button">
์ฌ์ฌํ๊ธฐ
</Button>
</DialogTrigger>
๋ฌธ์ 4: API ์๋ํฌ์ธํธ 404 ์ค๋ฅ
๋ฌธ์ ์ํฉ
- ํ๋ก ํธ์๋์์
PATCH /api/applications/:id/reviewํธ์ถ ์ 404 Not Found ์ค๋ฅ - ๋ฐฑ์๋ ๋ก๊ทธ์์ ํด๋น ์๋ํฌ์ธํธ๊ฐ ๋ฑ๋ก๋์ง ์์
์์ธ ๋ถ์
- Docker ๋น๋ ๊ณผ์ ์์ ์๋ก์ด ์ฝ๋๊ฐ ์ ๋๋ก ๋ฐ์๋์ง ์์
- TypeScript ์ปดํ์ผ ๊ณผ์ ์์ ๋ฌธ์ ๋ฐ์
ํด๊ฒฐ ๋ฐฉ๋ฒ
# 1. ๋ฐฑ์๋ ์ปจํ
์ด๋ ๋ด๋ถ์์ ์๋ ๋น๋
docker-compose exec backend npm run build
# 2. ๋ฐฑ์๋ ์ปจํ
์ด๋ ์ฌ์์
docker-compose restart backend
# 3. ๋ก๊ทธ ํ์ธ
docker-compose logs backend | grep -A 20 "ApplicationsController"
๋ฌธ์ 5: ๋ฐ์ดํฐ๋ฒ ์ด์ค ์คํค๋ง ๋ถ์ผ์น๋ก ์ธํ 500 ์ค๋ฅ
๋ฌธ์ ์ํฉ
- API ํธ์ถ ์ 500 Internal Server Error ๋ฐ์
- ๋ฐฑ์๋ ๋ก๊ทธ์์
applicant.isblocked์ปฌ๋ผ์ด ์กด์ฌํ์ง ์๋๋ค๋ ์ค๋ฅ
์์ธ ๋ถ์
- ApplicationsService์ GROUP BY ์ ์
applicant.isBlocked์applicant.blockReasonํฌํจ - ์ด ํ๋๋ค์ด ์ง๊ณ ํจ์๊ฐ ์๋๋ฏ๋ก GROUP BY์ ํฌํจํ ์ ์์
ํด๊ฒฐ ๋ฐฉ๋ฒ
// ์์ ์ - GROUP BY์ ์ง๊ณ ํจ์๊ฐ ์๋ ํ๋ ํฌํจ
.groupBy('application.id, program.id, organizer.id, applicant.id, organization.id, selection.id, program.title, program.description, program.summary, program.organizerId, program.status, program.applyStart, program.applyEnd, program.programStart, program.programEnd, program.location, program.fee, program.maxParticipants, program.applicationForm, program.metadata, program.imageUrl, program.isActive, program.createdAt, program.updatedAt, organizer.name, organizer.type, organizer.address, organizer.contact, organizer.description, organizer.isActive, organizer.createdAt, organizer.updatedAt, applicant.email, applicant.passwordHash, applicant.name, applicant.role, applicant.organizationId, applicant.phone, applicant.isActive, applicant.isBlocked, applicant.blockReason, applicant.lastLoginAt, applicant.createdAt, applicant.updatedAt, organization.name, organization.type, organization.address, organization.contact, organization.description, organization.isActive, organization.createdAt, organization.updatedAt, selection.id, selection.name, selection.description, selection.isActive, selection.createdAt, selection.updatedAt')
// ์์ ํ - ์ง๊ณ ํจ์๊ฐ ์๋ ํ๋ ์ ๊ฑฐ
.groupBy('application.id, program.id, organizer.id, applicant.id, organization.id, selection.id, program.title, program.description, program.summary, program.organizerId, program.status, program.applyStart, program.applyEnd, program.programStart, program.programEnd, program.location, program.fee, program.maxParticipants, program.applicationForm, program.metadata, program.imageUrl, program.isActive, program.createdAt, program.updatedAt, organizer.name, organizer.type, organizer.address, organizer.contact, organizer.description, organizer.isActive, organizer.createdAt, organizer.updatedAt, applicant.email, applicant.passwordHash, applicant.name, applicant.role, applicant.organizationId, applicant.phone, applicant.isActive, applicant.lastLoginAt, applicant.createdAt, applicant.updatedAt, organization.name, organization.type, organization.address, organization.contact, organization.description, organization.isActive, organization.createdAt, organization.updatedAt, selection.id, selection.name, selection.description, selection.isActive, selection.createdAt, selection.updatedAt')
๋ฌธ์ 6: 409 Conflict ์ค๋ฅ (์ด๋ฏธ ์ฒ๋ฆฌ๋ ์ ์ฒญ์)
๋ฌธ์ ์ํฉ
- ์ฌ์ฌํ๊ธฐ ๋ฒํผ ํด๋ฆญ ์ 409 Conflict ์ค๋ฅ ๋ฐ์
- "์ด๋ฏธ ์ฒ๋ฆฌ๋ ์ ์ฒญ์์ ๋๋ค" ๋ฉ์์ง
์์ธ ๋ถ์
- ํด๋น ์ ์ฒญ์์ ์ํ๊ฐ ์ด๋ฏธ
rejected๋ก ๋์ด ์์ - ApplicationsService์์ ์ด๋ฏธ ์ฒ๋ฆฌ๋ ์ ์ฒญ์์ ๋ํ ์ฌ์ฌ์ฌ ๋ฐฉ์ง ๋ก์ง
ํด๊ฒฐ ๋ฐฉ๋ฒ
-- ํ
์คํธ๋ฅผ ์ํด ์ ์ฒญ์ ์ํ ์ด๊ธฐํ
UPDATE applications SET status = 'submitted' WHERE id = '752574b6-2eca-40a9-a598-41023bc0027b';
โ ์ต์ข ํด๊ฒฐ๋ ๊ธฐ๋ฅ๋ค
โ ๋ฐฑ์๋ API ์๋ํฌ์ธํธ
/api/applications/:id/review- ์ ์ฒญ์ ์ฌ์ฌ/api/applications/:id/payment- ์ ๊ธ ์ํ ์ ๋ฐ์ดํธ
โ ๋ฐ์ดํฐ๋ฒ ์ด์ค ์คํค๋ง
applicationsํ ์ด๋ธ์isPaymentReceived,paymentReceivedAt์ปฌ๋ผ ์ถ๊ฐprogramsํ ์ด๋ธ์revenue์ปฌ๋ผ ์ถ๊ฐusersํ ์ด๋ธ์isBlocked,blockReason์ปฌ๋ผ ์ถ๊ฐ
โ ํ๋ก ํธ์๋ UI
- ์ฌ์ฌํ๊ธฐ Dialog ์ปดํฌ๋ํธ
- ์ ๊ธ ํ์ธ ์ฒดํฌ๋ฐ์ค
- ๋งค์ถ ํ์ ๊ธฐ๋ฅ
- ์ํ๋ณ ๋ฒํผ ํ์ ๋ก์ง
๐ ๊ฐ๋ฐ ๊ณผ์ ์์ ๋ฐฐ์ด ์
1. Docker ํ๊ฒฝ์์์ ๊ฐ๋ฐ ์ฃผ์์ฌํญ
- ๋น๋ ์บ์ ๋ฌธ์ ๋ก ์ธํ ์ฝ๋ ๋ฐ์ ์คํจ๊ฐ ์์ฃผ ๋ฐ์
docker system prune -a -f๋ก ์บ์ ์์ ์ญ์ ํ ์ฌ๋น๋ ํ์- TypeORM์
synchronize์ต์ ์ด Docker ํ๊ฒฝ์์ ์์๋๋ก ์๋ํ์ง ์์ ์ ์์
2. ๋ฐ์ดํฐ๋ฒ ์ด์ค ์คํค๋ง ๊ด๋ฆฌ
- ์๋ก์ด ์ปฌ๋ผ ์ถ๊ฐ ์ ์๋์ผ๋ก SQL ์คํ์ด ํ์ํ ์ ์์
- GROUP BY ์ ์์ ์ง๊ณ ํจ์๊ฐ ์๋ ํ๋ ํฌํจ ์ ์ค๋ฅ ๋ฐ์
- ์ปฌ๋ผ๋ช ์ ๋์๋ฌธ์ ๊ตฌ๋ถ์ ์ฃผ์ ํ์
3. React ์ปดํฌ๋ํธ ๊ฐ๋ฐ
- Dialog ์ปดํฌ๋ํธ ์ฌ์ฉ ์
asChildprop๊ณผ ํ์ ์ปดํฌ๋ํธ ๊ฐ์ ํธํ์ฑ ํ์ธ ํ์ type="button"์์ฑ ์ถ๊ฐ๋ก ๊ธฐ๋ณธ ๋์ ๋ฐฉ์ง
4. API ๊ฐ๋ฐ
- ์๋ก์ด ์๋ํฌ์ธํธ ์ถ๊ฐ ์ Docker ์ฌ๋น๋ ํ์
- 409 Conflict ์ค๋ฅ๋ ๋น์ฆ๋์ค ๋ก์ง์ ์ ์์ ์ธ ์๋ต์ผ ์ ์์
๐ฏ ๊ฒฐ๋ก
์ด๋ฒ ๊ฐ๋ฐ ๊ณผ์ ์์ Docker ํ๊ฒฝ์์์ ๊ฐ๋ฐ, ๋ฐ์ดํฐ๋ฒ ์ด์ค ์คํค๋ง ๊ด๋ฆฌ, React ์ปดํฌ๋ํธ ๊ฐ๋ฐ ๋ฑ ๋ค์ํ ๋ฌธ์ ๋ค์ ๊ฒฝํํ์ต๋๋ค. ๊ฐ ๋ฌธ์ ๋ฅผ ์ฒด๊ณ์ ์ผ๋ก ๋ถ์ํ๊ณ ํด๊ฒฐํ๋ ๊ณผ์ ์ ํตํด ๋์ฑ ๊ฒฌ๊ณ ํ ์์คํ ์ ๊ตฌ์ถํ ์ ์์์ต๋๋ค.
ํนํ Docker์ ๋น๋ ์บ์ ๋ฌธ์ ์ TypeORM์ ์คํค๋ง ๋๊ธฐํ ๋ฌธ์ ๋ ์ค์ ํ๋ก๋์ ํ๊ฒฝ์์๋ ๋ฐ์ํ ์ ์๋ ์ค์ํ ์ด์๋ค์ด๋ฏ๋ก, ํฅํ ๊ฐ๋ฐ ์ ์ด๋ฌํ ๋ฌธ์ ๋ค์ ๋ฏธ๋ฆฌ ๊ณ ๋ คํ์ฌ ๊ฐ๋ฐ ํ๋ก์ธ์ค๋ฅผ ๊ฐ์ ํ ํ์๊ฐ ์์ต๋๋ค.