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. 구성 방법에서 .env, DB, 모델 파일 경로를 맞춥니다.
3. 모델 파일 준비에 따라 model/best.pt, model/vitality/best.onnx를 배치합니다.
4. 실행 방법에 따라 Model API, Backend API, Frontend를 각각 실행합니다.
5. 주요 기능을 보며 사육박스 등록, 분석, 증식률 확인 흐름을 테스트합니다.

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

문서 목차

시작과 구성

• 설치 방법
• 구성 방법
• 환경변수 설정
• 모델 파일 준비
• 실행 방법
• 운영 설정 메모

기능과 참고

• 주요 기능
• API 문서
• DB 구조

Repo 구성

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

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

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