企业管理系统产品系统

行业场景

本项目面向 Amazon 跨境电商企业的内部运营管理需求，解决企业在选品开发、销售团队协作、产品生命周期管理、库存跟踪等环节中的信息化痛点。

业务背景

跨境电商企业的核心业务链路为：产品选品开发 → 供应商对接 → 产品上架销售 → 库存跟踪管理。这条链路涉及开发团队（负责选品和供应商）、销售团队（负责 Amazon
店铺运营）、管理层（负责数据统筹）三方协作，需要一套内部系统将人员、产品、库存数据统一管理。

核心业务场景

1. 组织架构与人员管理

企业管理层按「部门 → 大组 → 小组」三级结构管理销售团队和开发团队，每个人员有独立编号和职级。系统通过组织架构树实现人员的层级管理，并基于职级体系做数据隔离——销售人员只能看到自己团队的数据
，上级可查看下级，同级互不可见。

2. 产品选品与开发管理

开发人员负责市场选品，录入产品信息（中英文标题、SKU、成本价、尺寸、供应商、产品主图等），每个产品绑定对应的开发编号和销售编号，实现从选品到上架的全链路追溯。产品设有启用/停用状态和多级销
售状态流转。

3. 库存跟踪与预警

系统跟踪每个 SKU 在各 Amazon 账号下的总库存和在途库存数量，支持按产品账号、SKU 维度查询库存状态，辅助运营人员及时补货决策，避免断货或积压。

4. 消息通知与运营推送

系统支持三种消息触达方式：站内系统通知（含已读/未读状态追踪）、企业微信推送（对接 WxPusher
API）、邮件通知。支持按指定用户、按角色、全员广播三种发送模式。每日自动生成运营日报推送至管理层，定时任务执行结果实时推送通知。

5. 权限控制与操作审计

基于 RBAC 模型实现细粒度权限管理，覆盖菜单、按钮、接口三级控制。操作日志完整记录每次增删改操作的修改前/修改后数据快照、操作人、操作 IP，满足企业内部审计合规要求。

6. 数据导入导出与自动化

支持批量 Excel 导入导出（pandas + openpyxl），定时任务自动清理过期导出文件（MinIO 对象存储）。组织架构树数据通过 Redis 缓存并定时重建，采用 pipeline 原子切换保证缓存数据一致性。

本项目是一套面向 Amazon 跨境电商企业的全功能内部管理系统，涵盖认证鉴权、组织架构、业务管理、消息通知、系统运维五大板块，共 13 个功能模块，实现企业从人员管理到业务运营的全链路数字化。

认证鉴权体系： 实现完整的用户注册登录流程，支持邮箱验证码校验、JWT Token 会话管理、忘记密码重置。管理员可切换身份登录其他账号，满足多角色操作场景。会话数据存储于
Redis，退出即失效，保障账号安全。

用户管理： 支持用户的增删改查、角色分配、启用禁用，个人信息可自行修改头像和简介。管理员可查询指定用户的权限列表和操作历史。用户数据支持 Excel 导出，导出链接通过消息通知异步推送。

权限控制： 基于 RBAC 模型实现细粒度权限管理，支持权限点的增删改查、权限树可视化配置、角色与权限的灵活关联。权限校验下沉到 Service
层统一管控，覆盖菜单、按钮、接口三级粒度。支持查询指定权限关联的用户和角色，方便权限审计。数据层面实现职级隔离——同级互不可见，上级可查看下级，保障数据安全。

组织架构管理： 按「部门 → 大组 → 小组」三级结构管理销售团队和开发团队，架构树数据通过 Redis 缓存并由 Celery 定时任务自动重建，采用 pipeline
原子切换保证缓存一致性。支持按组织条件查询销售编号和开发编号，各业务模块均支持按组织架构筛选数据。

销售管理： 录入和管理销售人员信息，绑定用户账号、编号、部门、职级，支持按组织架构筛选查询。新增时可自动获取拥有销售角色的用户列表进行绑定。

开发人员管理： 录入和管理开发人员信息，结构与销售管理对称，支持独立的组织架构筛选和数据隔离。

产品管理： 管理产品 SKU 信息，包括中英文标题、成本价、尺寸、供应商、产品主图等字段。每个产品绑定销售编号和开发编号，实现从选品到上架的全链路追溯。支持按 SKU、账号、状态等多维度筛选。

库存管理： 跟踪每个 SKU 在各 Amazon 账号下的总库存和在途库存数量，支持按产品账号、SKU 维度查询，数据按职级隔离，辅助运营人员及时补货决策。

消息通知： 实现站内通知的发送、接收、已读标记、未读计数完整闭环。管理员发送通知支持三种模式——指定用户、按角色筛选、全员广播，通知通过 Celery
异步分发。同时对接企业微信推送和邮件通知，实现三通道同步触达。系统每日自动生成运营日报推送至管理层。

