业务和功能介绍
项目面向非遗缠花作品的数字化展示与内容运营场景，通过 NFC 标签和二维码连接实物作品与线上内容，让用户能够便捷了解作品故事、工艺特点和制作过程。立项目标是建立一个长期稳定的访问入口，使客户可以自主更新文字、图片和视频，减少内容维护对开发人员的依赖，并支持内容更新后继续使用原有标签和二维码。
系统包含公开展示页和独立管理后台。公开页支持手机、平板和电脑访问，以文字、图片、图文组合及视频模块展示内容；后台提供管理员登录、素材上传与验证、模块编辑与排序、草稿保存、预览发布、二维码生成，以及默认关闭的可选访问统计功能。
管理员的操作路径为“登录后台 → 上传素材 → 编辑内容 → 保存草稿 → 预览 → 发布”。访客通过“NFC 触碰或二维码扫码 → 打开统一展示页 → 浏览图文与播放视频”访问内容。草稿修改不会影响已发布页面，发布后新访问或刷新即可读取最新内容，无需重新写入 NFC 标签。
系统包含公开展示页和独立管理后台。公开页支持手机、平板和电脑访问，以文字、图片、图文组合及视频模块展示内容；后台提供管理员登录、素材上传与验证、模块编辑与排序、草稿保存、预览发布、二维码生成，以及默认关闭的可选访问统计功能。
管理员的操作路径为“登录后台 → 上传素材 → 编辑内容 → 保存草稿 → 预览 → 发布”。访客通过“NFC 触碰或二维码扫码 → 打开统一展示页 → 浏览图文与播放视频”访问内容。草稿修改不会影响已发布页面，发布后新访问或刷新即可读取最新内容，无需重新写入 NFC 标签。
项目实现
项目采用前后端分离与 Serverless 架构，通过 npm Workspaces 管理公开页、管理后台、服务端和共享代码。公开页部署在 `/`，后台部署在 `/admin/`，业务请求通过 `/api` 网关进入云函数。数据库保存页面内容、素材元数据和访问记录，私有云存储保存图片与视频，浏览器通过服务端签发的临时地址上传或读取素材。
| 模块 | 技术栈与实现思路 |
|---|---|
| 公开展示 | React、TypeScript、Vite；实现响应式布局、模块化内容渲染、图片懒加载、视频点击加载及失败重试。 |
| 管理后台 | React、Ant Design、CloudBase 托管认证；实现素材管理、内容编辑、草稿预览、发布和设置。 |
| 业务服务 | Node.js、TypeScript、CloudBase 云函数；统一处理管理员鉴权、参数校验、发布逻辑、媒体验证和统计清理。 |
| 数据与存储 | PostgreSQL JSONB 保存灵活的内容结构，通过数据库事务与 RPC 保证提交一致性；私有素材桶结合签名地址控制访问。 |
| 共享代码 | TypeScript、Zod；统一前后端数据类型和校验规则，减少接口字段不一致的问题。 |
**我的负责模块和结果：**
我负责项目的全栈开发与部署交付，包括公开展示页、管理后台、业务接口、共享数据模型、PostgreSQL 适配、素材上传验证及云端部署。同时完成部署配置、源码与上传包整理，并编写客户操作手册、部署手册和验收资料，支持客户后续自主维护和部署。
根据项目的 **2026 年 10 月 7 日检查记录**，全仓 TypeScript 检查、生产构建和 44 项测试通过。演示环境已完成真实登录、图片与视频上传、草稿保存、预览发布、刷新持久化及视频播放验证；客户试用环境已完成部署和基础接口检查。
**遇到的难点和解决方案：**
1. **并发编辑与发布一致性。**多个窗口编辑同一页面可能覆盖内容，素材删除也可能与发布产生冲突。我使用草稿版本校验、数据库版本比较和原子 RPC 提交，过期编辑返回冲突提示并保留当前内容；发布切换完整快照，同时在事务中检查素材引用，避免页面引用已删除素材。
2. **素材上传安全与播放兼容。**文件扩展名和浏览器声明不能证明真实格式。我采用“临时目录直传 → 服务端读取并验证 → 写入最终目录”的流程，使用 Sharp 解析图片，检查 MP4 内部结构及 H.264/AAC 编码。客户端不能覆盖最终素材，正在被草稿或发布页面引用的素材也不能直接删除。
3. **PostgreSQL 与现有业务接口适配。
| 模块 | 技术栈与实现思路 |
|---|---|
| 公开展示 | React、TypeScript、Vite；实现响应式布局、模块化内容渲染、图片懒加载、视频点击加载及失败重试。 |
| 管理后台 | React、Ant Design、CloudBase 托管认证；实现素材管理、内容编辑、草稿预览、发布和设置。 |
| 业务服务 | Node.js、TypeScript、CloudBase 云函数；统一处理管理员鉴权、参数校验、发布逻辑、媒体验证和统计清理。 |
| 数据与存储 | PostgreSQL JSONB 保存灵活的内容结构，通过数据库事务与 RPC 保证提交一致性；私有素材桶结合签名地址控制访问。 |
| 共享代码 | TypeScript、Zod；统一前后端数据类型和校验规则，减少接口字段不一致的问题。 |
**我的负责模块和结果：**
我负责项目的全栈开发与部署交付，包括公开展示页、管理后台、业务接口、共享数据模型、PostgreSQL 适配、素材上传验证及云端部署。同时完成部署配置、源码与上传包整理，并编写客户操作手册、部署手册和验收资料，支持客户后续自主维护和部署。
根据项目的 **2026 年 10 月 7 日检查记录**，全仓 TypeScript 检查、生产构建和 44 项测试通过。演示环境已完成真实登录、图片与视频上传、草稿保存、预览发布、刷新持久化及视频播放验证；客户试用环境已完成部署和基础接口检查。
**遇到的难点和解决方案：**
1. **并发编辑与发布一致性。**多个窗口编辑同一页面可能覆盖内容，素材删除也可能与发布产生冲突。我使用草稿版本校验、数据库版本比较和原子 RPC 提交，过期编辑返回冲突提示并保留当前内容；发布切换完整快照，同时在事务中检查素材引用，避免页面引用已删除素材。
2. **素材上传安全与播放兼容。**文件扩展名和浏览器声明不能证明真实格式。我采用“临时目录直传 → 服务端读取并验证 → 写入最终目录”的流程，使用 Sharp 解析图片，检查 MP4 内部结构及 H.264/AAC 编码。客户端不能覆盖最终素材，正在被草稿或发布页面引用的素材也不能直接删除。
3. **PostgreSQL 与现有业务接口适配。
示例图片视频
相似推荐
quick_server
1、背景和目标：对企业所有服务请求进行轻量级安全和速度优化，减轻服务器的并发压力。
2、quick_server系统，不依赖外部引用，即插即用，主要用来进行极速快捷安全的http请求。大大减轻服务器的并发压力。轻松实现高并发场景下极速快捷安全的http请求。
json解析转换器
1、背景和目标：一、超级快速、安全对json的解析与对象转换；二、支持分布式超高并发
2、json解析转换器，支持分布式高并发，支持百万级别访问。用于快速进行json的解析与对象转换。原有的开源工具，要么安全性不够，要么性能不够强悍，要么不支持定制，很难满足企业日益严苛的业务需求。开发的这个json解析转换器，可以同时满足以上三种需求。
消息中心
1、背景和目标：解决高并发，对外提供统一的消息处理业务
2、功能模块介绍：六大功能模块：http通讯模块、缓存模块、消息队列模块、消息重试中心模块、消息调度模块、公共模块；对外百万级别并发项目，TPS可达1000/s。作为中间件，对外提供统一的消息处理业务。所有系统，包括电子签章平台、一照通行平台、一网通办平台，消息的请求和处理都经过消息中心。轻松实现异步、解耦、削峰。
3、功能描述：支持企业所有的内部系统接入，包括电子签章平台、一照通行平台、一网通办平台。轻松实现异步、解耦、削峰。
CRM客户管理后台
立项背景：针对中小型企业客户信息分散、销售跟进过程不透明、合同管理混乱等痛点，旨在打造一个轻量级的客户全生命周期管理后台，提升销售团队协作与转化效率。
核心功能：涵盖管理员登录鉴权、客户主表管理、联系人维护、跟进记录追踪、合同管理等六大模块。支持客户信息分页查询、关键字搜索、新增编辑与逻辑删除；客户详情页以名片形式集中展示联系人、跟进记录及关联合同。
业务流程：从潜在客户录入，到日常跟进记录，再到最终合同签订与操作日志审计，覆盖完整的销售业务闭环。
个人记账与资产管理平台
本项目是一套从零搭建的全栈个人财务管理平台，目标是替代功能单一的记账工具，把日常记账、资金账户、借贷往来、预算控制、资产盘点收敛到一个数据自主的系统中。系统由 12 个业务模块、23 个控制器、170 个 REST 接口、36 张数据表构成：记账核心支持三级分类树、商家联想、多平台支付与 CSV 批量导入导出，每笔账单自动联动账户余额并留存流水日志；借贷模块实现未结清 / 已结清 / 已放弃三态模型，支持分期还款与坏账核销；预算模块提供月度 + 年度双层体系与阶梯式执行规则；资产模块通过快照与趋势图呈现净资产变化；报表模块支持从月度 / 年度报表下钻到分类明细。系统还包含完整 RBAC 权限体系、软删除回收站、8 套主题实时切换与中英双语国际化。核心业务流程为：记一笔 → 余额幂等联动 → 报表与预算同步更新；借据从创建、关联账单凭证、分期还款到三态判定的完整生命周期；以及登录后由后端菜单树动态生成侧边菜单、路由与区块双重门控的权限链路。
帮助文档
Copyright @ 2021-2024 程聚宝 | 浙ICP备2021014372号
人工客服