# kucun

**Repository Path**: chengasd/kucun

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-04
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 项目结构

- `backend`：Express + Excel 远程导入、定时任务、分页接口与统计接口。
- `frontend`：Vite + React，包含表格页和统计页两个独立入口。

## 快速启动

1. 启动后端服务
   ```bash
   cd backend
   npm install
   cp .env.example .env   # 如需自定义 MongoDB/端口/定时导入 URL
   # 默认会连接 mongodb://127.0.0.1:27017/kucun，如有需要请在 .env 中调整 MONGODB_URI
   # 可选：设置每日定时导入地址，默认不开启
   # export IMPORT_URL="https://example.com/data.xlsx"
   npm run dev   # 或 npm start
   # 服务地址：http://localhost:4000
   ```
2. 启动前端
   ```bash
   cd frontend
   npm install
   # 如需自定义后端地址，复制 .env.example 到 .env 并修改 VITE_API_URL
   npm run dev   # 预览
   npm run build # 构建
   ```

## 接口说明（后端）
- `POST /api/import`：`{ url }` 远程 Excel 导入，数据会替换。
- `GET /api/data`：`?page=1&pageSize=10&name=` 分页+名称筛选。
- `GET /api/column-stats`：`?column=列名&name=` 列统计，点击表头用。
- `GET /api/overview`：统计页使用的全局概况。

### Excel 模板约束
- 模板首行必须包含列：`型号`、`品牌`、`年份`、`数量`、`包装`、`SPQ`、`供应商编号`（可多出其他列，但不能缺少这些列）。
- 仓库根目录下 `backend/template*.xlsx` 提供了示例模板，可自行上传到OSS或服务器后在导入接口中填写完整 URL。
- 导入的数据会写入 MongoDB 中的 `records` 与 `importmetas` 集合；再次导入会覆盖旧数据，而不是追加。

## 前端入口
- 表格页：`/table`（名称筛选、点击列做统计）
- 统计页：`/stats`（全局数值列统计与名称 TOP5）
- 批量导入：`/import`（一次填写多个 Excel 远程地址，顺序触发导入）