# app **Repository Path**: suyali/app ## Basic Information - **Project Name**: app - **Description**: 📦 个人物品管理系统 | uni-app + Spring Boot 3 前后端分离(H5/App 双端) ✨ 核心功能 🗂 物品管理:登记/在用/闲置/已消耗状态流转、归档回收站、批量操作、图片封面 🏷 分类体系:主/子分类两级树,按用户隔离 📍 收纳位置:多层级位置树,物品快速定位 👕 穿搭管理:穿搭组合与物品关联 📊 消费统计:年度总额 / 月支出趋势 / 分类占比三视图,口径一致 📥 Excel 批量导入导出 🔐 多用户数据隔离:user_id 全链路过滤 + X-Session-Token 认证 🧪 自动化测试:pytest 接口套件 20 例 + Playwright E2E 22 例 全绿 🛠 技术栈:uni-app (Vue3) · Spring Boot 3.5 · MyBatis-Plus · MySQL 8 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-04-11 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 个人物品管理 App uni-app (Vue 3) + Spring Boot 3 前后端分离的个人物品管理系统,支持 H5 / 微信小程序 / App 三端。 ## 功能特性 - **物品管理**:登记 / 状态流转(在用·闲置·已消耗)、归档与恢复、批量操作、多条件筛选、图片封面、Excel 导入导出 - **分类管理**:主分类 / 子分类两级树,默认分类自动初始化 - **收纳位置**:多层级位置树,物品快速定位 - **穿搭管理**:搭配组合与关联物品、季节 / 风格标签、图片管理 - **消费统计**:年度总额 / 月支出趋势(点柱下钻当月明细)/ 分类占比三视图,口径一致 - **多用户**:注册登录,`user_id` 全链路数据隔离 ## 文档地图(只看你需要的那份) | 你想做什么 | 看哪份文档 | |---|---| | 了解产品需求、功能清单、验收标准 | `.codeartsdoer/specs/item_manager/spec.md`(PRD v2.0) | | 看技术设计(表结构、接口、架构) | `.codeartsdoer/specs/item_manager/design.md`(v1.1) | | 查开发任务与进度 | `.codeartsdoer/specs/item_manager/tasks.md` | | 看遗留优化项 | `.codeartsdoer/specs/item_manager/OPTIMIZATION_BACKLOG.md` | | **跑测试**(接口 20 例 + E2E 22 例) | 见下方「测试」章节 | | 看测试策略与技术选型(三端) | `docs/TEST_STRATEGY.md` | | 查数据库建表语句(10 张表最新 DDL) | `Spring/src/main/resources/db/schema.sql`(从真实库导出) | | 看历史文档(已过时) | `docs/archive/`(每份顶部有过时原因说明) | > ⚠️ 文档若与代码不一致,**以代码为准**。历史上文档曾出现 10+ 处与代码不符(表名、认证头、状态字段等),2026-11-17 已按代码重写 PRD/设计文档。 ## 项目结构 ``` Spring/ 后端:JDK 17 + Spring Boot 3.5 + MyBatis-Plus + MySQL 8(context-path=/api) Vue/ 前端:uni-app (Vue3) + uView Plus + Pinia tests/ 接口测试(pytest + requests,20 用例) Vue/e2e/ E2E 测试(Playwright,22 用例) docs/ 文档(archive/ 为历史存档) ``` ## 启动 ```bash # 后端(MySQL 需先启动) cd Spring && mvn spring-boot:run # http://localhost:8080/api # 前端 H5 cd Vue && npm run dev # http://localhost:3000 ``` ## 测试 ```bash # 1. 接口测试(需后端在跑;API_BASE 指向实例地址) cd tests && API_BASE=http://127.0.0.1:8081/api python -m pytest -q # 2. E2E 测试(自动起前端 dev server,BACKEND_ORIGIN 指定后端) cd Vue && BACKEND_ORIGIN=http://127.0.0.1:8081 npm run test:e2e # 3. E2E 可视化报告(每用例截图 + 步骤回放) cd Vue && npm run test:e2e:report ``` 测试数据均带「【测试】」前缀并在用例结束时自动清理,不污染真实库存。 ## 关键约定(开发前必读) - **认证**:鉴权头是 `X-Session-Token`(登录响应 `data.token`),不是 Authorization Bearer;`/auth/*` 与图片静态资源免鉴权。 - **HTTP 状态码恒为 200**,业务状态在 body 的 `code` 字段,断言要断 `data.code`。 - **数据隔离**:业务表统一 `user_id` 过滤;实体里的 `username` 仅冗余展示,禁止用于过滤。 - **逻辑删除**用 `is_deleted`(`@TableLogic`);物品状态 `item.status`:0 未设置 / 1 在用 / 2 闲置 / 3 已消耗,归档独立标志 `is_archived`。 - **改 Java 后必须重启实例**(无 devtools,`mvn compile` 不会热加载);验证新代码用临时端口实例(如 8081),勿动正在跑的 8080。 - **git**:远程名是 `app`(`git push app master`);提交时**显式 add**,禁止 `git add -A`(`.codeartsdoer` 是孤儿 gitlink)。