# app

**Repository Path**: lzhsus/app

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# bd_data_uploader

## 项目核心功能

这是一个基于 Electron 的离线桌面应用，核心目标是让客户在本地完成数据整理、报告生成、记录管理和上传相关操作。

## 前端核心功能

- 登录页
  - 提供预设账号密码登录入口。
- 首页 / 仪表页
  - 作为系统进入后的主入口和功能承接页。
- 数据创建页
  - 填写业务数据。
  - 导入 Excel / 文件类数据。
  - 生成 PDF 报告。
- 数据列表页
  - 展示本地记录列表。
  - 支持分页、搜索、删除等基础管理操作。
- 公共界面能力
  - 路由管理。
  - 窗口状态交互。
  - 上传状态、网络状态、用户状态等前端状态管理。

## 后端核心功能

- Electron 主进程
  - 创建主窗口。
  - 管理应用生命周期。
  - 负责前后端 IPC 通信。
- 登录鉴权
  - 使用预设账号进行离线登录校验。
  - 密码采用加密哈希方式存储和比对。
- 本地数据库
  - 基于本地 SQLite 持久化业务数据。
  - 负责数据新增、分页查询、搜索、更新、删除。
- 报告与文档处理
  - 支持 PDF 生成。
  - 支持文件选择与 Excel 导入。
- 上传集成
  - 对接 OSS 上传。
  - 支持断点续传、上传记录保存、上传取消。
- 数据备份
  - 支持本地数据库备份。
  - 支持备份目录选择与存储信息读取。

## 模块划分大纲

### 前端

- `renderer/src/pages`
  - 页面层，承载登录、创建、列表、首页等功能。
- `renderer/src/components`
  - 公共组件，如窗口更新、备份、页面布局等。
- `renderer/src/router`
  - 路由与页面访问控制。
- `renderer/src/stores`
  - 前端状态管理。
- `renderer/src/utils`
  - Electron 通信、上传管理、查询工具等公共能力。

### 后端

- `main/windows`
  - 主窗口创建与窗口事件管理。
- `main/bootstrap`
  - IPC 注册与主进程启动连接。
- `main/modules/database`
  - 登录模块、业务数据模块、备份日志模块。
- `main/modules/documents`
  - PDF、文件、Excel 处理能力。
- `main/modules/backup`
  - 本地数据库备份能力。
- `main/integrations`
  - 外部服务集成，如 OSS 上传、业务接口扩展。

## 一句话总结

这个项目本质上是一个“离线数据处理 + 本地存储 + 报告生成 + 上传辅助”的 Electron 桌面工具，前端负责操作界面，后端负责本地数据、文件处理、上传与备份。

C:\Users\Intone\Documents\TBNK软件数据备份