CoolingIntel AI · 本地部署架构确认稿 v3

01 · Recommended Direction

总体技术架构

前端负责操作界面，后端负责业务逻辑、数据库读写和 AI 调用。每个节点都标注推荐技术栈。

1

用户端浏览器

销售录入每日沟通记录
管理层查看推进表和 AI 日报
管理员导入客户名单和产品资料
访问地址示例：http://本机IP:8080

HTML5 CSS3 Vanilla JS

2

本地后端服务

保存客户主数据、客户画像、商机和销售记录
封装 DeepSeek API 调用
执行 AI 提取、画像生成、日报汇总
提供 Excel / CSV 导入导出接口

Python 3.11 FastAPI SQLAlchemy

3

本地数据层

SQLite 数据库：data/sales-board.db
核心表：customers / customer_profiles / opportunities
备份目录：data/backups/
导入目录：imports/
导出目录：exports/

SQLite 3 JSON

4

AI 服务

联网模式：调用 DeepSeek API
API Key 存在本地后端 .env 文件
前端页面不接触 Key
完全离线时可升级本地大模型方案

DeepSeek API 可换 Ollama

03 · Core Logic

核心业务逻辑

从"多信息源进入系统"到"管理层看到带来源标注的结构化日报"。

STEP 01

导入基础资料

管理员导入客户主数据、商机清单、团队名单、产品规格、偏好用语，形成系统基础数据。

STEP 02

接入信息源

销售记录、客户主数据、商机资料、产品文档、公开网页、招投标信息、人工补充统一进入来源库。

STEP 03

建立来源索引

记录来源类型、来源名称、URL/文件名、采集时间、录入人、可信度和证据快照。

STEP 04

AI 结构化提取

后端调用 DeepSeek，提取需求、预算、角色、风险、下一步动作，并绑定引用来源。

STEP 05

写入本地数据库

原始内容、来源索引、AI 结构化结果和引用关系同时保存，便于追溯和二次分析。

STEP 06

生成带来源视图

自动更新商机推进表、客户画像、风险提醒和 AI 日报，并在关键结论旁显示来源徽章。

04 · Information Sources

信息源与采集方式

客户画像与 AI 日报抓取的数据性质不同，分开建模、各自标注源徽章。

客户画像 · 多源汇聚

外部公开数据 + 客户私有数据 · 周 / 月级更新 · 长期累积

外部公开数据 · 4 类

工商企查查 / 天眼查 — 公司基础、股权穿透、高管公示
政府发改委 / 国资委 / 招投标网 — 政策、招标公告
新闻36 氪 / 信通院 / 行业媒体 — 企业动态、行业趋势
官方公司官网 / 年报 / ESG 报告 / LinkedIn

客户私有数据 · 3 类

文档客户提供方案文档、技术规格、BOM 表
检测第三方检测报告（SGS / TÜV / 国内）
销售销售一线沟通记录、现场观察

关联商机阶段标签 · 由商机销售记录判定

技术验证阶段某个商机的销售记录出现送样、测试、技术参数确认、材料兼容性、第三方检测、现场验证等信号时判定。
商务阶段某个商机的销售记录出现报价、预算、合同、付款条件、采购流程、交期、竞品比价、管理层拍板等信号时判定。

AI 日报 · 内部聚合

销售当日动作 + 系统规则触发 · 日级实时 · 行动导向

当日销售活动 · 3 类

推进销售推进表新增 / 阶段变化
原文当日全部沟通原文（电话 / 微信 / 拜访）
AI当日 4 模块结构化提取结果

系统规则 + 历史对照 · 4 类

规则风险预警触发（材料 / 竞品 / 决策链）
规则管理层介入触发（金额 / 关系 / 竞争）
批示历史管理层批示与执行记录
对比与昨日 / 上周日报趋势对比

来源标注规范 · 前端徽章 + 跳转

每个数据点在界面上用源徽章独立标注（如工商政府销售 AI 推断技术验证阶段商务阶段）。徽章可点击：外部源跳转到原始链接（企查查搜索页 / 招标网公告 / 公司官网），内部源跳到销售推进表过滤视图，AI 推断显示推断逻辑气泡。客户老板任意一条数据都能溯源到原始出处。

