refactor: 重构库存模块 - 字段重命名、拼音排序、DataTable组件

- location -> storage_location 字段标准化
- 添加 pypinyin 库支持中文拼音排序
- 新增 DataTable 组件（虚拟滚动表格）
- 优化侧边栏折叠动画
- 修复代码重复问题（lint）

Author: hzb666

.claude/GIT_STRATEGY.md

@@ -0,0 +1,103 @@
+# Git 分支管理规范
+
+不要更改此文档！
+本项目采用 Git Flow 工作流，包含以下分支类型：
+## 注意事项
+
+1. **禁止在 main 分支直接开发**
+2. **保持分支原子性**，一个分支只做一件事
+3. **定期同步 develop**，避免冲突
+4. **使用有意义的提交信息**
+
+## 分支类型
+
+| 分支 | 用途 | 生命周期 | 合并目标 |
+|-----|------|---------|---------|
+| `main` | 生产环境，包含稳定发布版本 | 长期 | - |
+| `develop` | 开发主分支，包含最新开发成果 | 长期 | `main` |
+| `feature/*` | 新功能开发 | 临时 | `develop` |
+| `release/*` | 发布前准备（bug修复、文档更新） | 临时 | `main` + `develop` |
+| `hotfix/*` | 生产环境紧急修复 | 临时 | `main` + `develop` |
+
+## 提交规范
+
+| 类型 | 说明 |
+|-----|------|
+| `feat` | 新功能 |
+| `fix` | Bug修复 |
+| `docs` | 文档更新 |
+| `refactor` | 代码重构 |
+| `perf` | 性能优化 |
+| `chore` | 构建/工具变动 |
+
+格式：`类型: 简短描述`
+
+
+## 命名规范
+
+```
+<类型>/<描述>
+# 示例
+feature/user-login
+release/v1.0.0
+hotfix/security-fix
+```
+
+## 工作流程
+
+### 功能开发 (Feature)
+```bash
+# 1. 创建功能分支
+git checkout develop
+git pull origin develop
+git checkout -b feature/xxx
+
+# 2. 开发并提交
+git commit -m "feat: 新功能描述"
+
+# 3. 合并到 develop
+git checkout develop
+git merge --no-ff feature/xxx
+git push origin develop
+```
+
+### 发布准备 (Release)
+```bash
+# 1. 创建 release 分支
+git checkout develop
+git checkout -b release/v1.0.0
+
+# 2. 发布前准备
+git commit -m "chore: 发布准备"
+
+# 3. 合并到 main 和 develop
+git checkout main
+git merge --no-ff release/v1.0.0
+git tag -a v1.0.0 -m "Release v1.0.0"
+git push origin main
+
+git checkout develop
+git merge --no-ff release/v1.0.0
+git push origin develop
+```
+
+### 紧急修复 (Hotfix)
+```bash
+# 1. 创建 hotfix 分支
+git checkout main
+git checkout -b hotfix/xxx
+
+# 2. 修复并提交
+git commit -m "hotfix: 紧急修复"
+
+# 3. 同时合并到 main 和 develop
+git checkout main
+git merge --no-ff hotfix/xxx
+git push origin main
+
+git checkout develop
+git merge --no-ff hotfix/xxx
+git push origin develop
+```
+
+

.claude/Rules.md

