行业：电缆销售行业。客户是本地做电缆批发生意的中小商家，卖导线、控制电缆、高压电缆、低压铜电缆、低压铝电缆、橡套线、小线、消防电缆等。库存单位是米、卷，型号规格一大堆，管起来乱。
场景：以前用 Excel 管库存，问题多。谁改的不知道，改前多少改后多少查不到。多个业务员一起用，数据乱套。客户欠款算不清，对账靠手抄。货卖出去忘了记，回头对不上。手机在外面想看库存，打不开 Excel。
用了这套系统之后：
库存实时同步，谁在改、改了什么，全有日志。
按团队分数据，多个业务员各看各的，互不干扰。
手机端随时看，外出也能查货、查客户。
客户对账单自动算，欠款、已收、余额一目了然，能打印能导表。
铜价、报价单、客户线索三个小工具，帮业务员开单、找客户。
典型用户：老板、仓库管理员、业务员，一共 3~10 人的小团队。
典型一天：早上看铜价、翻客户对账单催款；白天出货、入库、记日志；下午搜客户线索；晚上汇总销售排行。
已上线功能
· 库存管理：8 个分类，入库/出库，头号尾号，数量自动计算，内联编辑，分类拖动排序，Excel 导入导出，全局搜索，库存预警，回收站。
· 库存总览：分类卡片、预警明细、销售排行、客户对账单、客户管理。
· 操作日志：谁在什么时候改了什么。支持按日期、分类、操作人、客户筛选。可删单条日志。
· 客户管理：统一客户表，增删改实时刷新。客户详情面板，出库记录、收款记录。
· 客户对账单：应收、已收、欠款/余额自动算。支持打印、导出 Excel。
· 销售排行：日、周、月、年。按型号规格统计。
· 团队留言：聊天、已读人数、在线人数、删除。
· 团队管理：成员权限、邀请码、下载 APP 二维码、分类名称设置、危险操作。
· 报价单：铜/铝分标签，按芯型分表，数量来自库存。单价待开发。
· 今日铜价：抓长江现货 1# 铜，一天一条，涨跌重算。新闻分析、走势图、历史价格、明日预测。美元指数待修。
· 客户线索：高德地图搜公司，带电话，可拨号，可导出。
· 蜡烛库存：品牌/规格/型号/单位，颜色横排，数量填写，出库写出库记录。
· 资料库：检验报告、合格证上传。支持多文件、修改、预览、下载、批量下载、过期提醒、品牌独立。单文件上限 1MB。
· 回收站：软删除，30 天内可恢复，管理员可彻底删除。
· 其他：深浅色主题、操作提示音、手机端只读、数据团队隔离、到期锁写。
一、负责哪些具体任务
独立开发整套系统，从需求到上线一个人做。前端、后端、数据库、部署全包。前端做单页应用，一共 8 个库存分类、十几个功能页面。后端用 Cloudflare Workers 写铜价抓取、铜价新闻、客户线索三个接口。数据库用 Supabase，设计全部表结构、权限规则和 RPC 函数。部署用 wrangler 推到 Cloudflare，写脚本自动备份。
---
二、项目使用了哪些技术栈、架构
技术栈：
· 前端：原生 HTML + CSS + JavaScript，无框架，单页应用，hash 路由。
· 后端：Cloudflare Workers，Serverless，静态资源 + 三个 API 代理。
· 数据库：Supabase（PostgreSQL + Auth + Storage + RLS 行级安全）。
· 部署：wrangler 部署到 Cloudflare Pages，自动备份。
· 三方库：xlsx.js 导 Excel、pdf.js 预览 PDF、高德 API 搜客户、Google News 抓铜价新闻。
架构：
· 前端和后端部署在同一域名，Workers 兜底 API，静态资源走 CDN。
· 数据隔离靠 team_id + RLS，每个团队只能看自己的数据。
· 认证走 Supabase Auth，前端只存 token。
· 数据同步用短轮询，6~8 秒刷一次，不依赖 WebSocket。
· 删除用软删除，进回收站保留 30 天，可恢复。
· 每次写操作都记日志，可查、可审计。
---
三、线上亮点、难点
亮点：
· 多团队数据隔离，靠 RLS 把不同团队的数据完全隔开，互不影响。
· 手机、电脑两端适配，同一套代码，手机端自动切卡片/横滑视图。
· 深色、浅色两套主题，跟随系统或手动切，全局统一。
评论