文件上传： 集成 MinIO 对象存储，支持图片和文档上传，50MB 以上大文件自动分片上传。文件按日期目录归档存储，导出文件由 Celery 定时任务自动清理，避免存储膨胀。

操作日志： 全量记录增删改操作，包含操作人、模块、目标实体、修改前后数据快照、操作 IP 等信息，支持按模块、操作人、时间范围筛选查询，满足企业内部审计合规要求。

开放接口： 提供验证码 OCR 识别接口，上传验证码图片自动识别返回文本，通过独立 API Token 鉴权，可对接外部自动化流程。

架构设计

后端采用 FastAPI 四层分层架构：API 层负责路由和参数校验，Service 层统一处理业务逻辑与权限校验，Repository 层封装数据库访问，Model 层定义 ORM
模型。每一层职责清晰、边界明确，模块间通过依赖注入解耦。前端采用 Vue 3 + Vite + Naive UI，Pinia 状态管理，Axios 封装请求拦截，Vue Router 实现路由守卫与权限控制。

数据库与缓存

使用 MySQL 作为主数据库，SQLModel + SQLAlchemy 双 ORM 方案——SQLModel 定义模型结构与 Pydantic 校验，SQLAlchemy 处理复杂查询和异步会话。Redis 多 DB
路由设计，不同业务（会话、组织架构、缓存）隔离到独立 DB，避免 key 冲突。组织架构树数据通过 Redis 缓存，定时任务使用 pipeline 原子切换保证数据一致性。

认证与安全

用户密码使用 Argon2 哈希加密存储，登录后签发 JWT Token，会话信息存入 Redis 并设置过期时间。每次请求通过中间件校验 Token 有效性，退出登录时主动清除 Redis 会话。邮箱验证码通过 aiosmtplib
异步发送，开发环境直接返回验证码方便调试。CORS 跨域配置通过环境变量控制，生产环境严格限制来源域名。

权限控制实现

RBAC 权限体系通过四张表实现——用户表、角色表、权限表、以及用户-角色和角色-权限两张关联表。权限校验统一封装为 check_permission 方法，在 Service 层调用，避免 API
层遗漏。前端通过路由守卫拦截无权限页面，按钮级别通过自定义指令控制显示隐藏。数据职级隔离通过组织架构过滤实现——查询时自动注入当前用户的组织条件，同级数据互不可见。

异步任务调度

集成 Celery + RedBeat 实现异步任务和定时调度。系统通知发送、每日日报生成、过期文件清理、组织架构树重建四个任务分别调度。通知发送通过 delay() 异步分发，API 立即返回，Worker
后台执行。导出文件由定时任务每日自动扫描 MinIO 并批量删除过期文件。所有任务执行结果通过企业微信实时推送通知管理员。

文件存储

MinIO 对象存储按业务分桶管理——图片桶和文档桶隔离。文件按 年/月/日 三级目录归档，文件名使用 UUID 避免冲突。大文件（≥50MB）自动启用分片上传，8MB 分片大小，4 并发上传，提升上传稳定性。

数据导出

基于 pandas + openpyxl 实现 Excel 导出功能。导出任务通过 FastAPI BackgroundTasks 在后台执行，生成文件后上传至 MinIO 并通过消息通知推送下载链接给用户，避免大数据量导出阻塞请求。

容器化部署

Docker Compose 编排三个服务：Web 服务（Gunicorn + Uvicorn Worker，2 进程）、Celery Worker（异步任务执行）、Celery Beat（定时任务调度）。每个服务设置内存限制，Web 512M、Worker 256M、Beat
128M。日志使用 json-file 驱动，限制单文件 10MB、最多 3 个文件。所有服务共享 bridge 网络，通过 Docker 内部 DNS 通信。

前端实现

Vue 3 组合式 API 开发，Vite 构建工具链。封装 Axios 请求拦截器统一处理 Token 注入和响应错误。Pinia 管理用户状态、应用配置、标签页视图。路由守卫实现未登录跳转和权限页拦截。提取公共组件如组
织架构筛选器、权限树选择器，多处复用。构建时自动注入版本时间戳，前端定时检测版本更新并提示用户刷新。

工程规范

Git 提交遵循 feat/refactor/fix 规范，每个模块配有完整的 Pydantic Schema 定义（请求模型、响应模型分离）。统一响应格式 {code, msg, data}，统一异常处理中间件。雪花算法生成分布式
ID，保证全局唯一。项目配有《开发文档》和《接口文档》双重文档，接口文档覆盖全部 14 个模块的请求参数、响应格式、分页规范。