# 智捷ERP (SmartJet ERP) 操作手册

智捷ERP 是一款基于 Django 1.10.6 深度定制的企业资源计划 (ERP) 管理软件。系统经过现代 UI 重构与 Docker 化部署优化，提供销售管理、采购管理、库存管理、组织架构、人力资源及自动化工作流审批等核心功能。

![image-20260610135601841](images/image-20260610135601841.png)

---

## 1. 快速开始

### 1.1 环境要求
- Docker
- Docker Compose

### 1.2 一键部署
在项目根目录下执行以下命令，即可启动 Web 服务与 MySQL 数据库：

```bash
docker compose -f docker-compose.full.yml up -d --build
```

### 1.3 访问地址
- **后台管理**: [http://localhost:6010/admin/](http://localhost:6010/admin/)
- **数据库服务**: `localhost:6011` (容器内 3306)

### 1.4 默认账号
系统预置了管理员账号用于演示：

| 角色 | 用户名 | 密码 | 说明 |
|------|--------|------|------|
| 超级管理员 | xinmi_admin | admin123456 | 全新创建的超级用户，建议首选使用 |

---

## 2. 核心功能模块

智捷ERP 采用现代化的“侧边栏 + 高密度工作台”布局，确保业务数据直观可见。

![image-20260610135614258](images/image-20260610135614258.png)

### 2.1 仪表盘 (Dashboard)
**路径**: `/admin/`
**功能概述**: 实时展现企业核心经营指标。
- **数据看板**: 销售总额、待办审批、库存预警、系统在线率。
- **趋势分析**: 关键指标下方的 Sparkline 动态折线图。
- **快捷操作**: 一键新建销售单、采购入库、员工入职。

### 2.2 核心业务
- **销售管理**: `/admin/sale/saleorder/` —— 涵盖报价单、销售订单、收款计划跟踪。
- **采购管理**: `/admin/purchase/purchaseorder/` —— 支持采购申请、订单审批、入库确认。
- **库存管理**: `/admin/invent/inventory/` —— 实时盘点、低水位报警、批次溯源。

![image-20260610135625703](images/image-20260610135625703.png)

![image-20260610135636514](images/image-20260610135636514.png)

![image-20260610135644978](images/image-20260610135644978.png)

![image-20260610135653450](images/image-20260610135653450.png)

![image-20260610135704180](images/image-20260610135704180.png)



![image-20260610135711248](images/image-20260610135711248.png)



### 2.3 组织与人力
- **组织架构**: `/admin/organ/organization/` —— 维护企业多级部门与岗位树。
- **员工档案**: `/admin/basedata/employee/` —— 员工全生命周期管理、五险一金基础配置。

![image-20260610135719363](images/image-20260610135719363.png)

![image-20260610135727597](images/image-20260610135727597.png)

![image-20260610135737510](images/image-20260610135737510.png)

### 2.4 流程协同
- **审批中心**: `/admin/workflow/instance/` —— 流程实例监控。

- **待办任务**: `/admin/workflow/todolist/` —— 个人审批任务列表，支持紧急程度分级。

  ![image-20260610135747819](images/image-20260610135747819.png)

  ![image-20260610135757306](images/image-20260610135757306.png)

  

  

---

## 3. 视觉与体验优化 (Next-Gen UI 4.0)

本项目已完成 1:1 高保真 UI 复刻，具有以下设计特征：
- **高级配色**: 采用 Indigo & Slate 商务配色。
- **极致紧凑**: Ultra-Compact 模式，单屏展示数据量提升 40% 以上。
- **响应式布局**: 侧边栏固定，超宽表格自动开启内部横向滚动保护。

---

## 4. 技术维护

### 4.1 数据库初始化
数据库初始化 SQL 位于 `Install/SQL/mis.sql`，Docker 启动时会自动挂载并执行。

### 4.2 静态资源更新
若修改了 CSS 或 JS，请在容器内执行：
```bash
docker compose exec web python manage.py collectstatic --noinput
```

---

## 5. 常见问题 (FAQ)

**Q: 登录时提示“请输入正确的用户名和密码”？**
A: 可能是由于默认加密算法版本差异，请通过控制台重置：
`docker compose exec web python manage.py changepassword admin`

**Q: 列表页面字段太多，显示超宽？**
A: 系统已开启横向滚动条保护，您可以在表格区域内左右滑动查看完整数据。

---

© 2026 智捷ERP (SmartJet ERP) · 让企业管理更智能
