README

开源技术支持和电子发票管理软件。

网站 · 文档 · 论坛

OpenSTAManager是一款开源的基于Web的管理软件，由意大利Este的DevCode公司开发，用于管理技术支持和相关电子发票。项目名称取自其主要组件的部分英文名称翻译：开源和其作为技术支持管理器的目标。

管理软件通常指企业内部自动化管理流程的应用程序，属于特定行业的特定类别，专注于以下领域：

会计管理；
库存管理；
生产和辅助；
企业预算管理和预测；
财务管理和分析。

根据这个定义，OpenSTAManager在内部综合了会计和库存管理的特性功能，同时还提供了较为先进的模块，旨在补充针对相关实际工作中的技术支持活动的企业活动。

官方文档可在https://docs.openstamanager.com/找到。

要求
安装
为什么是开源软件
社区
贡献
开发者
许可

软件要求

安装管理软件需要一台安装了DBMS MySQL和编程语言PHP的Web服务器。

❗从2.5版本开始的一些依赖项不再与PHP 7.4和PHP 8.0兼容，因此从2.5.3版本开始将需要php >= 8.1。

有关更多信息，请访问文档中的安装部分。

硬件要求

最低要求

1个CPU
2GB RAM
200MB管理软件空间

推荐配置

2个CPU
4GB RAM
2GB管理软件空间

快速安装

git clone https://github.com/devcode-it/openstamanager.git
cd openstamanager

# Download di composer da https://getcomposer.org.cn/download/

yarn develop-OSM

安装

进行安装需要遵循以下步骤

下载项目官方版本.
在安装好的Web服务器根目录下创建一个文件夹（例如 openstamanager），并将下载的版本内容解压到该文件夹中。服务器根目录的路径根据所使用的软件而有所不同
- LAMP（《/var/www/html》
- XAMPP（Windows上为 C:/xampp/htdocs，Linux上为 /opt/lampp/htdocs/，MAC上为 /Applications/XAMPP/htdocs/）
- WAMP（《C:\wamp\www）
- MAMP（Windows上为 C:\MAMP\htdocs，MAC上为 /Applications/MAMP/htdocs）
创建一个空数据库（通过 PHPMyAdmin 或命令行）。
使用浏览器访问 https:///openstamanager。
输入数据库连接的配置信息。
点击安装按钮开始软件安装。

注意：安装可能需要一些时间。因此，建议在安装页面（特别是进度条）没有任何变化的情况下至少等待几分钟，然后再在论坛讨论或相关部分中寻找可能的解决方案。

版本

为了保持发布周期的透明度，我们遵循语义化版本控制（SemVer）指南来定义项目的版本。要查看所有可下载版本，请访问GitHub上的相关页面（对于2.3之前的版本，请访问SourceForge）。

如果您打算商业使用此程序，建议从项目官方网站下载可用的发布版本（https://www.openstamanager.com），避免直接使用代码仓库。如果您还需要专业支持和协助，可以在相关部分中请求。

构建

如果您直接从GitHub的代码仓库使用版本，需要从命令行执行以下命令来完成项目的PHP依赖（通过Composer）和资源（通过Yarn）。

php composer.phar install
yarn global add gulp
yarn install
gulp

作为上述命令序列的替代，可以使用以下命令（需要安装GIT和Yarn，并将composer.phar存档放入项目主目录）

yarn run develop-OSM

有关更多信息，请访问文档的资源和框架部分。

开发和调试工具

总结来说，要编译，需要安装以下工具

php >= 8.1，并包含扩展
- php-curl
- php-dom
- php-intl
- php-json
- php-xml
- php-mbstring
- php-pdo
- php-xml
- php-xsl
- php-zip
composer v2: https://getcomposer.org.cn/download/
nodejs >= 16: https://node.org.cn/en/learn/getting-started/how-to-install-nodejs
yarn v 1.22: https://yarn-classic.npmjs.net.cn/en/docs/install
gulp v4: https://gulp.node.org.cn/docs/en/getting-started/quick-start/#install-the-gulp-command-line-utility

建议安装psalm并在支持的IDE中配置它，以便对编写的代码执行额外的自动检查。

已经在composer中配置了PHP-CS-Fixer的包含，这是一个允许以统一方式格式化编写的代码的工具。如果支持，可以在IDE中配置。可执行文件的路径是vendor/bin/php-cs-fixer。

为什么是开源软件

该项目是开源软件，因为它允许用户研究其功能并根据自己的需求进行适配；此外，在商业领域，它不会强制用户绑定到同一供应商的辅助服务。

通过这种方式，可以获得对软件运行的额外保证，因为任何具备能力的人都可以进行验证，从而排除了与数据安全和隐私相关的问题（这是商业软件无法提供的特性）。

社区

社区是一个开源项目中非常重要的组成部分，因为它将用户和开发者联系起来，从而可以识别出创新和更好的解决方案。

我们活跃在Facebook、Instagram、Twitter、YouTube、Telegram和Mastodon上，我们的官方论坛可在https://forum.openstamanager.com找到，您可以在合适的版块中报告问题并满足您的疑问。

贡献

为了能够贡献并执行自动测试，建议您遵循官方文档中描述的指示。

如果您想通过简单的改进或修复来积极贡献，可以在新贡献者问题中查找。

赏金计划

您可能会找到一些被标记为bountysource的issue。这意味着对于按照文档中描述的标准解决这些issue的人，将提供赏金。您首先需要在BountySource.com上创建一个账户。之后的步骤如下：

执行仓库的fork
解决issue
提交pull request

我们将验证pull request是否符合要求，一旦通过审核，我们将负责在BountySource账户中为您发放赏金。

许可

本项目受GPL 3许可证保护。

任何软件（或其修改版本）的发行都必须包含完整的源代码副本、适当的对原始软件OpenSTAManager的提及以及GPL 3许可证的副本。

devcode-it / openstamanager

维护者

详细信息