Omnis — 채팅 기반 사내 지식 관리 에이전트
채팅으로 오가는 회사의 정보를 AI가 지식으로 정리해 두고, 누구든 물으면 답한다.
HADD Science의 사내 운영 프로토타입. 업무·기록·고객·지식재산권이 채팅 한 줄에서 쌓이고, 한 사람의 정보가 모두의 정보가 된다.
🚀 라이브 데모: https://omnis-omega.vercel.app
시연용 익명 계정 · 비밀번호 모두 demo1234
| 이름 | 권한 | 비고 |
|---|
팀장 | ADMIN | 업무 지시·캔버스 전체 보기 |
부팀장 | ADMIN | 동일 권한 |
사원1 | MEMBER | 본인 업무·체크리스트 작성 |
사원2 | MEMBER | 동일 |
사원3 | MEMBER | 동일 |
더미 데이터: 5 프로젝트 · 4 제품 라인 · 15 업무 카드 · 3 카테고리. 채팅 → 업무 자동 등록(Gemini AI), 워크스페이스 캔버스, 칸반, 주간보고 모두 작동합니다.
왜 만들었나
HADD Science는 오가노이드 3차원 세포배양 플랫폼을 개발하는 창업 초기 R&D 중소기업입니다.
구성원 한 명이 실험·규제 대응·과제 신청서·상표권 관리·문서화를 end-to-end로 수행하다 보니, 업무 등록과 보고에 들어가는 사무 오버헤드가 실험 시간을 잠식했습니다.
두 가지 주통증을 18일 만에 해소 — Before 2026.02.25–03.26 (사내 카톡 1,342건) · After 2026.04.13–04.30 (운영 18일 평균)
- 업무 1건당 문서화 시간: 35분 → 5분 (−85.7%)
- 의사결정권자 인지 지연: 평균 2일 → 5분 미만 (−99%)
그래서 "카톡 한 줄 = 업무 카드 1건" 가설을 세우고 프로토타입을 만들었습니다.
- 관리자 입력시간 ≈ 5초 (한 줄 전송)
- 담당자 입력시간 ≈ 0초 (자동 할당 + 알림)
- 사무 오버헤드 → AI에게 위임
한 눈에 보기
1. 워크스페이스 캔버스 — 프로젝트별 업무를 React Flow 노드로
여러 프로젝트의 업무를 한 화면에서 조망. 노드 드래그·줌·팬·미니맵 지원. 우측 상단 필터 칩으로 제품 라인별로 좁혀 보기.
2. HADD DB (Omnis 지식 허브) — 회사의 모든 정보를 한 번의 검색으로
회사 개요·인력 현황·지식재산권 등 반복 질문을 받던 정보를 카드로 적재. 매주 갱신, ⌘K로 즉시 검색. 카드 편집은 별도 git 저장소(data/omnis/)로 버전 관리되며 롤백 가능.
3. 내 업무 (Kanban) — 상태별 업무 보드
할 일 / 진행 중 / 보류 / 지연 4단 상태. 드래그로 상태 전환. D-day 표시와 마감 임박 컬러 코드.
4. ⌘K 명령 팔레트 — 어디서나 한 번에
업무·사람·HADD 카드·AI 명령어를 한 입력창으로. 새 업무 생성, 카드 만들기, 사람·업무 이동을 키보드만으로.
5. 채팅 도크 — Gemini가 한 줄을 업무로 변환
화면 하단에 항상 떠 있는 채팅 도크. 메시지 선택 → "업무 지시" → Gemini가 의도 분석 → 구조화된 업무 카드(제목·담당자·체크리스트·기대결과) 자동 생성. 등록 완료 시 시스템 메시지로 알림.
핵심 흐름
다이어그램 소스: docs/mermaid/core-flow.mmd
#업무명을 멘션하면 Gemini rebuildTask가 전체 대화 맥락에서 업무 카드를 재구성합니다 (체크리스트·배경·기대결과 갱신, 전부 완료 시 자동 DONE).
측정된 효과
측정 적용기간: 2026.04.13 ~ 04.30 (18일) · 사내 카톡 1,342건 텍스트 분석 + 본인 시간기록 기반 실측치
| KPI | Before | After | 개선율 |
|---|
| 업무 1건당 문서화 시간 | 35분 | 5분 | −85.7% |
| 의사결정권자 인지 지연 | 평균 2일 | 5분 미만 | −99% |
| 동일 정보 재질의 빈도 | 주 10회 | 주 1회 | −90% |
| 월간 업무 누락 건수 | 월 2.5건 | 0건 | −100% |
| 주간 업무보고 작성 시간 | 220분 | 30분 | −86.4% |
기술 스택
| 계층 | 사용 기술 |
|---|
| Framework | Next.js 16.1 (App Router · RSC · Turbopack) |
| Language | TypeScript 5.9, React 19 |
| Styling | Tailwind CSS 4.2, shadcn/ui v4 (base-vega) |
| Icons | hugeicons |
| Database | PostgreSQL 16 + Prisma ORM 6 |
| Auth | NextAuth v5 (Credentials) |
| AI | Google Gemini 2.5 Flash |
| Visualization | @xyflow/react (React Flow), recharts |
| E2E | Playwright |
사전 설치
다음 항목이 필요합니다.
| 도구 | 버전 | 비고 |
|---|
| Node.js | 20 LTS 이상 | node -v로 확인 |
| npm | Node.js와 함께 설치됨 | pnpm/yarn도 가능하나 README는 npm 기준 |
| Docker Desktop | 최신 | PostgreSQL 컨테이너용 (로컬 PostgreSQL 사용 시 생략 가능) |
| Gemini API Key | 무료 | Google AI Studio에서 발급 |
| OS | macOS / Linux / Windows (WSL2 권장) | — |
빠른 시작 (5분)
1. 클론
git clone https://github.com/HADDScience/omnis.git
cd omnis
2. 환경변수
cp .env.example .env
.env를 열어 다음 값을 채워 주세요.
DATABASE_URL="postgresql://omnis:omnis_dev_2026@localhost:5432/omnis"
NEXTAUTH_SECRET="$(openssl rand -base64 32 결과 붙여넣기)"
NEXTAUTH_URL="http://localhost:3000"
NEXT_PUBLIC_IS_DEMO=true
GEMINI_API_KEY="발급받은 키"
SEED_PASSWORD="원하는-개발용-비밀번호"
E2E_PASSWORD="demo1234"
참고: DATABASE_URL의 비밀번호는 docker-compose.yml의 POSTGRES_PASSWORD와 일치시켜야 합니다.
3. 의존성 설치 + DB 기동
pnpm install
pnpm run docker:up # PostgreSQL 컨테이너 기동
pnpm run db:migrate # Prisma 스키마 적용
pnpm run db:seed:demo # 공모전 데모용 익명 사용자 + 데모 데이터 시드
4. 개발 서버 시작
pnpm run dev
브라우저에서 http://localhost:3000 접속. 로그인 화면에서 시연용 익명 계정과 비밀번호 demo1234로 로그인합니다.
| 이름 | 권한 |
|---|
| 팀장 / 부팀장 | 관리자 (ADMIN) |
| 사원1 / 사원2 / 사원3 | 팀원 (MEMBER) |
자주 쓰는 명령어
| 명령어 | 설명 |
|---|
pnpm run dev | 개발 서버 (Turbopack) |
pnpm run build | 프로덕션 빌드 |
pnpm run start | 프로덕션 실행 |
pnpm run typecheck | TypeScript 타입 체크 |
pnpm run lint | ESLint |
pnpm run format | Prettier 포매팅 |
pnpm run db:studio | Prisma Studio (DB GUI) |
pnpm run db:seed | 시드 데이터 재적용 |
pnpm run db:seed:demo | 데모용 익명 시드 재적용 — 모든 테이블을 비운다. 로컬 DB 가 아니면 DEMO_SEED_ALLOW=1 이 있어야 돈다 |
pnpm run docker:up / down | PostgreSQL 컨테이너 기동·정지 |
디렉토리 구조
omnis/
├── app/
│ ├── (auth)/login/ ← 로그인
│ ├── (main)/
│ │ ├── dashboard/ ← 대시보드 (워크스페이스 캔버스)
│ │ ├── tasks/[taskId]/ ← 업무 목록·상세
│ │ ├── reports/[reportId]/ ← 주간보고
│ │ ├── omnis/[cardId]/ ← Omnis 지식 카드
│ │ └── settings/ ← 설정
│ └── api/ ← API Routes
├── components/
│ ├── chat/ ← 채팅 도크, 메시지, 업무 지시 다이얼로그
│ ├── landing/ ← 랜딩
│ ├── layout/ ← 사이드바, 헤더, 알림
│ ├── omnis/ ← Omnis 카드 에디터
│ └── ui/ ← shadcn 컴포넌트 55개
├── lib/
│ ├── ai.ts ← Gemini API (structureTask / rebuildTask / weeklyReport)
│ ├── auth.ts ← NextAuth 설정
│ ├── db.ts ← Prisma singleton
│ └── omnis-git.ts ← Omnis 카드 git 버전관리
├── prisma/
│ ├── schema.prisma ← 11개 모델
│ └── seed.ts ← 시드 스크립트
├── tests/ ← Playwright E2E
├── docs/screenshots/ ← README 이미지
└── docker-compose.yml ← PostgreSQL + Omnis
트러블슈팅
| 증상 | 해결 |
|---|
pnpm install 실패 (peer deps) | Node 20 LTS 사용 중인지 확인. pnpm install --legacy-peer-deps로 우회 가능 |
db:migrate 실패 | docker ps로 PostgreSQL 컨테이너가 healthy인지 확인. pnpm run docker:down && pnpm run docker:up 후 재시도 |
| 로그인 후 401 | .env의 NEXTAUTH_SECRET이 비었거나 너무 짧음. openssl rand -base64 32로 32바이트 이상 |
| 채팅 → 업무 자동 생성 안 됨 | GEMINI_API_KEY가 비었거나 만료. Google AI Studio에서 재발급 |
Module not found: '@dnd-kit/core' | pnpm install 미실행. 의존성 설치 후 재시작 |
라이선스
MIT — 자유롭게 포크·수정·재배포 가능. 출처 표기만 부탁드립니다.
문의
- HADD Science · 정우창 ·
[email protected]
- 본 프로젝트는 2026년 지역산업맞춤형인력양성사업 업무 적용 우수사례 공모전(주관: 경기도경제과학진흥원, GBSA) 🏆 최우수상 수상작의 사내 적용 산출물입니다. (2026-05-12 발표)
- 출품작명: 「OMNIS」 — AI 노코드 활용 학습으로 만든 채팅 기반 업무관리 시스템: 문서화 병목과 의사결정 가시성 부재를 동시에 해소한 30일의 기록