@@ -0,0 +1,27 @@
+# Rules.md
+不要更改此文档！
+
+## System Personality
+你是一个专业的 LIMS 系统架构师。你注重数据的准确性（CAS号）、系统的响应速度（WAL模式）和操作的便捷性（Dashboard优先）。你的思考和回答都要用中文。
+
+## Critical Rules (Must Follow)
+1.  **Concurrency**: 初始化 SQLite 时必须启用 **WAL Mode**。
+2.  **CAS Normalization**: 所有涉及 CAS 号的输入，必须在后端进行标准化清洗（去除空格、大写）。这是系统的防重基石。
+3.  **Image Optimization**: 禁止将图片存入数据库 Blob。必须在后端使用 Pillow 压缩至 <100KB 并存入文件系统。
+4.  **No Mobile Dependency**: 系统设计不依赖扫码枪或手机摄像头。所有流程闭环在 PC/平板 Web 端完成。
+5.  **Git Commit**: 完成重大修改后，切换到Review模式在当前对话进行Code Review，给出报告与我进行讨论，讨论完成后更新`Readme.md`，更新`milestone.md`，之后执行git提交，注意分支和提交信息。
+6.  **Chinese**: 前端使用中文展示（除英文名称等），后端保存用英文方便管理（除中文名称等），因此需要添加映射表
+7.  **Debug**:我会将我自己发现的问题记录在 `BUGS.md`，在debug时请做好相关记录，你进行代码审查时发现的问题也要写入此文档
+8.  **Dark Mode**: 前端开发必须使用语义化颜色（bg-background, bg-card, bg-muted, text-foreground, text-muted-foreground 等），禁止使用硬编码颜色（bg-gray-*, bg-white, text-gray-* 等），确保暗黑模式支持。
+
+## Critical Logic
+1.  **一键入库**: 在实现 Order 到 Inventory 的转换时，必须确保是 Copy 数据而不是 Move，保留 Order 记录用于审计。
+2.  **图片处理**: 图片上传后重命名（UUID），存入 `/static`，数据库只存 URL。
+3.  **权限**: 凡是修改数据的接口，必须检查 `current_user`。
+
+## Tech Context
+* FastAPI, SQLModel, SQLite
+* React, Shadcn/UI, TanStack Table
+* Pillow, Pandas
+
+**重要**：每次开始编写代码前，先阅读 `Progress.md` 确认当前步骤和计划。在写任何代码之前，在 Architect 模式下无尽地审问我的想法。不要假设任何问题，问问题直到没有疑问剩下，并根据每次讨论更新对应的Prompt文件夹的相关md文档。每完成一个步骤，更新`Progress.md`，并在文档后添加更新时间线和Plans，更新`IMPLEMENTATION_PLAN.md`。每次犯错修复后，把教训写进 `Lessons.md`，之后遇到类似问题先学习教训。

.kilocode/mcp.json

@@ -1,14 +1 @@
-{
-  "mcpServers": {
-    "filesystem": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@modelcontextprotocol/server-filesystem",
-        "D:\\Code"
-      ],
-      "disabled": false,
-      "alwaysAllow": []
-    }
-  }
-}
+{"mcpServers":{"filesystem":{"command":"npx","args":["-y","@modelcontextprotocol/server-filesystem","D:\\Code"],"disabled":false,"alwaysAllow":["read_text_file","read_multiple_files","read_file"]}}}

app/api/inventory.py

