bitsandbots/inventory
GitHub: bitsandbots/inventory
一款轻量级自托管库存管理系统,提供销售订单、发票、拣货单和报表功能,适合离线环境和小型团队快速部署使用。
Stars: 67 | Forks: 23
# 库存管理系统
带有发票、拣货单和销售报告的库存管理系统。
**源码**:https://github.com/bitsandbots/inventory
面向 Raspberry Pi 或任何 Apache + MySQL 主机自托管部署的 PHP 8.x + MariaDB 应用程序。离线优先(无 CDN 依赖)。三角色访问控制:Admin / Supervisor / User。
## 快速开始
```
bash install.sh
```
安装程序会检测 PHP、MySQL 和 Apache,使用 `schema.sql` 创建数据库,生成包含高强度 `APP_SECRET` 的 `.env` 文件,创建最小权限的 MySQL 应用用户,并在 8080 端口配置 Apache 虚拟主机。
若要清除现有部署并全新重装:
```
bash install.sh --reinstall
```
有关手动安装、故障排除、基于角色的操作流程以及日常运维,请参阅 **[docs/setup-and-usage.md](docs/setup-and-usage.md)**。
### 开发者钩子(可选)
要在每次提交前对暂存的 PHP 文件运行 `php -l`(与 CI 运行的检查相同):
```
bash scripts/install-hooks.sh
```
这会将 `core.hooksPath` 指向被跟踪的 `.githooks/` 目录。如果需要忽略解析错误进行提交,可以使用 `git commit --no-verify` 跳过此检查。
## 默认账户
默认密码已在 `schema.sql` 中初始化,**首次登录后必须修改**。
| 角色 | 用户名 | 密码 |
|---|---|---|
| Admin | `admin` | `admin` |
| Supervisor | `special` | `special` |
| User | `user` | `user` |
## 文档
| 文档 | 目标读者 |
|---|---|
| [安装与使用](docs/setup-and-usage.md) | 运维人员 — 安装、日常工作流、故障排除 |
| [系统架构](docs/architecture.md) | 开发者 — 目录结构、请求生命周期、RBAC 模型、数据库模式 |
| [技术栈](docs/tech-stack.md) | 开发者 — 运行时版本、安全特性、部署目标 |
| [API 与组件](docs/api-components.md) | 开发者 — 类方法、查询辅助工具、CSRF 辅助工具 |
| [差距分析](docs/gap-analysis.md) | 维护者 — 已知问题、近期修复、后续步骤 |
独立的单文件离线参考文档:**[Blueprint_Overview.html](Blueprint_Overview.html)**
## 支持
[联系我们](https://coreconduit.com/contact/) — [赞助捐赠](https://www.paypal.com/biz/fund?id=ZDR2NTBSKK7JE)
标签:Apache, CISA项目, ERP, ffuf, LangChain, MariaDB, PHP 8, Raspberry Pi, RBAC, Streamlit, 内存执行, 发票, 库存管理系统, 开源, 报表, 拣货单, 无CDN依赖, 离线优先, 私有化部署, 自托管, 访问控制, 轻量级, 进销存系统, 销售订单, 防御规避