Home

Checkmite Wiki

Checkmite는 천적응애 사육 품질 관리를 위한 로컬 실행형 AI 이미지/영상 분석 웹 애플리케이션입니다.

연구자는 사육박스를 등록하고, 이미지 또는 영상을 업로드해 객체 탐지, 밀도 분석, 활력도 분석, 증식률 분석 결과를 저장하고 비교할 수 있습니다.

시스템 구성

Frontend       React + Vite + TypeScript       :80
Local dev      React + Vite + TypeScript       :5173
Backend        Express + Node.js               :3000
Model API      FastAPI + YOLO/OpenCV/ONNX      :8000
Database       PostgreSQL                      :5432

처음 보는 학생 추천 순서

1. 설치 방법에서 Node.js, Python, PostgreSQL, 모델 파일을 준비합니다.
2. 모델 파일 준비에 따라 model/best.pt, model/vitality/best.onnx를 배치합니다.
3. 환경변수 설정에서 .env를 만들고 DB와 모델 경로를 확인합니다.
4. 실행 방법에 따라 Model API, Backend API, Frontend를 각각 실행합니다.
5. 브라우저에서 사육박스를 하나 등록하고, 샘플 이미지/영상으로 분석 결과가 저장되는지 확인합니다.

성공 기준은 GET /api/health, GET /health, GET /api/culture-boxes가 모두 정상 응답하고, 화면의 사육박스 관리 탭에서 등록/수정이 되는 것입니다.

문서 목차

사용자/운영 문서

• 설치 방법
• 실행 방법
• 환경변수 설정
• 모델 파일 준비
• 주요 기능
• API 문서
• DB 구조
• 업로드하면 안 되는 파일
• 운영 설정 메모

상세 분석 문서

• 시스템 아키텍처
• 프론트엔드 분석
• 백엔드 분석
• AI 모델서버 분석
• 데이터베이스 설계
• 탭별 기능 상세
• 실행 및 배포 가이드
• 백엔드 API 상세
• 백엔드 모델서버 아키텍처
• 모델 카드

Repo 구성

• src/: 프론트엔드
• backend/: Express 백엔드
• api/: Python 모델 API
• backend/db/schema.sql: PostgreSQL schema

Repo에는 실행에 필요한 소스와 최소 설정만 포함합니다. 상세 분석 문서, API/DB 설명, 모델 설명은 Wiki에서 관리합니다.

실제 모델 가중치, 업로드 파일, 원본 연구 문서, .env 파일, 학습 노트북은 repo에 포함하지 않습니다.