架构与代码组织
单体与微服务分别组织模块、发布和运行工作。固定商城源码版本用于技术说明，不用于推定客户部署结果。
模块分层
单体源码以会员、商品、订单、内容分层，统一应用负责组装；API、业务规则和外部适配各自组织。
发布协作
微服务源码包含网关、认证、管理、商城、支付及监控模块，可分开构建；部署拓扑单独沟通。
后端与构建工具
Java 21、Spring Boot 4.0.8、MyBatis-Plus 3.5.17。 单体发行配置采用PostgreSQL 18。
契约与类型
单体版仓库保留 OpenAPI 契约，管理端和 PC 端提供依据该契约生成接口类型的命令。
前端工具
Vue 3.5.43、Element Plus 2.14.6、Vite 8.3.1。 前端锁定Node 24与pnpm 10.18.2。
终端与页面工程
PC和移动工程有各自工具链，目标终端与运行环境分别验证。
终端版本
PC商城使用Nuxt 4.5.2与Vue 3.5.43。 移动端采用uni-app x工程，HBuilderX锁定5.26.2026091802。
发行与环境准备
构建输入、已有产物、私有配置和运行记录分别保存，交付工具不是自动完成生产验收的声明。
版本与清单
发行脚本打包已有构建产物，生成文件 SHA256 和版本清单；运行验证、业务验收与产物检查分别记录。
准备与执行
准备脚本生成私有配置与初始化资料；数据库操作、容器启动和远程部署由授权人员另外执行。
访问与数据保护
身份、对象和配置共同形成安全机制，角色、撤权、私有附件与客户业务分别验证。
请求身份
管理修改采用CSRF令牌，处理器安全声明与HTTP方法一起检查账号类型。
对象与日志
领域授权通过后读取私有对象；审计路由模板与遮蔽的账号标签分别记录。
源码机制与运行验证，一起组织数据保护
密码单向处理
登录口令使用BCrypt。较长输入先经SHA-256处理，已有口令散列的兼容路径保留。
管理请求校验
管理写入请求检查会话CSRF令牌，商城公开读取使用独立配置。
账号类型限制
处理器声明与HTTP方法共同限制调用者的账号类型。
业务授权检查
服务入口检查商城授权与业务权限，敏感动作另外校验对象归属。
会话状态回读
过滤器在请求时读取账号状态，失效或撤销账号无法继续沿用已有会话。
审计信息脱敏
审计保存路由模板，账号标签按类型遮蔽，原始查询参数避免进入目标记录。
私有对象读取
领域授权通过后签发短期有效读取地址，私有引用与公开链接分开使用。
配置秘密保护
短信及存储秘密使用AES-GCM保护，并绑定配置归属与版本信息。