# erp

**Repository Path**: stereov/erp

## Basic Information

- **Project Name**: erp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-09-23
- **Last Updated**: 2026-01-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# ERP 移动端 Android 应用

## 项目简介

本项目是一个基于 Android 原生开发的 ERP（企业资源规划）移动端应用程序，采用 MVVM 架构模式设计，实现用户登录认证和业务数据展示等核心功能。应用使用 Java 语言开发，遵循 Clean Architecture 原则，确保代码结构清晰、易于维护和扩展。

## 主要功能

本应用为用户提供以下核心功能模块：

**用户认证模块** - 支持用户通过用户名和密码进行登录认证，系统会验证用户凭据的有效性，并在认证成功后自动保存登录状态和用户信息。用户登出功能确保账户安全，支持多用户切换场景。

**业务数据展示模块** - 登录成功后，用户可以查看和管理业务数据。应用以列表形式展示业务数据记录，每条记录包含时间戳和两个业务指标（P1、P2），方便用户快速浏览和了解业务状况。

## 技术架构

本项目采用业界广泛认可的 Android 架构组件，构建了一个结构清晰、易于测试和维护的应用体系：

**架构模式** - 项目采用 MVVM（Model-View-ViewModel）架构模式，将界面展示逻辑与业务逻辑分离。ViewModel 层负责处理用户交互和数据变换，LiveData 组件确保数据变化能够自动更新 UI，同时避免内存泄漏和生命周期问题。

**数据管理** - 应用使用 Repository 模式统一管理数据来源，LoginRepository 和 BusinessRepository 分别处理用户认证和业务数据的存取。数据层采用 Result 泛型类封装操作结果，区分成功和失败状态，便于调用方进行统一处理。

**UI 组件** - 登录界面和业务列表界面分别由 LoginActivity 和 BusinessActivity 负责展示，使用 RecyclerView 和自定义 Adapter 展示列表数据。布局文件位于 res/layout 目录下，支持标准的 Android 界面布局。

## 项目结构

```
app/src/main/java/com/lihui/erp/
├── data/                          # 数据层
│   ├── BusinessRepository.java    # 业务数据仓库
│   ├── LoginRepository.java       # 用户登录仓库
│   ├── Result.java                # 操作结果封装类
│   └── model/                     # 数据模型
│       ├── LoggedInUser.java      # 登录用户信息
│       ├── LoginSuccData.java     # 登录成功数据
│       └── TableData.java         # 业务表格数据
├── ui/                            # 界面层
│   ├── login/                     # 登录模块
│   │   ├── LoginActivity.java
│   │   ├── LoginViewModel.java
│   │   ├── LoginViewModelFactory.java
│   │   ├── LoginFormState.java
│   │   └── LoginResult.java
│   └── business/                  # 业务模块
│       ├── BusinessActivity.java
│       ├── BusinessViewModel.java
│       ├── BusinessViewModelFactory.java
│       ├── BusinessResult.java
│       └── ResultAdapter.java
└── utils/                         # 工具类
    ├── FebsResponse.java          # API响应封装
    └── network/DBService.java     # 网络服务接口
```

## 环境要求

在开始构建和运行项目之前，请确保您的开发环境满足以下要求：

- Android Studio 3.0 或更高版本
- JDK 1.8 或更高版本
- Android SDK 21（Android 5.0）及以上版本
- Gradle 4.x 或更高版本

项目使用 Gradle Wrapper 进行构建管理，确保团队成员使用一致的构建工具版本。gradle/wrapper 目录下的配置文件定义了项目所需的 Gradle 版本。

## 构建部署

获取项目源码后，请按照以下步骤进行构建：

**第一步** - 使用 Git 克隆或下载项目源码到本地目录。

**第二步** - 在 Android Studio 中选择 "Open" 选项，导航到项目根目录并打开。项目会自动同步 Gradle 依赖，如果同步失败，请检查网络连接或 Gradle 镜像配置。

**第三步** - 连接 Android 设备或启动模拟器，点击 Android Studio 的运行按钮进行编译和安装。首次构建可能需要下载较多依赖，请耐心等待。

**第四步** - 构建完成后，应用将自动安装到目标设备上。您可以在设备的应用列表中找到 "ERP" 图标并启动应用。

## 使用说明

首次启动应用后，用户将看到登录界面。在输入有效的用户名和密码后点击登录按钮，系统会验证凭据并跳转到业务数据展示页面。业务页面以列表形式展示数据记录，每行显示记录编号、时间和两个业务指标。返回键可退出当前页面或返回上一级界面。

## API 集成

应用通过 DBService 接口与后端服务器进行通信，使用 FebsResponse 统一封装 API 响应结果。如需对接新的后端服务，请确保服务器返回的数据格式与现有 FebsResponse 结构兼容，包含 code（状态码）、data（数据）和 message（消息）字段。

## 测试说明

项目包含基础测试用例用于验证核心功能：

- **单元测试** (`ExampleUnitTest.java`) - 验证基本计算逻辑的正确性
- **仪器测试** (`ExampleInstrumentedTest.java`) - 测试应用在真实设备上的运行表现

运行测试可在 Android Studio 中右键点击测试文件选择 "Run" 选项，或使用 Gradle 命令 `./gradlew test` 执行测试套件。

## 许可证

本项目遵循开源许可证协议，具体条款请查阅项目根目录下的 LICENSE 文件。