freezer-sample-locator

name	freezer-sample-locator
description	Track and retrieve sample locations in -80°C freezers with hierarchical storage organization. Trigger conditions: - User needs to record sample storage positions (freezer ID, level, rack, box, grid position) - User requests to search samples by name, project, date, or location - User requires sample inventory management and export functionality Input: Sample metadata (name, project, quantity) and storage coordinates Output: Structured sample location records with search and export capabilities Success criteria: - Accurate position recording without conflicts - Fast search and retrieval (<1 second for 1000+ samples) - Data integrity maintained across operations - Export in multiple formats (JSON, CSV) Risk level: MEDIUM (Script execution with file system access) Technical difficulty: INTERMEDIATE Version: v1.0 Owner: 研发部 Last updated: 2026-02-06
version	1.0.0
category	Operations
tags	[]
author	AIPOCH
license	MIT
status	Draft
risk_level	Medium
skill_type	Tool/Script
owner	AIPOCH
reviewer
last_updated	2026-02-06

Freezer Sample Locator

Purpose: Systematically manage and retrieve sample locations in -80°C freezers using hierarchical storage organization.

Classification: Tool/Script型 (本地脚本执行)

🎯 Core Functions

Primary Operations

• Record: Store sample locations with hierarchical coordinates (freezer → level → rack → box → position)
• Retrieve: Search samples by name, project, freezer, date, or unique ID
• Manage: Update sample metadata, delete records, maintain inventory
• Export: Generate reports in CSV/JSON formats with filtering options

Data Integrity Features

• Conflict Detection: Prevent duplicate position assignments
• Validation: Enforce proper location encoding rules
• Audit Trail: Track creation and modification timestamps
• Backup: JSON-based storage with automatic file creation

Data Structure

Sample location information is stored in JSON files:

{
  "samples": [
    {
      "id": "uuid",
      "name": "Sample Name",
      "project": "Project Name",
      "freezer": "F01",
      "level": 1,
      "rack": "A",
      "box":