# Labora

**Repository Path**: amning/labora

## Basic Information

- **Project Name**: Labora
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-24
- **Last Updated**: 2026-06-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LIMS 一期方案与工程骨架

本仓库用于沉淀 LIMS 一期建设方案，并在方案基础上逐步落地前后端工程骨架。当前仓库同时包含：

- `docs` 下的中文方案文档
- `apps/web` 与 `apps/api` 下的一期系统原型代码

## 一期建设目标

一期建设聚焦检测业务最小可上线闭环：

- 客户委托及查询
- 受理打印委托检验合同书和标签
- 试验状态流转
- 报告编制、审批、签发
- 客户线上签字确认
- PDF 电子报告生成与下载
- 报告真伪验证
- 业务台账导出
- 钉钉提醒、短信提醒
- 客户门户和内部报告审批的响应式 H5 移动端适配

一期不建设复杂样品全生命周期、结构化检测结果、仪器自动采集、完整财务、App、小程序或全后台移动端适配。

## 文档目录

- [01-overview.md](docs/01-overview.md)：系统定位、一期范围、角色与业务闭环
- [02-business-requirements.md](docs/02-business-requirements.md)：客户委托、试验、审批、签字、导出、通知、移动端
- [03-report-management.md](docs/03-report-management.md)：报告编制、模板、编号、PDF、机构与模板、审批、客户签字
- [04-verification-and-download.md](docs/04-verification-and-download.md)：报告下载、客户签字、临时链接、真伪验证、日志
- [05-technical-architecture.md](docs/05-technical-architecture.md)：技术架构、部署、PDF 独立服务、存储、通知适配
- [06-data-model-draft.md](docs/06-data-model-draft.md)：核心对象与数据模型草案
- [07-acceptance-checklist.md](docs/07-acceptance-checklist.md)：一期验收清单
- [08-remote-field-witness-testing-process.md](docs/08-remote-field-witness-testing-process.md)：远程委托/现场检测/见证检测实验实施流程

## 工程目录

- `apps/web`
  - Vue 3 + Vite 前端工作台原型
  - 当前以响应式 H5 方式呈现一期核心业务界面
- `apps/api`
  - NestJS API 骨架
  - 当前提供委托、报告、客户签字、报告验真、通知配置等内存态接口

## 当前已落的业务切片

### 前端

- 委托录入与委托池筛选
- 现场检测 / 见证检测任务卡片
- 报告中心概览
- 客户线上签字跟踪
- 企业微信 / 电话验真渠道展示
- 钉钉 / 短信通知节点展示
- 移动端小屏响应式适配基础样式

### 后端接口

- `GET /api/orders`
- `GET /api/orders/:no`
- `POST /api/orders`
- `PATCH /api/orders/:no/advance`

- `GET /api/reports`
- `PATCH /api/reports/:no/approval`
- `PATCH /api/reports/:no/pdf`
- `POST /api/reports/:no/signature-request`

- `GET /api/signatures`
- `POST /api/signatures/request`
- `PATCH /api/signatures/complete`

- `GET /api/verifications`
- `POST /api/verifications/lookup`

- `GET /api/notifications`

## 技术选型摘要

- 前端：Vue 3 + TypeScript + Element Plus，响应式 H5
- 后端：NestJS 模块化单体
- 数据库：SQLite 默认，可配置 PostgreSQL 或 MySQL
- 文件存储：本地磁盘或 MinIO
- PDF 生成：独立 Windows 桌面进程，WPS COM 转 PDF
- 通知：钉钉机器人 Webhook，短信平台适配器
- 部署：内网私有化优先

## 一期业务要点已体现在代码中的部分

- 报告支持两种编制模式的展示骨架：
  - `FIXED_TEMPLATE_WITH_APPENDIX`
  - `FULL_WORD_UPLOAD`
- 报告可绑定不同机构与模板
- 客户签字以客户门户 H5 为一期入口
- 报告验真一期先体现：
  - 企业微信渠道
  - 电话渠道
- 委托详情中预留：
  - 打印委托检验合同书
  - 打印标签

## 运行

```bash
npm install
npm run dev:api
npm run dev:web
```

## 说明

当前仓库以结构落地和首屏业务切片为主，数据仍使用内存示例数据，尚未接入真实数据库、文件服务、PDF 独立服务和鉴权体系。

本次已将远程已有方案文档与本地新增工程骨架合并保留。

## 下一步建议

1. 把前端从本地状态切到真实 API 调用。
2. 增加 SQLite 持久化和基础表结构迁移。
3. 拆出客户门户页面与内部审批页面。
4. 接入 PDF 独立服务任务表和文件归档流。
5. 增加编号规则配置、模板配置、机构配置页面。