CoreFlow (코어플로우)

모든 업무의 중심을 잇다

출퇴근 기록부터 전자결재, 프로젝트 관리, 조직도까지 — 파편화된 기업의 핵심 업무(Core)를 끊김 없는 하나의 흐름(Flow)으로 연결하는 B2B 그룹웨어.

이 저장소는 CoreFlow의 초대 링크 기반 회원가입 + 그룹웨어 워크스페이스(대시보드 · 근태 · 전자결재 · 프로젝트 · 공지 · 조직도 · 설정) 구현입니다. 모든 화면이 Firebase(Auth · Firestore)에 연동됩니다.

워크스페이스 시작하기 (데모)

# 1. 데모 로그인 계정 생성
node --env-file=.env.local scripts/create-demo-user.mjs
#    → [email protected] / coreflow1234

# 2. 개발 서버
npm run dev

# 3. .env.local 에 FIREBASE_SERVICE_ACCOUNT 와
#    [email protected] 설정 후 /login 로그인
#    (부트스트랩은 인증된 이메일만 받습니다 — 1번을 FIREBASE_SERVICE_ACCOUNT
#     가 있는 상태로 실행하면 데모 계정의 이메일 인증이 자동 완료됩니다)
#    → "첫 관리자로 시작하기" 로 SUPER_ADMIN 부트스트랩
#    (관리자가 하나라도 있으면 이 버튼은 나타나지 않음)

# 4. /admin/seed 에서 "시드 실행"
#    (임직원·공지·Task·전자결재 72개 문서를 Firestore 에 채움)

Firestore 가 비어 있으면 각 화면은 목(mock) 데이터로 폴백하고, 시드 후에는 실시간(onSnapshot) Firestore 데이터로 전환됩니다.

그룹웨어 컬렉션

컬렉션	내용
orgPeople/{id}	임직원 디렉토리
notices/{id}	공지사항 (필독 고정 포함)
tasks/{id}	프로젝트 Task (칸반 카드)
approvals/{no}	전자결재 문서 + 결재란/상세
delegations/{uid}	결재 위임 (본인만 설정 · 기간 중엔 받은 사람이 차례인 문서를 열람·대리 결재, 결재란에 proxyUid/proxyName 기록)
attendance/{uid}	사용자별 출퇴근 상태 (본인만 읽기/쓰기)
users/{uid}	프로필 + gwSettings(알림 토글·연동) + twoFactorId(2FA 켜짐, 서버만 변경). 퇴사 처리는 서버 /api/admin/offboard 가 status: RESIGNED + Auth 계정 비활성화 + 결재·Task·직속 구성원 인계
users/{uid}/inbox/{key}	알림 센터 받은편지함 (서버 /api/notifications 만 생성 · 본인은 읽기·읽음 표시·삭제)
userSecrets/{uid}	2FA 비밀키·백업 코드 해시 (서버 /api/auth/two-factor 전용, 클라이언트 접근 불가)
auditLogs/{id}	관리자 작업 감사 로그 (관리자만 읽기 · 추가만 가능 · 관리자 전용 쓰기는 같은 배치에 로그가 있어야 규칙 통과)

스택

영역	사용 기술
프레임워크	Next.js 16 (App Router) · React 19 · TypeScript
스타일	Tailwind CSS v4 · shadcn/ui 패턴 컴포넌트 · Pretendard
아이콘	lucide-react
백엔드	Firebase v10+ Modular SDK (Auth · Cloud Firestore · Storage)

시작하기

cp .env.local.example .env.local   # Firebase 웹 앱 설정값 입력
npm install
npm run dev                        # http://localhost:3000

Firebase 준비

1. Firebase 콘솔에서 프로젝트 생성
2. Authentication → 로그인 방법 → 이메일/비밀번호 사용 설정
3. Cloud Firestore 생성 (프로덕션 모드)
4. Storage 생성
5. 웹 앱 등록 후 설정값을 .env.local 에 입력
6. 보안 규칙 배포

firebase deploy --only firestore:rules,storage

가입 프로세스

관리자가 초대 발급  →  /signup?token=xxx  →  3-Step 위저드  →  users/{uid} 생성
       │                      │                    │                   │
   invites 문서 생성   invites 컬렉션에서 토큰 조회   Step1 계정 / Step2 프로필·서명 / Step3 업무태그
                       이메일·사번·부서·직급 Read-only        │
                                                    invites.status = 'COMPLETED'

• 초대에 requireApproval: true 이면 가입 후 status: 'PENDING' (관리자 승인 대기)
• requireApproval: false 이면 즉시 status: 'ACTIVE'

데모용 초대 생성

/admin/invite 에서 초대 정보를 입력하면 invites 문서와 가입 링크가 생성됩니다. (⚠️ 데모용 — 운영에서는 관리자 인증/서버 로직으로 보호하세요.)

주요 파일

경로	설명
src/lib/firebase.ts	Firebase Modular SDK 초기화
src/types/user.ts	UserDoc · InviteDoc · 폼 타입
src/hooks/useInvite.ts	?token → invites 조회 · 만료/사용 검증
src/hooks/useSignUp.ts	Auth 생성 → Storage 업로드 → Firestore 저장(batch)
src/hooks/useAuthUser.ts	로그인 사용자 + users/{uid} 프로필
src/components/signup/*	3단계 Stepper 위저드 UI
src/app/signup/page.tsx	회원가입 화면
src/app/login/page.tsx	로그인 화면
src/app/dashboard/page.tsx	가입 후 프로필 대시보드

데이터 모델 (Firestore)

users/{uid} — 문서 ID = Firebase Auth uid

{
  email, name,                    // 계정
  departmentId, position,         // 조직
  employeeId, joinedAt, phone,    // 근태·보안
  profileImageUrl?, extensionNumber?, tasks?, signatureUrl?,  // 선택
  role: 'SUPER_ADMIN' | 'ADMIN' | 'MEMBER',
  status: 'INVITED' | 'PENDING' | 'ACTIVE' | 'SUSPENDED',
  inviteId, createdAt, updatedAt
}

invites/{inviteId}

{
  token, email, employeeId, departmentId, departmentName, position,
  role, status: 'INVITED' | 'PENDING' | 'COMPLETED' | 'EXPIRED',
  requireApproval, invitedBy, invitedByName,
  createdAt, expiresAt, completedUid, completedAt
}

Storage 구조

users/{uid}/profile.<ext>      프로필 이미지
users/{uid}/signature.<ext>    전자결재용 서명/직인