# app-report

**Repository Path**: zdyumath/app-report

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-02
- **Last Updated**: 2025-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目功能介绍

本项目是一个基于 Flask 后端与 React 前端的财务数据处理系统，主要功能包括：
1. **凭证上传**：支持手动上传 Excel 文件（.xlsx 和 .xlsm 格式）或自动从财务核心系统下载凭证数据。
2. **科目字典表导入**：支持手动上传或自动从财务核心系统下载科目字典表。
3. **项目年初余额表导入**：支持手动上传或自动从财务核心系统下载项目余额表。
4. **报表配置管理**：支持型号与核算项目编号关系的配置文件上传、费用与核算科目编号关系的配置文件上传。
5. **报表生成**：支持型号型号收支余报表及其明细数据报表的生成与下载。
6. **数据查询**：提供按凭证时间、摘要、费用科目、型号项目等条件的凭证明细查询、单张凭证预览的功能。
7. **系统配置**：支持对系统配置进行查询和修改。

---

# 技术架构

- **后端**：
  - 框架：Flask
  - 数据库：DuckDB（嵌入式数据库）
  - 跨域支持：Flask-CORS
  - 其他依赖：Playwright（用于自动化操作）、Pandas（数据处理）
- **前端**：
  - 框架：React + Ant Design
  - 状态管理：Redux
  - 请求工具：Axios
  - 文件上传：Ant Design Upload 组件
- **接口通信**：RESTful API，前后端通过 JSON 数据格式交互。
- **部署环境**：Python 3.8+，Node.js 12+。

---

# 接口介绍
节选
## 凭证上传相关接口
- **上传文件**：
  - URL: `/file_upload/upload`
  - Method: POST
  - 参数：文件（支持多文件上传）
  - 返回：上传结果及解析状态
- **获取配置**：
  - URL: `/pzsc/config`
  - Method: GET
  - 返回：凭证上传相关配置信息

## 数据管理相关接口
- **分页查询**：
  - URL: `/nw_project/api/pagedata`
  - Method: POST
  - 参数：分页参数（pageNum, pageSize）、查询条件
  - 返回：分页数据及总数
- **清空数据**：
  - URL: `/nw_project/clear`
  - Method: POST
  - 返回：清空结果

## 自动化接口
- **自动登录并下载数据**：
  - URL: `/rpa/auto_download`
  - Method: POST
  - 参数：开始日期、结束日期
  - 返回：下载状态及数据

---

# 部署要求

1. **操作系统**：Windows/Linux/macOS
2. **Python 环境**：
   - 安装 Python 3.7+
   - 安装依赖：`pip install -r requirements.txt`
3. **Node.js 环境**：
   - 安装 Node.js 16+
   - 安装依赖：`npm install`
4. **数据库**：
   - 使用 DuckDB，无需额外安装数据库服务。
5. 详细安装步骤请参考项目文档doc/安装部署.md

# 启动步骤
1. **后端启动**：
   ```bash
   cd backend
   python app.py
2. **前端独立启动**：
   ```bash
   cd frontend
   npm run start
3. **前端打包**：
   ```bash
   cd frontend
   npm run build