立项原因与要解决的产品问题：
健康类商品（药品、保健品、医疗器械、营养食品等）线上化后，用户难以按自身体质和需求选品，商家也缺少与体质辨识结合的管理与运营工具。商城模块的立项，是为了解决“选品不精准、管理不独立、与健康业务脱节”等问题，通过体质化推荐与独立管理端，让商品与中医体质场景深度结合。
行业场景与业务背景：
所处行业为大健康与健康电商。业务场景包括：C 端用户在健康 App/Web 内完成体质测评后，在商城中浏览、加购、下单，并享受基于体质的商品推荐；B 端由独立商城管理端负责分类、商品、订单与发货，使用独立账号体系，与主站健康管理用户分离，便于运营与权限管理。
具体功能模块：
商城包含管理端与App/Web 用户端。管理端（独立系统）：管理员登录（独立用户表与 JWT）、分类管理（增删改查、排序、上下架）、商品管理（多条件筛选、分页、商品详情编辑、价格/库存/体质编码、上下架）、订单管理（状态筛选、订单详情、发货操作）。App/Web 用户端：商品分类与列表、商品详情、按体质推荐、购物车、下单与订单列表、订单详情。
主要功能描述：
管理端提供完整的后台能力，支持分类与商品的 CRUD 及订单处理；商品支持关联体质编码（如气虚、阳虚等），便于做体质化推荐。用户端在健康应用内可浏览商品、加购、填写收货信息下单，并查看订单状态；推荐接口结合用户体质与商品体质标签，提升选品相关性。管理端与主站用户体系分离，仅商城管理员可登录管理端，保障权限清晰。
负责的具体任务：
本人负责商城管理端与用户端的功能设计与实现，包括：独立商城管理员用户表与登录/登出、JWT 签发与鉴权中间件、管理端分类/商品/订单的接口与前端页面（Vue3 + Element Plus）、App/Web 端商品列表与详情、购物车与下单接口、体质化推荐逻辑，以及管理端与主站的前端拆分与路由、Token 隔离。
技术栈、架构与实现亮点、难点：
技术栈：后端 Go + Gin + GORM + MySQL，管理端 Vue3 + Vite + Element Plus + Pinia，用户端复用主站 Web/App 技术栈。架构上管理端采用独立路由前缀（/api/v1/mall-admin）、独立 JWT（mall_admin 专用 secret 与 Claims）与独立前端工程（web/mall-admin），与主站用户表及 Token 完全隔离。亮点：管理端与主站账号分离、权限清晰；商品与体质编码关联，支持体质化推荐。难点与应对：独立认证需避免与主站 Token 混用，通过独立 JWT 包与中间件区分；管理端前端需单独登录、存 mall_admin_token，请求拦截器仅携带该 Token 访问 mall-admin 接口。
评论