业务和功能介绍
本项目是一套从零搭建的全栈个人财务管理平台，目标是替代功能单一的记账工具，把日常记账、资金账户、借贷往来、预算控制、资产盘点收敛到一个数据自主的系统中。系统由 12 个业务模块、23 个控制器、170 个 REST 接口、36 张数据表构成：记账核心支持三级分类树、商家联想、多平台支付与 CSV 批量导入导出，每笔账单自动联动账户余额并留存流水日志；借贷模块实现未结清 / 已结清 / 已放弃三态模型，支持分期还款与坏账核销；预算模块提供月度 + 年度双层体系与阶梯式执行规则；资产模块通过快照与趋势图呈现净资产变化；报表模块支持从月度 / 年度报表下钻到分类明细。系统还包含完整 RBAC 权限体系、软删除回收站、8 套主题实时切换与中英双语国际化。核心业务流程为：记一笔 → 余额幂等联动 → 报表与预算同步更新；借据从创建、关联账单凭证、分期还款到三态判定的完整生命周期；以及登录后由后端菜单树动态生成侧边菜单、路由与区块双重门控的权限链路。
项目实现
整体采用前后端分离 + 严格分层架构。前端为 Vue 3（Composition API + script setup）+ TypeScript + Vite + Tailwind CSS v4 + Pinia + Vue Router 5 + ECharts；后端为 NestJS 12，按 Controller（路由 + DTO 校验）→ Service（业务规则）→ Prisma ORM → MySQL 8 分层，对外暴露统一的 /api/v1 RESTful 接口与 JWT 登录态。关键设计决策有四：一是设计 token 驱动主题，所有颜色走 CSS 变量配合 color-mix 生成衍生色，使一套组件零分支适配 8 套主题；二是组件三层抽象收口，PageShell 覆盖 22 个页面、DrawerShell 覆盖 7 处抽屉、ModalShell 覆盖 15 处弹窗，且刻意区分「侧边伴随式用不透明渐变、居中阻断式用玻璃面」两种视觉语义；三是全表软删除配回收站三级操作；四是以权限码而非角色硬编码做门控，并区分查看控整页、编辑控可写块。我独立负责全栈开发，量化结果为 23 个控制器、170 个接口、36 张表、46 个路由页面、262 个 Vue 组件、105 次提交。我主导的浮层三件套重构合并了两个重复确认框、净减 179 行代码且调用方零改动；打通了长期假绿的类型检查闸门，一次修复 17 处真实类型错误。遇到的主要难点包括：solution 风格 tsconfig 导致 vue-tsc --noEmit 不检查任何文件，改用 vue-tsc --build 并挂入 pre-commit 才解决；CSS「一个轴 auto 时另一轴 visible 被计算成 auto」造成弹窗常驻双滚动条，通过重新划分「遮罩层滚、卡片不滚」的滚动责任修复；自动化重构脚本因 includes 守卫被模板中已有内容误导而静默跳过 import，导致三道检查全绿但组件不渲染，改用精确次数断言并新增静态扫描守门；后端 ValidationPipe 只对类 DTO 生效、交叉类型会静默失效，以及数组参数单选被跳过的问题，分别用继承改造与 @Transform 归一化解决。
示例图片视频
相似推荐
json解析转换器
1、背景和目标：一、超级快速、安全对json的解析与对象转换；二、支持分布式超高并发
2、json解析转换器，支持分布式高并发，支持百万级别访问。用于快速进行json的解析与对象转换。原有的开源工具，要么安全性不够，要么性能不够强悍，要么不支持定制，很难满足企业日益严苛的业务需求。开发的这个json解析转换器，可以同时满足以上三种需求。
智能仓储 · 立库调度监控系统（RMS 调度中间件 + 监控管理后台）-RmsCC
【1】立项背景与目标
自动化立体库是新能源锂电、汽车零部件等行业的主流仓储形态，库内由四向车、提升机、输送线、接驳口协同完成托盘出入库。上游 WMS/WES 只下发"某个托盘要入库或出库"，而"分配到哪个货位、走哪条路、派哪台车、每一段由谁执行"全部由中间的调度系统（RMS）计算并驱动——本项目就是一个立库调度中间件 + 配套的调度监控管理后台。目标：把"任务下发→货位分配→路径规划→派车→分段执行→库存过账"做成可跑通、可观测、可人工干预的闭环，并解决现场最头疼的三个问题：调度计划与现场执行脱节、设备与货位状态不可见、故障（走不通、卡住）无日志可查。
【2】核心功能模块
①基础数据：仓库/货区/货位（层-x-y 坐标、深浅位）/设备/物料建模。
②权限体系：JWT + RBAC 用户-角色-菜单三级权限，菜单级与接口级双重校验。
③上游任务管理（内置 WES 模拟器）：批量下发出入库任务，一键生成托盘号。
④任务调度与分段：任务状态机（待下发/执行中/已完成/异常/取消），入库按固定拓扑自动拆 3 段（库外输送线→提升机→目标层接驳口→货位），出库镜像反向。
⑤路径规划：库内 A* 网格寻路（巷道四向可走、货架区仅纵向、有货货位视为障碍），按"空闲且电量>40% + 曼哈顿距离最近"自动派车，支持小车避让、等待点与自动移库（倒库）。
⑥设备仿真引擎：无真实 PLC，用定时任务按可配置节拍推进每段任务并驱动设备沿路径移动。
⑦实时监控：WebSocket 每秒推送设备位置、状态与任务进度，地图大屏显示库位占用与小车轨迹，另配小车/设备监控页。
⑧库存与数据中心：托盘维度库存、分层占用统计、库存流水（任务完成自动过账）。
⑨接口日志中心：按上游/RCS/WCS 三个通道记录每次调用的请求与返回报文、方向、结果、耗时，支持按托盘号/任务号全链路检索与改报文重发。
⑩AI 作业助手：接入大模型，自然语言下发任务、异常诊断与智能问答，SSE 流式输出，模型不可用自动降级为本地规则。
⑪单车手动控制：顶升/放下/移动/充电/恢复/释放任务等指令，应急时人工接管。
【3】业务流程与功能路径
上游下发（托盘号 + 出入库类型）→ RMS 自动分配货位（浅位优先、低层优先）→ 生成分段计划 → A* 计算路径并派最近的空闲车 → 仿真引擎按节拍推进各段 → 全段完成后自动过账（货位占用/释放、绑定或解绑托盘、写库存流水与系统日志）→ 任务归档。
功能路径：登录 → 首页看板（货位占用 + 任务趋势）→ 上游任务管理下发任务 → 资源监控中心地图大屏观察执行 → 立库任务中心（任务视图/任务管理）→ 数据中心查库存与流水 → 报表数据中心查接口日志 → AI 助手用自然语言下单。
多端AI问答系统（SSE流式输出）
立项背景：随着大语言模型的普及，传统企业与用户对智能对话的需求激增。旨在构建一个前后端完全解耦的 AI 问答系统，支持多端接入，提供流畅的流式对话体验。
核心功能：支持 SSE 全链路流式对话（包含start/content/reasoning/done/error五类事件）；多会话管理（新建、切换、重命名、置顶、逻辑删除）；Markdown 渲染、思考过程折叠展示、多模型切换、Token 用量统计与 API 调用日志，以及四维 IP 限流。
业务流程：前端发起对话请求 → 后端校验限流 → 组装历史消息并调用大模型 API → SSE 逐字返回前端实时渲染 → 消息落库并记录 Token 与耗时。
CRM客户管理后台
立项背景：针对中小型企业客户信息分散、销售跟进过程不透明、合同管理混乱等痛点，旨在打造一个轻量级的客户全生命周期管理后台，提升销售团队协作与转化效率。
核心功能：涵盖管理员登录鉴权、客户主表管理、联系人维护、跟进记录追踪、合同管理等六大模块。支持客户信息分页查询、关键字搜索、新增编辑与逻辑删除；客户详情页以名片形式集中展示联系人、跟进记录及关联合同。
业务流程：从潜在客户录入，到日常跟进记录，再到最终合同签订与操作日志审计，覆盖完整的销售业务闭环。
ERP管理系统
本项目面向中小企业的采购、销售、仓储、生产及财务协同场景，目标是将分散的业务记录、审批流程和经营数据整合到统一平台，支持业务过程追踪与数据查询。
系统包含客户与供应商、销售、采购、仓储、生产制造、财务、人力资源、项目合同、资产、质量售后、零售门店、数据报表和系统管理，共13个模块、102个配置驱动页面。核心功能包括客户线索与商机管理、采购与销售订单、库存预留及批次追溯、多级物料清单、生产领料与报工、发票与收付款、会计凭证、薪酬、资产折旧和项目成本分析。
业务流程围绕单据流转展开。例如，销售业务支持“线索→商机→报价→销售订单→发货→发票→收款”；采购业务支持采购申请、采购订单、到货验收、入库及付款。单据通过草稿、提交审批、审批通过和过账等状态进行控制，过账时联动库存台账、资金余额及会计分录，并保留操作历史。
系统提供桌面Web端和移动端入口，共用业务接口与权限规则。管理员可配置用户、角色、菜单、字典和审批权限，员工可按权限处理单据、查看通知和查询报表。经营数据支持按日期汇总及来源下钻，方便追踪库存、应收应付和项目收支。
项目预览
https://tomatoxs.cn:18443
https://tomatoxs.cn:18444
账号：demo
密码：demo123
帮助文档
Copyright @ 2021-2024 程聚宝 | 浙ICP备2021014372号
人工客服