# Fic信息管理

**Repository Path**: banfoguan/ficinfo

## Basic Information

- **Project Name**: Fic信息管理
- **Description**: 工作记录、记录、查询、生成报告
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-16
- **Last Updated**: 2026-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 工商联更新记录统计系统

一个现代化的全栈 Web 应用，用于记录和统计工商联网站各部室栏目的更新情况。

## 技术栈

### 后端
- **FastAPI** - 现代化 Python Web 框架
- **SQLAlchemy** - ORM 数据库操作
- **SQLite** - 轻量级数据库
- **JWT** - 用户认证
- **Pydantic** - 数据验证

### 前端
- **React 19** - UI 框架
- **TypeScript** - 类型安全
- **TailwindCSS** - 样式框架
- **React Router** - 路由管理
- **TanStack Query** - 数据获取和缓存
- **Axios** - HTTP 客户端
- **Lucide React** - 图标库

## 功能特性

- ✅ 用户认证和权限管理（管理员/成员）
- ✅ 部室和栏目管理
- ✅ 更新记录录入（支持选择日期）
- ✅ 记录列表查看和筛选
- ✅ 统计查询（按部室、按栏目、共享栏目）
- ✅ 深浅主题模式切换
- ✅ 响应式设计
- ✅ 现代化动画效果

## 快速开始

### 1. 后端启动

```powershell
# 进入后端目录
cd backend

# 创建虚拟环境
python -m venv venv
.\venv\Scripts\Activate.ps1

# 安装依赖
pip install -r requirements.txt

# 初始化数据库
python init_db.py

# 启动服务
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

后端服务运行在: http://localhost:8000
API 文档: http://localhost:8000/docs

**默认管理员账户：**
- 用户名: `admin`
- 密码: `admin123`

### 2. 前端启动

```powershell
# 进入前端目录
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端应用运行在: http://localhost:5173

## 项目结构

```
工商联更新记录及统计/
├── backend/                 # 后端项目
│   ├── app/
│   │   ├── routers/        # API 路由
│   │   ├── models.py       # 数据库模型
│   │   ├── schemas.py      # Pydantic 模型
│   │   ├── auth.py         # 认证逻辑
│   │   ├── database.py     # 数据库配置
│   │   └── main.py         # 应用入口
│   ├── init_db.py          # 数据库初始化脚本
│   ├── requirements.txt    # Python 依赖
│   └── README.md
│
├── frontend/               # 前端项目
│   ├── src/
│   │   ├── components/    # UI 组件
│   │   ├── lib/           # 工具库（API、认证、主题）
│   │   ├── pages/         # 页面组件
│   │   ├── App.tsx        # 应用根组件
│   │   └── main.tsx       # 入口文件
│   ├── package.json       # Node 依赖
│   └── README.md
│
└── docs/                  # 文档
    ├── 需求.txt
    └── 数据库设计.md
```

## 数据库设计

系统包含以下核心表：

1. **users** - 用户表（管理员和成员）
2. **departments** - 部室表（6个部室）
3. **columns** - 栏目表（支持共享栏目如"通知公告"）
4. **user_departments** - 用户-部室关联表
5. **update_records** - 更新记录表

详细设计请查看 `docs/数据库设计.md`

## 使用说明

### 管理员功能
- 查看所有数据
- 管理用户、部室、栏目
- 进行统计查询
- 导出数据报表

### 成员功能
- 录入自己负责部室的更新记录
- 查看自己的历史记录
- 修改自己录入的记录

### 录入流程
1. 登录系统
2. 选择"录入记录"
3. 选择部室和栏目
4. 选择日期（默认当天，可选其他日期）
5. 输入更新条数
6. 可选填写备注
7. 保存记录

### 统计查询
1. 选择时间段（开始日期-结束日期）
2. 点击"查询统计"
3. 查看以下统计结果：
   - 共享栏目统计（如通知公告总和）
   - 按部室统计
   - 按栏目详细统计

## 注意事项

1. **首次使用**：请立即修改默认管理员密码
2. **数据备份**：定期备份 `backend/gsl_records.db` 数据库文件
3. **生产部署**：修改 `backend/.env` 中的 `SECRET_KEY`
4. **端口冲突**：确保 8000（后端）和 5173（前端）端口未被占用

## 开发说明

### 添加新的 API 端点
1. 在 `backend/app/routers/` 创建或修改路由文件
2. 在 `backend/app/schemas.py` 添加数据模型
3. 在 `frontend/src/lib/api.ts` 添加 API 调用函数

### 添加新页面
1. 在 `frontend/src/pages/` 创建页面组件
2. 在 `frontend/src/pages/Dashboard.tsx` 添加路由

## 许可证

MIT License

## 联系方式

如有问题或建议，请联系项目负责人。