山房文创是一个面向C端用户的文房文创电商Web平台,主打文房四宝(笔墨纸砚)、文创周边及古籍复刻三大品类的线上选购。立项目标为打造具有传统美学气质的文创购物体验。核心功能模块包括:首页卷轴叙事风格展示与分类导航、商品分类浏览与多维筛选(按一/二/三级分类、关键词、价格区间)、商品详情页(规格选择、库存展示、墨友品鉴评价、星级打分与晒图)、购物车(多选/全选/数量修改)、结算页(收货地址管理、支付方式选择、文创立减优惠券选择与实付计算)、个人中心(订单管理与状态流转、我的优惠券)以及后台管理系统(商品/分类/订单/会员管理)
整体采用前端单页应用架构,技术栈为 React + TypeScript + Vite + Tailwind CSS + shadcn/ui,使用 React Context 统一管理购物车、商品、订单、优惠券等全局状态,数据层使用 MockData 模拟,路由基于 React Router v6。负责模块包括:商品详情页的墨友品鉴评价板块(1-5星打分、图片上传、评价列表与统计分布)、结算页优惠券抵扣闭环(满减券/立减券领取、门槛校验、实付金额计算 ≥0)、首页三大分类卡片宣纸微浮与墨晕扩散悬停动效(CSS keyframe + radial-gradient)。难点在于导航高亮状态精准互斥(全部分类与三大子分类不能同时高亮),通过解析 URL query 参数(c1/c2/c3)精确判定激活分类,彻底修复了多项并列高亮的 Bug