@@ -7,6 +7,7 @@
 """
 import csv
 import io
+from pypinyin import lazy_pinyin
 import logging
 import os
 import tempfile
@@ -15,7 +16,7 @@
 from typing import Optional, Dict, Any
 from fastapi import APIRouter, Depends, HTTPException, status, UploadFile, File
 from fastapi.responses import StreamingResponse
-from sqlmodel import Session, select, func
+from sqlmodel import Session, select, func, case
 
 from app.database import get_db
 from app.models.inventory import (
@@ -35,6 +36,18 @@
 
 logger = logging.getLogger(__name__)
 
+
+def _to_pinyin_sort_key(text: str) -> str:
+    """
+    将文本转换为拼音排序键
+    用于中文按拼音排序，将中文转换为对应的拼音字母序列
+    """
+    if not text:
+        return ''
+    # 使用 lazpinyin 获取拼音首字母，风格为普通风格（不带声调）
+    pinyin_list = lazy_pinyin(text, style=0)  # Style 0 = NORMAL
+    return ''.join(pinyin_list)
+
 router = APIRouter(prefix="/inventory", tags=["Inventory"])
 
 # ==================== File Upload Security ====================
@@ -284,7 +297,7 @@ def check_cas_inventory(
             {
                 "id": item.id,
                 "name": item.name,
-                "location": item.location,
+                "storage_location": item.storage_location,
                 "remaining_quantity": item.remaining_quantity,
                 "unit": item.unit,
                 "status": item.status,
@@ -368,7 +381,7 @@ def export_inventory(
             item.alias or "",
             item.category or "",
             item.brand or "",
-            item.location or "",
+            item.storage_location or "",
             item.initial_quantity,
             item.remaining_quantity,
             item.unit,
@@ -425,7 +438,7 @@ def manual_add_inventory(
             alias=item_data.alias,
             category=item_data.category,
             brand=item_data.brand,
-            location=item_data.location,
+            storage_location=item_data.storage_location,
             initial_quantity=per_bottle_value,
             remaining_quantity=per_bottle_value,
             unit=unit,
@@ -492,9 +505,9 @@ def get_pending_stockin(
     current_user: User = Depends(get_current_user),
     db: Session = Depends(get_db),
 ):
-    """Get items pending location assignment (temporary keeper = current user)."""
+    """Get items pending storage_location assignment (temporary keeper = current user)."""
     statement = select(Inventory).where(
-        Inventory.location is None,
+        Inventory.storage_location is None,
         Inventory.temporary_keeper_id == current_user.id,
     ).order_by(Inventory.created_at.desc())
 
@@ -528,7 +541,7 @@ def get_import_template():
 @router.post("/import")
 def import_inventory(
     file: UploadFile = File(...),
-    default_location: Optional[str] = None,
+    default_storage_location: Optional[str] = None,
     default_is_hazardous: bool = False,
     admin_user: User = Depends(require_admin),
     db: Session = Depends(get_db),
@@ -547,7 +560,7 @@ def import_inventory(
         result = import_inventory_from_excel(
             db=db,
             file_path=tmp_file_path,
-            default_location=default_location,
+            default_storage_location=default_storage_location,
             default_is_hazardous=default_is_hazardous,
             user_id=admin_user.id,
         )
@@ -575,21 +588,23 @@ def import_inventory(
 @router.get("/")
 def list_inventory(
     skip: int = 0,
-    limit: int = 50,
+    limit: int = 0,  # 0 表示不分页，返回全部数据
     status_filter: Optional[InventoryStatus] = None,
     cas_filter: Optional[str] = None,
     hazardous_only: bool = False,
     search: Optional[str] = None,
     search_field: Optional[str] = None,  # 精确搜索指定字段
     fuzzy: bool = False,                  # 模糊搜索（忽略空格和连字符）
+    sort_by: Optional[str] = None,       # 排序字段
+    sort_order: Optional[str] = 'desc',   # 排序方向：asc 或 desc
     db: Session = Depends(get_db),
 ):
     """List inventory with optional filters and pagination"""
-    # 生成缓存key（包含所有搜索参数，包括分页）
-    cache_key = f"list:{skip}:{limit}:{search or ''}:{status_filter or ''}:{cas_filter or ''}:{hazardous_only}:{search_field or ''}:{fuzzy}"
+    # 生成缓存key（包含所有搜索参数，包括分页和排序）
+    cache_key = f"list:{skip}:{limit}:{search or ''}:{status_filter or ''}:{cas_filter or ''}:{hazardous_only}:{search_field or ''}:{fuzzy}:{sort_by or ''}:{sort_order or ''}"
 
-    # 尝试从缓存获取（仅当是第一页时）
-    if skip == 0:
+    # 尝试从缓存获取（仅当是不分页查询或第一页时）
+    if limit == 0 or skip == 0:
         cached = _get_cached_result(cache_key)
         if cached is not None:
             # 返回缓存结果，但更新分页参数
@@ -633,7 +648,7 @@ def norm_field(field):
             base = base.where(
                 (norm_field(Inventory.cas_number).ilike(f"%{search_normalized}%")) |
                 (norm_field(Inventory.name).ilike(f"%{search_normalized}%")) |
-                (norm_field(Inventory.location).ilike(f"%{search_normalized}%")) |
+                (norm_field(Inventory.storage_location).ilike(f"%{search_normalized}%")) |
                 (norm_field(Inventory.brand).ilike(f"%{search_normalized}%")) |
                 (norm_field(Inventory.category).ilike(f"%{search_normalized}%"))
             )
@@ -645,7 +660,7 @@ def norm_field(field):
                 field_map = {
                     'name': Inventory.name,
                     'cas_number': Inventory.cas_number,
-                    'location': Inventory.location,
+                    'storage_location': Inventory.storage_location,
                     'brand': Inventory.brand,
                     'category': Inventory.category,
                 }
@@ -656,7 +671,7 @@ def norm_field(field):
                     base = base.where(
                         (Inventory.name.ilike(search_pattern)) |
                         (Inventory.cas_number.ilike(search_pattern)) |
-                        (Inventory.location.ilike(search_pattern)) |
+                        (Inventory.storage_location.ilike(search_pattern)) |
                         (Inventory.brand.ilike(search_pattern)) |
                         (Inventory.category.ilike(search_pattern))
                     )
@@ -665,13 +680,77 @@ def norm_field(field):
                 base = base.where(
                     (Inventory.name.ilike(search_pattern)) |
                     (Inventory.cas_number.ilike(search_pattern)) |
-                    (Inventory.location.ilike(search_pattern)) |
+                    (Inventory.storage_location.ilike(search_pattern)) |
                     (Inventory.brand.ilike(search_pattern)) |
                     (Inventory.category.ilike(search_pattern))
                 )
 
     total = db.exec(select(func.count()).select_from(base.subquery())).one()
-    items = db.exec(base.order_by(Inventory.created_at.desc()).offset(skip).limit(limit)).all()
+    
+    # 构建排序表达式
+    # 支持的排序字段映射
+    # 使用 CASE 表达式处理 initial_quantity 为 0 的情况，避免除零错误
+    from sqlmodel import case as sql_case
+    
+    # 计算剩余百分比（处理除零情况）
+    remaining_percent_expr = sql_case(
+        (Inventory.initial_quantity > 0, Inventory.remaining_quantity * 1.0 / Inventory.initial_quantity),
+        else_=0
+    )
+    
+    sort_field_map = {
+        'cas_number': Inventory.cas_number,
+        'name': Inventory.name,
+        'category': Inventory.category,
+        'storage_location': Inventory.storage_location,
+        'brand': Inventory.brand,
+        'remaining_quantity': Inventory.remaining_quantity,
+        'remaining_percent': remaining_percent_expr,
+        'initial_quantity': Inventory.initial_quantity,
+        'status': Inventory.status,
+        'created_at': Inventory.created_at,
+        'updated_at': Inventory.updated_at,
+    }
+    
+    # 确定排序字段和方向
+    order_column = sort_field_map.get(sort_by, Inventory.created_at)
+    order_direction = sort_order.lower() if sort_order else 'desc'
+    
+    # 中文拼音排序字段列表
+    pinyin_sort_fields = {'name', 'category', 'brand', 'alias'}
+    
+    # 判断是否需要使用拼音排序
+    use_pinyin_sort = sort_by in pinyin_sort_fields
+    
+    logger.info(f"[SORT DEBUG] sort_by={sort_by}, sort_order={sort_order}, order_column={order_column}, order_direction={order_direction}, use_pinyin_sort={use_pinyin_sort}")
+    
+    if use_pinyin_sort:
+        # 中文拼音排序：先按拼音键排序
+        pinyin_key_field = f"{sort_by}_pinyin"
+        logger.info(f"[PINYIN SORT] Using pinyin sorting for field: {sort_by}")
+    
+    if order_direction == 'asc':
+        order_expr = order_column.asc()
+    else:
+        order_expr = order_column.desc()
+    
+    # 如果 limit 为 0，不使用分页，返回全部数据
+    # 如果需要拼音排序，先获取全部数据再在 Python 中排序
+    if limit == 0 or use_pinyin_sort:
+        items = db.exec(base.order_by(order_expr)).all()
+        if use_pinyin_sort:
+            # Python 端拼音排序
+            logger.info(f"[PINYIN SORT] Performing Python-side pinyin sorting for field: {sort_by}")
+            reverse = order_direction == 'desc'
+            # 使用 pypinyin 转换键进行排序
+            items = sorted(items, key=lambda x: _to_pinyin_sort_key(getattr(x, sort_by) or ''), reverse=reverse)
+            # 如果有 limit，应用分页
+            if limit > 0:
+                items = items[skip:skip + limit]
+    elif limit > 0:
+        items = db.exec(base.order_by(order_expr).offset(skip).limit(limit)).all()
+    else:
+        items = db.exec(base.order_by(order_expr)).all()
 
     result = {
         "data": [
@@ -683,8 +762,8 @@ def norm_field(field):
         "limit": limit,
     }
 
-    # 缓存第一页结果
-    if skip == 0:
+    # 缓存查询结果（不分页或第一页时缓存）
+    if limit == 0 or skip == 0:
         # 缓存时不包含分页参数
         cache_data = {
             "data": result["data"],

app/api/reagent_orders.py

@@ -509,7 +509,7 @@ def stock_in_reagent_order(
             alias=order.alias,
             category=order.category,
             brand=order.brand,
-            location=None,  # No location in new design
+            storage_location=None,  # No storage_location in new design
             initial_quantity=per_bottle_value,
             remaining_quantity=per_bottle_value,
             unit=unit,