# 111

**Repository Path**: hngcadmin/111

## Basic Information

- **Project Name**: 111
- **Description**: 1
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 定价优化工具

这是一个基于 `Python + Flask + HTML` 的单体网页程序，用于读取 Excel 模板、计算 4 套定价模型，并导出结果文件。

## 架构说明

- 不使用数据库，不依赖 MySQL。
- 上传 Excel 后在服务端内存中完成校验与求解。
- 结果文件输出到本地 `runtime/results/<job_id>/` 目录。
- 预留了 JSON API 和集成适配层，便于后续接入智能系统或其他业务系统。

## 功能范围

- 上传输入模板并按固定列位读取数据
- 页面录入 `δ / η / Rmax / 异常值筛选参数`
- 计算 4 套模型：
  - 模型1：直线
  - 模型2：两段折线
  - 模型3：三段折线
  - 模型4：二次曲线
- 导出：
  - `pricing_summary.xlsx`
  - `pricing_detail.xlsx`
  - `pricing_results.zip`
- API：
  - `POST /api/v1/calculate`
  - `GET /api/v1/jobs/<job_id>`
  - `GET /api/v1/integration/capabilities`

## 环境要求

- Python 3.13+

## 启动方式

1. 创建并激活虚拟环境

```bash
python3 -m venv .venv
. .venv/bin/activate
```

2. 安装依赖

```bash
pip install -r requirements.txt
```

3. 启动服务

```bash
python app.py
```

4. 浏览器打开

```text
http://127.0.0.1:5000
```

## 自测方式

运行：

```bash
. .venv/bin/activate
python tests/self_test.py
```

测试会：

- 生成一份模拟输入 Excel
- 通过 Flask Test Client 走完整上传与计算流程
- 校验导出的汇总表和明细表是否生成
- 校验价格是否满足上下界和收入约束

## 单位口径

- `x_i`：公里
- `Q_i`：万吨
- `Y_i^min / C_i / P_i`：元/吨
- `Rmax / R* / Z*`：万元

## 异常值筛选口径

- 仅对 `Y_i^min` 做筛选
- 按全表使用 IQR 箱线法
- 阈值为 `[Q1 - k*IQR, Q3 + k*IQR]`
- 被剔除数据不参与模型求解，但保留在输出明细中，价格列留空并加批注

## 目录结构

```text
app.py
pricing/
templates/
static/
tests/
runtime/
```