Release-contractG

KO | EN

gitlite — search

#javascript #react #ai #golang #machine-learning #linux #java #windows #awesome #kubernetes #vue #security #mcp #ios

Release-contractG

(★ 35)

小微企业适用，报价单和合同生成工具，支持签章和图片式PDF，一分钟生成合同和报价单

Release-contractG 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 合同生成工具 (contractG)

![版本](https://img.shields.io/badge/版本-1.1.0-blue)
![Python](https://img.shields.io/badge/Python-3.10%20~%203.12-green)
![许可证](https://img.shields.io/badge/许可证-MIT-orange)

> **一分钟生成专业合同和报价单，让销售工作更高效！**

## ✨ 核心功能

- **📝 一键生成合同** - 选择客户和商品，自动生成专业销售合同
- **💰 智能报价单** - 自动计算金额，生成美观报价单
- **🔄 Excel转PDF** - 拖放式转换，支持添加公司印章
- **📄 模板管理** - 合同/报价模板导入、导出参考、设默认、删除
- **👥 客户管理** - 完整客户信息库，快速检索
- **📦 商品管理** - 灵活的商品目录，价格管理
- **🏢 多公司支持** - 管理多个公司主体，一键切换

## 🚀 快速开始

### Windows（打包版）

1. 双击`start_contractG.bat`（或直接运行`contractG.exe`）
2. 配置您的公司信息和印章
3. 添加客户和商品信息
4. 切换到"合同生成"标签页
5. 选择客户、添加商品、设置合同信息
6. 点击"生成合同"按钮
7. 完成！合同和报价单已生成

### macOS / Linux（从源代码运行）

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 src/launcher.py
```

macOS 也可以使用一键启动脚本（双击运行）：
```bash
chmod +x run.command
```
然后在 Finder 里双击 `run.command`。

### macOS（打包成 .app / .dmg）

```bash
chmod +x scripts/build_macos_dmg.sh
PYTHON_BIN=python3.12 scripts/build_macos_dmg.sh
```

产物在 `dist/contractG.app` 与 `dist/contractG.dmg`。

如需使用“Excel 转 PDF”：
- Windows：依赖本机安装的 Microsoft Excel（通过 COM 导出）
- macOS / Linux：需要安装 LibreOffice，并确保 `soffice` 可用（程序会自动调用它完成转换）

## 📋 详细功能

<details>
<summary>合同生成系统 (点击展开)</summary>

- ✅ 自动计算合同金额（含技术服务费）
- ✅ 自定义合同编号、签订日期、交货时间（文本）
- ✅ 灵活的付款方式设置
- ✅ 支持合同/报价模板（可导入多套模板并按类型选择）
- ✅ 一键转换为PDF并添加公司印章
- ✅ 支持图片式PDF转换，提高兼容性
</details>

<details>
<summary>Excel转PDF工具 (点击展开)</summary>

- ✅ 拖放式文件转换，操作简单直观
- ✅ 图片式PDF转换选项，确保跨平台兼容性
- ✅ 实时转换进度显示
- ✅ 转换完成后一键打开文件
</details>

<details>
<summary>客户与商品管理 (点击展开)</summary>

- ✅ 添加、编辑、删除客户和商品信息
- ✅ 完整的客户资料管理（公司名称、联系人、电话、地址、银行账户等）
- ✅ 详细的商品信息记录（名称、规格型号、单位、单价等）
- ✅ 智能搜索与筛选功能
</details>

<details>
<summary>公司信息管理 (点击展开)</summary>

- ✅ 多公司信息管理，支持切换不同乙方主体
- ✅ 公司印章上传与管理
- ✅ 智能解析导入公司信息
</details>

## 💻 系统要求

- **操作系统**: Windows 7/8/10/11（打包版）；macOS / Linux（从源代码运行）
- **内存**: 最低2GB RAM
- **存储空间**: 至少200MB可用空间

## ❓ 常见问题

<details>
<summary>程序无法启动怎么办？</summary>

- 确保系统满足最低配置要求 
- 尝试以管理员身份运行程序 
- 查看logs目录下的日志文件

</details>

<details>
<summary>如何修改合同模板？</summary>

- 菜单进入：设置 → 模板管理 
- 先点“导出内置默认”，会在 templates 目录生成：合同模板参考.xlsx / 报价单模板参考.xlsx 
- 在 Excel 里修改版式后，用“导入模板”导入（导入时可勾选“设为默认模板”） 
- 回到“合同生成”页：按“合同/报价单”切换类型后，在“模板”下拉框选择对应模板 
- 多商品明细推荐在模板行放置 {{ITEMS_START}}，并使用 {{商品名称}} / {{数量}} / {{单价}} / {{金额}} 等占位符

</details>

<details>
<summary>如何备份数据？</summary>

- 复制data目录下的customers.xlsx和products.xlsx文件 
- 同时备份config目录下的配置文件

</details>

## 📝 版本历史

### v1.1.0
- 📄 新增模板管理：导出参考模板、导入模板、设默认、删除
- 🧾 合同与报价统一明确“报价为含税价”
- 🕒 交货时间改为文本输入，避免语义重复

## ⚙️ 配置说明

### 配置文件位置

程序的配置文件存储在以下位置：
- `config/company.json`: 公司信息配置
- `config/settings.ini`: 系统设置配置

### 配置文件详解

#### company.json
公司信息为列表结构（每个元素一家公司）：
```json
[
  {
    "name": "示例公司名称",
    "contact": "联系人",
    "phone": "13800138000",
    "address": "公司地址",
    "bank_name": "开户银行",
    "bank_account": "银行账号",
    "tax_id": "税号",
    "is_default": true
  }
]
```

#### settings.ini
```ini
[General]
output_dir = output

[Templates]
# 多模板列表：显示名::相对路径，多项用 ; 或 , 分隔
contract_templates = 标准版::templates/contract_standard.xlsx; 外贸版::templates/contract_export.xlsx
quote_templates = 标准版::templates/quote_standard.xlsx; 外贸版::templates/quote_export.xlsx

# 默认模板（可选，不填则使用列表第一项；也可在“设置 → 模板管理”里设定）
contract_template_default = 标准版
quote_template_default = 标准版
```

## 📄 模板说明

### 模板管理（导入/导出/删除）
- 菜单：**设置 → 模板管理**
- 支持：
  - 导出“内置默认版式”为参考模板：`templates/合同模板参考.xlsx` / `templates/报价单模板参考.xlsx`
  - 导入 xlsx 到 `templates/` 并写入 `config/settings.ini`（文件选择默认打开 templates 目录）
  - 设为默认模板
  - 删除已导入模板（从列表移除；若模板文件未被其他条目引用，会同时删除文件）

### 明细行扩展（多商品）
- 推荐：在商品明细“模板行”的任意单元格写入 `{{ITEMS_START}}`，同一行其它列用 `{{商品名称}}` / `{{规格型号}}` / `{{单位}}` / `{{数量}}` / `{{单价}}` / `{{金额}}` / `{{备注}}`。
- 兼容：即使模板未放置 `{{...}}` 占位符，系统也会尝试根据表头（序号/商品名称/规格型号/单位/数量/单价(元)/金额(元)/备注）自动扩展多行。

## 📁 文件结构

```
.
├── config/                # 配置文件目录
│   ├── company.json       # 公司信息配置
│   └── settings.ini       # 系统设置配置
├── data/                  # 数据文件目录
│   ├── customers.xlsx     # 客户数据
│   └── products.xlsx      # 商品数据
├── logs/                  # 日志文件目录
├── output/                # 输出文件目录（生成的合同和报价单）
├── resources/             # 资源文件目录
│   └── icon.ico           # 应用程序图标
├── src/                   # 源代码目录
├── templates/             # 模板文件目录
├── README.md              # 说明文档
├── requirements.txt       # 依赖包列表
├── run.command            # macOS 一键启动脚本
└── start_contractG.bat    # Windows 启动脚本
```

## 📄 许可证

本项目采用 MIT 许可证。

---

Release-contractG

Release-contractG 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Release-contractG

Release-contractG 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README