# Xchange · XRD 实验数据库

一个本机运行的 XRD 实验归档与浏览器。双击 `start.command`，再在浏览器打开终端显示的本机地址（通常为 http://127.0.0.1:8765 ）。

## 目录约定

每条实验数据一个文件夹，便于复制、汇总和版本管理。文件夹直接使用实验名称；建议以 `靶材-Xray-样品` 开头，让扫描辐射源一眼可见：

```text
data/
  Cu-Xray-Mn2O3/
    INFO.txt            # 检索字段、相、人工复核状态（直接编辑）
    PATTERN.txt         # 2θ, intensity 曲线（直接编辑）
    Mn2O3.cif           # 单相：一个 CIF
  Cu-Xray-Pb3(SO6)2/
    INFO.txt
    PATTERN.txt         # 多相：一条实测 XRD
    phase-1.cif
    phase-2.cif         # 多相：多个 CIF
```

## 网页上传（推荐）

启动本机服务后，点击右上角“上传实验”。页面要求一份实测衍射文件，支持 `.xy`、`.xye`、`.csv`、`.dat`、`.txt`；文件以首两列数值作为 `2θ, intensity` 读取，预览曲线和范围后才能提交。单相模式仅接受一个 `.cif`；多相模式要求至少两个 CIF，并为每个 CIF 分别填写相名和相化学式。

表单收集 `INFO.txt` 中由上传者填写的样品、化学式、相名、靶材、日期、贡献者、仪器、标签、许可与审核状态，并自动写入扫描范围、数据点数、`PHASE` 行和默认人工复核备注。提交后的文件按测试日期保存为 `data/YYYY-MM-DD/<靶材>-Xray-<样品>/`；同一天的同名记录会自动加序号，避免覆盖。

## 手动新增数据

1. 单相复制 `data/_template-single`，多相复制 `data/_template-multi`，再重命名，例如 `Cu-Xray-Mn2O3`。`Cu-Xray` 代表 Cu 靶（Cu Kα）；请按实际靶材命名，如 `Mo-Xray-...`。
2. 导出原始仪器文件到 `raw/`（保留原始文件，不要覆盖）。将用于展示的数据整理为 `PATTERN.txt`。
3. 直接填写 `INFO.txt`。单相写一个 `PHASE` 行；多相则写多个 `PHASE` 行，每个相对应一个 CIF。
4. 放入 CIF，检查本地页面中的峰位和晶胞；在人工判定后将 `REVIEW_STATUS` 设为 `checked` 或 `needs_review`。
5. 提交时保留操作人、仪器、版本和来源。不要上传受限/可识别个人信息的样品记录。
6. `NOTE.txt` 可自由记录样品制备、环境、校准、数据处理、异常峰、判相理由和后续工作；它不受固定字段限制。

## 推荐的专业字段

除基础数据外，建议持续记录：样品制备与批次、辐射源/波长、几何与狭缝、扫描范围/步长/时间、环境（温度/气氛）、标准样校准、原始文件校验和、CIF 来源与 DOI、精修软件/版本、Rwp/χ²、许可与贡献者 ORCID。这样数据既可检索，也可复现。

## 本地浏览限制

本机服务会自动扫描 `data` 下的实验文件夹并读取 `INFO.txt`、CSV/TXT 曲线和 CIF。无需 JSON、无需维护索引，也不会上传任何数据；只监听本机 `127.0.0.1`。若默认端口被占用，会自动使用 8766–8775 中的可用端口。