链路	系统保存内容	前端展示方式
原始来源	来源类型、来源名称、URL/文件名、采集时间、录入人、原文摘要、证据快照	源徽章 + 原始链接 / 文件入口 / 销售记录入口
可信度标记	官方公开、内部记录、人工判断、AI 推断、待核实等来源等级	官方 / 销售 / 文档 / AI 推断 / 待核实标签
AI 输出引用	客户画像、日报结论、风险提示与来源证据之间的引用关系	每条关键结论后显示来源徽章，点击可查看证据
商机阶段判定	从商机下的销售记录中提取技术验证信号或商务推进信号，写入 opportunities.phase_tag，并保存判定依据和触发关键词	客户画像中的关联商机列表显示技术验证阶段 / 商务阶段标签，点击查看对应商机和销售记录

05 · Data Storage

数据库与文件存放方式

第一版以 SQLite 为主，简单、稳定、易备份；含 AI 调用审计表。

本地目录建议

✓data/sales-board.db：主数据库文件
✓data/backups/：每日或手动备份
✓imports/：客户名单、产品规格、外部资料导入文件
✓sources/：网页快照、上传文档、来源原文和证据附件
✓exports/：带来源标注的商机推进表、日报、客户画像导出结果
✓config/.env：DeepSeek API Key 和系统配置

数据表建议

✓customers：客户主数据，仅放客户名称、法定名称、统一社会信用代码、地区、行业、客户类型、规模、官网
✓customer_profiles：与 customers 1:1，保存客户画像、组织摘要、采购风格、技术偏好、风险画像、产品适配点和引用来源
✓opportunities：与 customers 1:N，保存商机/项目名、应用场景、预计金额、当前阶段、phase_tag、成交概率、负责人、预计签约时间、状态
✓decision_makers：决策链 6 类角色、关系强度、来源，可关联客户或具体商机
✓sources：来源类型、来源名称、URL/文件名、采集时间、可信度、证据快照
✓source_refs：客户画像、日报结论、风险提示与来源证据的引用关系
✓sales_records：原始沟通文字、日期、销售人员、沟通方式，优先关联 opportunity_id，也保留 customer_id 便于查询
✓ai_extractions：AI 提取结果、风险、下一步动作、阶段信号，关联 sales_record_id / opportunity_id
✓ai_logs：AI 调用审计 · 模型版本 · 故障追溯
✓reports：日报、周报、管理层批示、引用来源

06 · User Access

用户端怎么使用

用户不用安装复杂软件，只需要打开浏览器。

角色	使用方式	核心权限	典型操作
销售	浏览器访问本地系统地址	录入、查看自己负责客户、导出个人记录	选择客户、粘贴沟通记录、补充来源标签、点击 AI 提取、确认后保存
管理层	浏览器访问同一系统地址	查看全局商机推进表、客户画像、日报和风险提示	查看重点商机、核对来源标注、批示下一步动作、导出日报或周报
管理员	本地服务器或管理入口	配置 API Key、导入客户名单、备份数据库	维护客户主数据、商机表、团队名单、产品规格、外部信息源、系统偏好语

07 · Deployment Options

本地部署形态选择

按使用人数和网络条件选择部署方式。

部署形态	适用场景	访问方式	建议
单机试用版	1 人试用、演示、快速验证流程	http://localhost:8080	最快启动，但不适合团队共享
局域网共享版	销售团队和管理层共同使用	http://内网主机IP:8080	推荐第一版正式落地方式
完全离线版	客户环境不能访问外网	内网访问，本地模型推理（Ollama / 通义 / Qwen 等）	需要另评估硬件、模型效果和部署成本

08 · Security & Backup

安全与备份原则

正式使用前必须明确数据和 Key 的管理责任。

安全原则

✓DeepSeek API Key 只放在后端 .env，不写入 HTML。
✓销售原始沟通记录和 AI 结果保存在本地数据库。
✓外部公开信息抓取范围由客户确认，例如官网、公告、招投标、工商公开信息。
✓客户画像和 AI 日报的关键结论必须显示来源标注和可信度。
✓局域网使用时建议限制访问 IP 或增加登录账号。
✓历史销售记录用于调 Prompt 前应做脱敏处理。

备份原则

