# PROJECT_CONTEXT

## 目标

为良渚产品建立一个可复用的电商定价小网页。用户输入产品名称、核算类型、含税成本、运费和各项费率后，工具即时计算最低实际成交价、建议一口价、折扣成交利润是否达标，并把核算记录保存到本地文件。

## 当前实现

- `pricing.py`：两种定价口径、输入校验、核心公式、建议价格档、目标利润敏感性测算。
- `app.py`：Python 标准库 HTTP 服务，无第三方依赖；提供计算、保存记录、导出 CSV、核算类型配置接口。
- `static/index.html`：单页网页界面，支持核算类型下拉切换、推广/团队/目标利润等参数实时调整，并显示目标利润敏感性表。
- `tests/test_pricing.py`：核心公式测试，覆盖自研产品、厂家采购成本产品、目标利润敏感性和推广/团队费率变化。
- `data/pricing_records.sqlite3`：运行后生成或沿用的本地 SQLite 核算记录库。

## 已接入口径

### 良渚自研产品

- 平台成本率：6.1%
- 推广成本率：10%
- 团队运营成本率：28%
- 运费：8 元
- 增值税率：13%
- 目标净利率：0%
- 折扣率：85%

验证示例：含税成本 360 元时，最低成交价约 735.62 元，向上取整 736 元；建议一口价约 865.44 元，向上取整 866 元。

### 厂家采购成本产品

- 良渚 IP 提成：3%
- 平台成本率：6.5%
- 推广成本率：10%
- 团队运营成本率：10%
- 运费：5.5 元
- 增值税率：13%
- 目标净利率：10%
- 折扣率：85%

验证示例：厂家采购含税成本 360 元时，最低成交价约 661.46 元，向上取整 662 元；建议一口价约 778.18 元，向上取整 779 元。

## 可调参数与敏感性测算

- 目标净利率可在页面中调整；默认敏感性情景：0%、5%、10%、15%、20%。
- 推广成本率和团队运营成本率可在页面中调整；修改后当前结果和敏感性表实时重算。
- 保存记录时保留当时的推广率、团队率、目标利润率和完整计算结果快照。
- 如 `1 - 各项成交价费率 - 目标净利率 - 13/113 ≤ 0`，说明费率/利润目标过高，无法倒推可行价格。

## 通用公式

```text
净增值税 = (实际成交价 - 含税成本价) × 13 / 113
最低成交价 = (运费 + 含税成本价 × 100/113) / (1 - 各项成交价费率 - 目标净利率 - 13/113)
建议一口价 = 最低成交价 / 折扣率
```

最低成交价和建议一口价展示时均向上取整到整数元。

## 边界

- 本项目仅本地运行；`127.0.0.1` 只能在运行服务的机器本机打开，不是用户手机/外部电脑可访问链接。
- 未做公网部署。
- 未修改现有线上服务。
- 未写入 NAS 共享知识库、用户资料区或项目归档区。
- 不保存账号、密码、Token、服务器密钥等敏感信息。
- 不删除已有核算记录；数据库只做向前兼容字段扩展。

## 后续可扩展

- 增加记录筛选、编辑、删除前确认、Excel 导出。
- 增加产品分类、渠道、成本版本管理。
- 接入已有电商定价系统。
- 经用户确认后再考虑内网或公网部署。