코디움랩
제품 목록
Products플랫폼·SaaS2026년 7월 3일

FixHub

POS 단말기 장애를 접수·원격지원(VNC)·현장출동까지 한 곳에서 해결하는 B2B 유지보수 플랫폼

Spring Boot 3React 19Tauri 2GuacamolePostgreSQLRedis
#POS유지보수#B2B-SaaS#원격지원#필드서비스

매장 POS 단말기 장애를 접수부터 원격지원(VNC)·현장출동까지 한 곳에서 해결하는 B2B POS 통합 유지보수 플랫폼. 웹 백오피스 + 점주용 데스크톱 에이전트로 구성됩니다.

무엇을 하나요

  • 장애 티켓 관리 — POS 단말기 장애 접수·처리 워크플로우(티켓 번호 T-YYYYMMDD-NNN), 댓글·첨부·알림.
  • 원격지원(VNC) — Apache Guacamole(guacd + web) + noVNC/Websockify 기반 브라우저 원격 접속.
  • 현장출동(dispatch) 관리 — 기사 배정·출동 처리 도메인 및 백오피스 화면.
  • 점주용 데스크톱 에이전트 — Tauri 2.0 앱 "POSON Ai Agent" 로 POS 모니터링·AS 접수·진단(diag).
  • 백오피스 SPA — 대시보드, 모니터링, 단말기/디바이스, 조직/매장, 승인, 알림, 분석, AI 페이지.
  • 권한/인증 — JWT(Access/Refresh) + Kakao OAuth2, 역할 4종(SUPER_ADMIN · ADMIN · TECHNICIAN · STORE_MANAGER).

기술 스택

영역사용 기술
BackendJava 21 · Spring Boot 3.3 · JPA + QueryDSL 5 · Spring Security · WebSocket(STOMP) · JWT(jjwt) · springdoc
FrontendReact 19 · Vite · TypeScript · Tailwind v4 · shadcn/ui · Zustand 5 · TanStack Query 5 · React Router 7 · RHF + Zod
AgentTauri 2.0 · React 19 · Rust 셸 (macOS/Windows 번들)
DB / 캐시PostgreSQL 16 · Redis 7 (테스트 H2 + Testcontainers)
인프라/CIDocker Compose(nginx 프록시) · GitHub Actions(자동 SSH 배포·에이전트 릴리즈)

기술적으로 주목할 점

  • 도메인 주도 설계 — ticket · dispatch · remote · terminal · device · store · organization · agent · diag · notification 로 명확히 분리, 공통 ApiResponse<T> / BaseEntity(JPA Auditing) 표준화.
  • 상용 원격지원 통합 — Apache Guacamole 스택(별도 Guac DB 포함)을 nginx 로 프록시하는 멀티 서비스 Compose.
  • TDD 필수 규칙 — 백엔드 Red-Green-Refactor(@WebMvcTest/@DataJpaTest/@SpringBootTest), 프론트 Vitest + Testing Library + MSW.
  • 단일 코드베이스 · 두 배포 파이프라인 — 웹 백오피스와 데스크톱 에이전트가 의존성을 공유하되 별도 릴리즈(agent-v* 태그).