# sunzing-quotation

**Repository Path**: mediad/sunzing-quotation

## Basic Information

- **Project Name**: sunzing-quotation
- **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-10-30
- **Last Updated**: 2026-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 尚臻报价 Agent（sunzing-quotation）

企微机器人（单聊）：助理起草 → 采购询价 → 高总定价 → 出 Word/PDF → 归档留痕。
**钱由确定性内核算，LLM 只做非结构化→结构化。**

- 项目上下文入口（硬约定/进度）：`AGENTS.md`（原 `CODEBUDDY.md`，261102 迁移至 OpenCode）
- 设计文档（唯一事实源）：`docs/plans/261030-尚臻报价agent-design.md`
- M1 实施计划：`docs/plans/261030-M1实施计划.md`
- 资产：`docs/assets/`
  - `金样-算价基线.json` —— 算价金标准（动内核必跑）
  - `角色字典.json` —— userid → 角色（权限门依据，待填真值）
  - `客户档案种子.json` —— 客户条款种子（待勇哥换真值）
- 版式：`templates/报价单模板.docx`（沿用老工程）

## 与兄弟工程的关系

| 工程 | 关系 |
|---|---|
| `../quotation/` | **老工程，已冻结（只读）**。只搬确定性算价内核，不再提交代码 |
| `../saleagent/` | **工程范式来源**。企微长连接、CloudBase 部署、双后端、TDD 纪律照抄其已验证形态 |

## 技术栈

FastAPI + CloudBase PostgreSQL + python-docx，部署于腾讯云 CloudBase 云托管（**与 saleagent 同环境**，服务名 `sunzing-quotation`，最小实例 1）；
企微走智能机器人长连接 WebSocket；LLM 仅用于指令/文本解析，不参与算价。

## 已锁定决策（261030）

| 项 | 选择 |
|---|---|
| 交互入口 | 单聊（每人各自与机器人单聊，共享 `QuoteRequest` 聚合根） |
| 数据底座 | 自建 CloudBase PG 表（`ErpClient` 契约留好，ERP-MCP 就绪即换实现） |
| 老工程 | 冻结为参考 |
| 云环境 | 复用 saleagent 同一环境 |
| 范围 | 不含盖章；含 30 天轻出单 + 1—N 多布种聚合 |
| 版式 | 沿用 `报价单模板.docx` |

## 快速开始（T1 后可用）

```bash
python3.12 -m venv .venv && .venv/bin/pip install -r requirements.txt
cp .env.example .env   # 填入企微凭证与 API keys
.venv/bin/python -m pytest   # 全量回归（含金样对拍）
```

## 安全边界

- 所有凭证只放 `.env`（已 gitignore），仓库仅存 `.env.example` 模板
- 算价内核不调用任何外部服务；LLM 不接触价格字段
- 审计流 append-only，应用层不提供改写接口