# 资产管理系统 — 项目文件目录结构 ``` assetmanager/ │ ├── pom.xml # Maven项目配置文件，管理依赖（mysql-connector、jfreechart等） │ ├── docs/ # 项目文档目录 │ ├── architecture-design.md # 软件架构设计文档 │ ├── directory-structure.md # 本文件：目录结构说明 │ └── sql/ # SQL脚本目录 │ └── init.sql # 数据库初始化脚本（建库、建表、初始数据） │ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/ │ │ │ └── asset/ │ │ │ │ │ │ │ ├── App.java # 应用程序入口类，含main方法，启动登录界面 │ │ │ │ │ │ │ ├── entity/ # 实体层：与数据库表对应的JavaBean │ │ │ │ ├── User.java # 用户实体，对应t_user表 │ │ │ │ ├── Asset.java # 资产实体，对应t_asset表 │ │ │ │ ├── Category.java # 分类实体，对应t_category表 │ │ │ │ ├── Borrow.java # 借用实体，对应t_borrow表 │ │ │ │ └── Disposal.java # 报废实体，对应t_disposal表 │ │ │ │ │ │ │ ├── dao/ # 数据访问层：直接操作数据库 │ │ │ │ ├── BaseDAO.java # DAO基类，封装通用CRUD操作（增删改查模板） │ │ │ │ ├── UserDAO.java # 用户数据访问，登录验证、注册、查询 │ │ │ │ ├── AssetDAO.java # 资产数据访问，资产CRUD、多条件查询 │ │ │ │ ├── CategoryDAO.java # 分类数据访问，分类CRUD、引用检查 │ │ │ │ ├── BorrowDAO.java # 借用数据访问，借用CRUD、状态更新 │ │ │ │ └── DisposalDAO.java # 报废数据访问，报废CRUD、状态更新 │ │ │ │ │ │ │ ├── service/ # 业务逻辑层：封装业务规则与校验 │ │ │ │ ├── UserService.java # 用户业务逻辑，登录、注册、权限校验 │ │ │ │ ├── AssetService.java # 资产业务逻辑，资产CRUD、状态流转 │ │ │ │ ├── CategoryService.java # 分类业务逻辑，分类CRUD、删除引用检查 │ │ │ │ ├── BorrowService.java # 借用业务逻辑，借用/归还/审批流程 │ │ │ │ ├── DisposalService.java # 报废业务逻辑，报废申请/审批流程 │ │ │ │ └── StatService.java # 统计业务逻辑，各维度数据聚合查询 │ │ │ │ │ │ │ ├── util/ # 工具类目录 │ │ │ │ ├── DBUtil.java # 数据库工具类，连接获取/释放、资源关闭 │ │ │ │ ├── MD5Util.java # MD5加密工具，密码加密 │ │ │ │ ├── ValidatorUtil.java # 表单校验工具，通用校验方法集合 │ │ │ │ └── DateUtil.java # 日期工具类，日期格式转换 │ │ │ │ │ │ │ ├── exception/ # 自定义异常目录 │ │ │ │ ├── BusinessException.java # 业务异常，封装业务逻辑错误信息 │ │ │ │ └── DBException.java # 数据库异常，封装数据库操作错误信息 │ │ │ │ │ │ │ └── view/ # 表示层：Swing界面 │ │ │ ├── LoginFrame.java # 登录窗口，用户名/密码输入与验证 │ │ │ ├── RegisterDialog.java # 注册对话框，新用户注册表单 │ │ │ ├── MainFrame.java # 主窗口，菜单导航+功能面板容器 │ │ │ ├── panel/ # 功能面板目录 │ │ │ │ ├── AssetPanel.java # 资产管理面板，资产列表+增删改查操作 │ │ │ │ ├── CategoryPanel.java # 分类管理面板，分类列表+增删改操作 │ │ │ │ ├── BorrowPanel.java # 借用管理面板，借用申请/审批/归还 │ │ │ │ ├── DisposalPanel.java # 报废管理面板，报废申请/审批 │ │ │ │ ├── StatPanel.java # 统计面板，图表展示各类统计数据 │ │ │ │ └── UserPanel.java # 用户管理面板，用户列表+角色管理（管理员） │ │ │ ├── dialog/ # 弹窗对话框目录 │ │ │ │ ├── AssetDialog.java # 资产新增/编辑对话框，含表单校验 │ │ │ │ ├── CategoryDialog.java # 分类新增/编辑对话框 │ │ │ │ ├── BorrowDialog.java # 借用申请对话框，选择资产+填写原因 │ │ │ │ ├── DisposalDialog.java # 报废申请对话框，选择资产+填写原因 │ │ │ │ ├── ApproveDialog.java # 审批对话框，同意/拒绝+备注 │ │ │ │ └── ChangePasswordDialog.java # 修改密码对话框 │ │ │ └── model/ # 表格数据模型目录 │ │ │ ├── AssetTableModel.java # 资产表格模型，JTable数据适配 │ │ │ ├── BorrowTableModel.java # 借用表格模型 │ │ │ ├── DisposalTableModel.java # 报废表格模型 │ │ │ └── UserTableModel.java # 用户表格模型 │ │ │ │ │ └── resources/ │ │ ├── db.properties # 数据库连接配置（URL/用户名/密码） │ │ └── log.properties # 日志配置文件 │ │ │ └── test/ │ └── java/ │ └── com/ │ └── asset/ │ ├── dao/ # DAO层单元测试 │ │ └── UserDAOTest.java │ ├── service/ # Service层单元测试 │ │ └── UserServiceTest.java │ └── util/ # 工具类单元测试 │ └── ValidatorUtilTest.java │ └── lib/ # 第三方JAR包目录（Maven未管理时备用） └── (mysql-connector-java-x.x.x.jar) ``` --- ## 目录功能注释汇总 | 目录/文件 | 层次 | 职责说明 | |-----------|------|---------| | `pom.xml` | 构建 | Maven项目对象模型，声明依赖（mysql-connector、jfreechart）、编译配置 | | `docs/` | 文档 | 存放项目文档，含架构设计、目录说明、SQL脚本 | | `docs/sql/init.sql` | 数据库 | MySQL初始化脚本，建库建表、外键约束、初始管理员数据 | | `App.java` | 入口 | 程序main方法入口，初始化Look&Feel，启动LoginFrame | | `entity/` | 实体层 | 与数据库表一一对应的JavaBean，含属性+getter/setter | | `dao/` | 数据访问层 | 封装JDBC操作，BaseDAO提供通用CRUD模板，子类实现特定查询 | | `dao/BaseDAO.java` | 数据访问层 | 通用CRUD模板方法，减少子类重复代码 | | `service/` | 业务逻辑层 | 封装业务规则、数据校验、事务控制，调用DAO完成数据操作 | | `util/` | 工具层 | 通用工具类，DBUtil管理连接、MD5Util加密、ValidatorUtil校验、DateUtil日期转换 | | `exception/` | 异常层 | 自定义异常类，BusinessException处理业务错误，DBException处理数据库错误 | | `view/` | 表示层 | Swing界面类，LoginFrame/MainFrame为顶层窗口 | | `view/panel/` | 表示层 | 功能面板，嵌入MainFrame的内容区域，各模块独立面板 | | `view/dialog/` | 表示层 | 弹窗对话框，用于新增/编辑/审批等操作，含表单校验逻辑 | | `view/model/` | 表示层 | JTable表格模型，继承AbstractTableModel，适配数据到表格显示 | | `resources/` | 配置 | 数据库连接配置、日志配置等properties文件 | | `test/` | 测试 | 单元测试目录，结构镜像main/java | --- ## 分层调用关系 ``` App.java (启动) │ ▼ view/ (LoginFrame → MainFrame → panel/dialog) │ 用户操作触发事件 ▼ service/ (业务校验 + 业务逻辑) │ 调用DAO操作数据 ▼ dao/ (JDBC → MySQL) │ 获取连接 ▼ util/DBUtil (连接管理) │ ▼ MySQL (asset_db) ``` **关键调用规则：** - view → service → dao，**严禁跨层调用**（view不可直接调dao） - entity被所有层共享，仅作为数据载体 - util被service/dao/view按需调用 - exception由service/dao抛出，view层捕获展示