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

WIKI 구성

1. 설치 방법에서 Node.js, Python, PostgreSQL을 준비합니다.
2. 구성 방법과 환경변수 설정에서 .env, DB, 모델 파일 경로를 맞춥니다.
3. 모델 파일 준비에 따라 model/best.pt, model/vitality/best.onnx를 배치합니다.
4. 실행 방법에 따라 Model API, Backend API, Frontend를 각각 실행합니다.
5. 주요 기능을 보며 사육박스 등록, 분석, 증식률 확인 흐름을 테스트합니다.
6. 현장 PC나 서버에 계속 운용할 때는 운영 설정 메모를 확인합니다.

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

소스 구성

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

저장소에는 실행에 필요한 소스와 최소 설정만 포함합니다. 설치, 구성, 실행, 기능, API/DB 설명은 Wiki에서 관리합니다.

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