一款专为服装制造企业量身定制的 Android 移动端全流程业务管理应用。
本应用旨在解决中小型服装厂在订单管理、流水账核算、计件工资计算及月末薪资汇总方面的痛点。集成了订单跟踪、Ledger 账本、原材料采购、计件录入、工资周期管理及报表导出等核心功能，帮助企业实现生产与财务数据的实时一体化管理。
- 订单管理：支持款式（Style）、客户、订单的创建与关联，自动计算订单利润（订单应收总额 - 材料采购成本 - 计件人工成本 - 其他经营支出）。
- 账本 (Ledger)：记录日常收支、客户收款、供应商付款。支持按月查看、筛选业务类型，并自动关联客户/供应商余额。具备智能查重功能，防止重复录入。
- 采购管理：管理面料供应商及采购单据，支持按订单关联，生成统一凭证号（Voucher）。
- 计件录入：支持批量录入工人工作量，支持万分位单价精度（精确到 0.0001 元），自动计算工资金额。
- 智能辅助：支持从昨日数据一键复制录入，避免重复劳动；实时检测并提示重复录入。
- 工资周期：完整的月薪流程——预览汇总 -> 确认审核 -> 生成 PDF 工资单 -> 解锁重审。
- 工资单生成：自动生成符合 A4 打印规格的个人工资单及工厂汇总表（PDF），支持直接打印或分享。
- PDF 对账单：自动生成客户/供应商的往来对账单（Statement），支持查看、分享与打印。
- Excel 导出：按月导出六类 Excel 报表（收支明细 / 客户欠款 / 供应商待付款 / 订单利润 / 员工月工资 / 款号工序计件汇总），其中客户欠款、供应商待付款、订单利润三张时点表会标注"截至"日期。
- 审计追踪：核心业务操作（确认、删除、修改）均留有审计日志，记录操作前后状态。
- 安全备份：支持手动一键备份（首页备份卡片 / 设置页）与自动备份（每 24 小时一次，默认关闭，可在首次引导、首页备份卡片或设置页开启）；备份文件为
.glbackup格式（ZIP），可选 AES-GCM 加密；恢复前自动快照，失败自动回滚。另支持按年导出归档包（只导出所选年份业务数据 + 全量基础资料，不删除当前数据）。 - 应用锁：支持 PIN 码或生物识别锁，防止未授权访问；忘记 PIN 可凭有效备份文件验证后重置（不删数据）。
- 回收站：删除的记录会进入回收站（30天保留期），防止误删导致的数据丢失。
从纸质账、Excel 或其他记账软件切换过来时，按下面两步把旧数据带入本应用。
在对应列表页的「导入」按钮选择 CSV 或 Excel（.xlsx）文件即可；点旁边的「模板」可下载带表头的 CSV 模板，按列顺序填写：
| 数据 | 入口 | 模板列（按顺序） |
|---|---|---|
| 客户 | 账本页「客户」标签 | 客户名称,联系人,电话,地址,期初欠款(元) |
| 供应商 | 账本页「供应商」标签 | 供应商名称,联系人,电话,主要供应材料,期初待付款(元) |
| 员工 | 计件页「员工」标签 | 员工姓名,工种或班组,手机号,入职日期(YYYY-MM-DD),状态(在职/离职) |
| 款号 | 订单页「款号管理」 | 客户名称,款号,款式名 |
| 工序 | 订单页「款号管理」 | 客户名称,款号,工序名称,工序单价(元) |
- 导入有先后依赖：款号的"客户"列要求客户已导入，工序的"款号"列要求款号已导入。建议顺序：客户 → 供应商 → 员工 → 款号 → 工序。
- 主数据导入为"要么全成、要么不写"：任何一行有错（名称/款号重复、引用的客户或款号不存在、金额或日期格式不对）会按行号列出原因，整批不写入，改好重导即可。
- 工序单价最多四位小数（精确到 0.0001 元）；期初列支持负数（客户负数=预付，供应商负数=已预付）。
- 入口：账本页「流水」标签，搜索框旁「导入」。
- 列顺序：
日期(YYYY-MM-DD),类型,金额(元),客户或供应商,款号(仅客户收款可填),付款方式,备注 - 类型：收入 / 支出 / 客户收款 / 客户退款 / 供应商付款 / 供应商退款；付款方式：现金 / 微信 / 支付宝 / 银行卡 / 其他。
- 与手工记账同一套校验与查重：有效行逐条入账，重复行自动跳过，错误行按行号报告且不影响其他行；修正文件后可安全重导，不会重复入账。
- CSV 建议保存为 UTF-8 编码（用应用内「模板」生成的文件自带 BOM，Excel 直接打开不乱码）；GBK 编码的文件也能自动识别。
- Excel 工作簿（.xlsx）可直接导入：只读取第一个工作表，按列顺序取值（与 CSV 相同），金额/日期单元格的数值会自动转成文本与
YYYY-MM-DD。若用 Excel 编辑模板 CSV，另存为.xlsx或直接导入 CSV 都可以。 - 首行表头可保留，导入时按列名自动跳过。
- 建账向导：首次启动的"三步建账"向导中，直接录入现金/微信/支付宝/银行卡四个资金账户的期初余额（可留空跳过）；之后可在账本页「账户」标签中随时修改每个账户的期初余额。
- 主数据期初列：客户欠款、供应商待付款的期初，在新建/编辑客户或供应商时填写「期初欠款」「期初待付款」（也可随 CSV 的期初列一并导入），期初值会自动并入欠款/待付余额；修改已有记录的期初值需二次确认。
本项目采用 Clean Architecture (清晰架构) 设计原则，并结合 MVVM 模式构建。
- UI 层 (Presentation): 使用 Jetpack Compose 构建现代化的声明式界面，遵循 Material 3 设计规范。
- 领域层 (Domain): 包含核心业务实体（Entity）、业务规则及 Use Case（用例），实现业务逻辑与 UI 的解耦。
- 数据层 (Data): 基于 Room 数据库进行本地持久化。使用 Repository 模式封装数据访问逻辑。
- 异步处理: 全面采用 Kotlin Coroutines 与 Flow，保证 UI 线程流畅且支持响应式更新。
- 依赖注入: 使用轻量级手动容器 (
AppContainer) 管理全局依赖。
domain/usecase: 核心业务逻辑（如：计算订单利润、保存计件批量数据、确认工资周期）。data/local: Room 数据库定义、DAO 及数据映射（Entities, DAOs）。feature: 按业务模块划分的 UI 界面与 ViewModel（Home, Ledger, Order, Piecework, Salary, Settings）。report: 专用于 PDF 渲染引擎（使用android.graphics.pdf）与 Excel 导出服务。backup: 数据备份与恢复模块，包含加密与文件处理逻辑。
- Android Studio: 建议使用 Hedgehog (2023.1.1) 或更高版本。
- JDK: 17 或更高版本。
- Android SDK: 包含 API 26 (Android 8.0) 以上平台的构建工具。
- 克隆本仓库。
- 使用 Android Studio 打开项目，或在终端执行：
./gradlew assembleDebug
- 生成的 APK 文件位于
app/build/outputs/apk/debug/目录。
项目包含全面的自动化测试，以确保业务逻辑的准确性和系统的稳定性。
- 单元测试 (Unit Tests): 覆盖核心计算逻辑（金额运算、工价计算、余额汇总、CSV 解析等）。
- 集成测试 (Integration Tests): 测试数据库迁移（Migration）、数据一致性及多表事务。
- UI 测试 (Instrumented Tests): 使用 Jetpack Compose 测试框架，验证核心业务流程（如下单、录入计件、确认工资、恢复备份）的端到端正确性。
本项目基于 Apache License 2.0 开源。详情请参阅 LICENSE 文件。