feat: 学生信息管理系统开发完成
- 完成学生信息管理核心功能开发 - 新增学生信息采集批次管理功能 - 完成班干部管理模块开发 - 修复物业报修模块附件上传逻辑 - 完善数据库表结构和权限配置 - 更新API文档和变更记录 - 优化前端页面交互体验 详细变更记录见: - docs/变更管理/code-adjust-record-2025-01-13-wuzhen.md - docs/变更管理/code-adjust-record-2025-07-11-wuzilong.md - docs/变更管理/code-adjust-record-2025-07-12-wuzhen.md
This commit is contained in:
commit
8697b21b4d
237 files changed
+35787
-2878
No files matched your search
+29
-18
@@ -1,39 +1,48 @@
|
||||
# 财务管理模块 - API接口
|
||||
|
||||
## 📋 模块说明
|
||||
|
||||
- **模块名称**: 财务管理 (Financial Management)
|
||||
- **模块简称**: cw
|
||||
- **对应后端**: backend/ruoyi-modules/ruoyi-cw/
|
||||
- **对应前端**: web/src/views/cw/
|
||||
|
||||
## 📁 目录结构
|
||||
|
||||
此目录用于存放财务管理模块的所有API接口定义,建议按功能模块细分:
|
||||
|
||||
### 💰 会计核算 (accounting/)
|
||||
|
||||
- `accounting/index.ts` - 会计核算相关API
|
||||
- 科目管理、凭证管理、账簿管理
|
||||
|
||||
### 📊 预算管理 (budget/)
|
||||
|
||||
- `budget/index.ts` - 预算管理API
|
||||
- 预算编制、预算执行、预算分析
|
||||
|
||||
### 💳 资产管理 (asset/)
|
||||
|
||||
- `asset/index.ts` - 资产管理API
|
||||
- 固定资产、流动资产、资产盘点
|
||||
|
||||
### 💸 费用管理 (expense/)
|
||||
|
||||
- `expense/index.ts` - 费用管理API
|
||||
- 费用申请、费用审批、费用报销
|
||||
|
||||
### 📈 财务报表 (report/)
|
||||
|
||||
- `report/index.ts` - 财务报表API
|
||||
- 资产负债表、损益表、现金流量表
|
||||
|
||||
### 📊 统计分析 (statistics/)
|
||||
|
||||
- `statistics/index.ts` - 财务统计分析API
|
||||
- 财务数据分析、成本分析、收支统计
|
||||
|
||||
## 🎯 API规范
|
||||
|
||||
- 统一使用TypeScript定义接口类型
|
||||
- 请求路径前缀:`/cw/`
|
||||
- 权限编码格式:`cw:功能:操作`
|
||||
@@ -41,28 +50,29 @@
|
||||
- 金额字段统一使用number类型,保留2位小数
|
||||
|
||||
## 📝 接口示例
|
||||
|
||||
```typescript
|
||||
// 预算查询接口
|
||||
export interface BudgetQuery {
|
||||
pageNum?: number
|
||||
pageSize?: number
|
||||
budgetName?: string
|
||||
budgetType?: string
|
||||
fiscalYear?: number
|
||||
status?: string
|
||||
pageNum?: number;
|
||||
pageSize?: number;
|
||||
budgetName?: string;
|
||||
budgetType?: string;
|
||||
fiscalYear?: number;
|
||||
status?: string;
|
||||
}
|
||||
|
||||
export interface BudgetVO {
|
||||
id: number
|
||||
budgetName: string
|
||||
budgetCode: string
|
||||
budgetType: string
|
||||
fiscalYear: number
|
||||
totalAmount: number
|
||||
usedAmount: number
|
||||
remainingAmount: number
|
||||
status: string
|
||||
createTime: string
|
||||
id: number;
|
||||
budgetName: string;
|
||||
budgetCode: string;
|
||||
budgetType: string;
|
||||
fiscalYear: number;
|
||||
totalAmount: number;
|
||||
usedAmount: number;
|
||||
remainingAmount: number;
|
||||
status: string;
|
||||
createTime: string;
|
||||
}
|
||||
|
||||
// 获取预算列表
|
||||
@@ -71,13 +81,14 @@ export function listBudget(query: BudgetQuery) {
|
||||
url: '/cw/budget/list',
|
||||
method: 'get',
|
||||
params: query
|
||||
})
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
## 📝 注意事项
|
||||
|
||||
- 所有接口类型定义需要与后端VO对象保持一致
|
||||
- 分页查询统一使用TableDataInfo响应格式
|
||||
- 非分页接口使用R类型响应格式
|
||||
- 财务数据要特别注意精度和安全性
|
||||
- 金额计算避免使用浮点数运算
|
||||
- 金额计算避免使用浮点数运算
|
||||
@@ -4,7 +4,7 @@
|
||||
* @date 2025-01-23
|
||||
*/
|
||||
|
||||
import request from '@/utils/request'
|
||||
import request from '@/utils/request';
|
||||
|
||||
// 此处导出财务管理模块相关的所有API接口
|
||||
// 示例:
|
||||
@@ -15,4 +15,4 @@ import request from '@/utils/request'
|
||||
// export * from './report' // 财务报表
|
||||
|
||||
// 临时导出一个空对象,防止编译错误
|
||||
export default {}
|
||||
export default {};
|
||||
Reference in new issue
Block a user