✓支持手动导出带来源标注的 Excel / CSV / JSON。
✓支持数据库文件一键备份到 data/backups/。
✓来源原文、网页快照、上传文件和证据附件同步纳入备份范围。
✓建议每天自动保留一个备份，至少保留最近 30 天。
!正式版以 SQLite 为主数据源，浏览器 localStorage 仅用于临时草稿或界面状态。

09 · AI Resilience

AI 调用保障与降级策略

AI 不能 100% 稳定，正式版必须有兜底机制和故障追溯能力。

三类失败 · 三种兜底

✓DeepSeek API 限流 / 故障：自动退回规则正则提取，标记"AI 服务有限"，销售可手动修正后保存。
✓网络断开：销售记录先保存到本地 SQLite，恢复后批量补提取，原文不丢失。
✓LLM 输出格式错乱：自动重试 1 次，仍失败则标记为"AI 失败"，原文保留供人工处理。

审计与监控

✓所有 AI 调用进 ai_logs 表，含模型版本、Token 用量、耗时、状态、错误信息。
✓提供"AI 故障率"查询，管理员可监控 7 天内成功率和质量趋势。
✓关键决策项（送样 / 报价 / 管理层介入）必须基于 AI 成功的提取结果。
✓原始沟通文字独立保存，AI 结果可重跑、可对比、可版本回溯。

10 · Customer Confirmation

请客户确认的关键事项

确认后即可进入本地 MVP 开发与联调。

部署方式

确认使用单机版、局域网共享版，还是完全离线版。

运行主机

确认系统安装在哪台电脑或内网服务器上。

技术栈

确认 Python + FastAPI + SQLite 是否符合贵司现有 IT 体系。

联网条件

确认后端是否可以访问 DeepSeek API。

数据范围

确认第一版导入哪些客户主数据、商机/项目清单、销售记录、产品资料、历史记录和外部公开信息源。

数据边界

确认 customers 只做客户主数据，项目/预算/阶段/推进状态统一放在 opportunities。

权限要求

确认是否需要登录账号、角色权限和操作日志。

AI 故障处理

确认 AI 失败时是销售自行补全，还是统一标记后由管理员处理。

信息源接入范围

确认客户画像和 AI 日报第一版接入哪些内部源、外部源和人工补充源。

来源标注规则

确认输出中是否必须显示来源类型、文件名/URL、采集时间、可信度和证据入口。

备份策略

确认备份频率、备份保留天数和负责人。

11 · MVP Scope

第一版建议范围

先保证可用、稳定、可备份，再扩展权限和多人协同细节。

模块	第一版能力	后续增强
客户管理	Excel 导入客户主数据，customers 只保存客户名称、地区、行业、类型、规模、官网等纯客户信息	客户分层、标签体系、主数据查重、负责人权限
商机管理	建立 opportunities 商机表，保存项目名、应用场景、预计金额、当前阶段、技术验证/商务阶段标签、负责人和状态	商机阶段历史、成交概率模型、预计签约时间提醒、多商机并行管理
销售记录	录入原始沟通文字，优先挂到 opportunity_id，同时保留 customer_id 便于客户维度查询	语音转文字、微信记录导入、附件管理、来源自动识别
AI 提取	提取需求、预算、角色、风险、下一步动作，并绑定引用来源	Prompt 版本管理、人工校正反馈学习、证据冲突检测
信息源管理	客户画像 4 类外部源 + 3 类私有源；AI 日报内部聚合；每条数据带源徽章和证据入口	招投标自动监测、企查查 API、政策订阅、来源可信度评分、过期提醒
客户画像	customer_profiles 与 customers 1:1，保存客户层长期认知；页面展示该客户下各商机的技术验证阶段 / 商务阶段标签	多来源对比、可信度排序、画像版本历史、客户层画像与商机层推进分离
AI 调用保障	三类失败兜底（API 故障 / 断网 / 格式错乱）+ ai_logs 审计表	AI 故障率看板、自动告警、Prompt A/B 对比
管理日报	生成每日重点客户、风险项目和待办建议，并显示结论来源	周报、月报、自动推送、来源追溯审阅
导入导出	支持客户名单导入、带来源推进表导出、数据库和来源文件备份	定时备份、跨设备迁移、一键恢复

液冷冷却液 AI 销售作战系统本地部署技术架构确认稿

推荐结论

建议采用"本地小系统"方案

第一版交付能力