wahidyankf/open-sharia-enterprise

# 🌙 Open Sharia Enterprise ✨ 一个符合 Sharia 规范的商业系统企业解决方案平台。 [](https://github.com/wahidyankf/open-sharia-enterprise/actions/workflows/e2e-organiclever.yml) [](https://github.com/wahidyankf/open-sharia-enterprise/actions/workflows/deploy-ayokoding-web.yml) [](https://github.com/wahidyankf/open-sharia-enterprise/actions/workflows/deploy-oseplatform-web.yml) 🌐 **在线站点**： - **OSE Platform** ([oseplatform.com](https://oseplatform.com)) - 主平台网站（建设中） - **AyoKoding** ([ayokoding.com](https://ayokoding.com)) - 分享我们为此项目开发的技术研究和领域知识。我们在构建 Open Sharia Enterprise 过程中学到的知识，通过教育内容向更广泛的社区开放 - **OrganicLever** ([organiclever.com](https://www.organiclever.com/)) - 着陆页和推广网站（第一阶段，开发中） ## 🚧 项目状态 **当前阶段：第一阶段（OrganicLever - 生产力追踪器）** 构建 OrganicLever，一个全栈个人生产力追踪器： - 🌐 **着陆网站**：[organiclever.com](https://www.organiclever.com/) ([organiclever-web](./apps/organiclever-web/)) - Next.js 推广网站 - ☕ **Backend API**：Spring Boot REST API ([organiclever-be](./apps/organiclever-be/)) - ✅ **第 0 阶段已完成**：[ayokoding.com](https://ayokoding.com)，[oseplatform.com](https://oseplatform.com)，AI agents，治理，CLI 工具 **下一阶段：第二阶段（SMB 应用）** - 基于 OrganicLever 基础构建的中小企业应用。 **预期情况**： - 🔄 随时可能发生破坏性变更 - 📐 架构仍在演进中 - 🧪 实验性实现 - ❌ 暂不接受公开贡献 有关完整的开发阶段和策略，请参阅 **[ROADMAP.md](./ROADMAP.md)**。 ## 🎯 动机 **机遇**：伊斯兰企业（金融、商业、合作社及其他领域）代表着一个价值数万亿美元的全球市场，对符合 Sharia 规范的商业系统产生了巨大需求。虽然存在专用平台，但它们通常是专有的、昂贵的，并且仅限于特定领域。许多组织还在为适配 Sharia 合规性的遗留系统而挣扎。缺口在哪里？缺乏具有内置合规性和彻底透明度的、易于访问的开源解决方案——以满足伊斯兰商业需求的完整光谱。 **我们的解决方案**：我们正在构建一个以 Sharia 合规性为核心的全球开源平台——遵循从个人用户（第一阶段：OrganicLever 生产力追踪器）到 SMB（第二阶段）再到企业（第三阶段：完整 ERP 和领域扩展）的渐进式复杂度方法。每个阶段产生收入以资助下一阶段，第一/第二阶段的成功将资助第三阶段的巨额认证预算。我们正在让值得信赖、透明的商业系统可供全球任何组织使用——无论其规模、地区或行业如何。 **我们相信**： - 🕌 **Sharia 合规性作为基础** - 从一开始就内置，而非事后补充 - 🔓 **透明度建立信任** - 开源代码使社区能够验证 Sharia 合规性 - 🤖 **AI 辅助开发** - 系统性地使用 AI 工具以提高生产力和代码质量 - 🛡️ **从第一天起就重视安全和治理** - 作为架构基础，而非事后诸葛亮 - 📚 **公开学习** - 通过 [ayokoding.com](https://ayokoding.com) 分享我们的研究和知识 - 🏗️ **长期基础优于短期利益** - 为终身项目构建坚实的基础 有关完整的原则，请参阅 [governance/principles/](./governance/principles/README.md)。 🚀 我们的使命是让各种规模的组织，无论身处何地或从事何种行业，都能平等地获得值得信赖的、符合 Sharia 规范的企业技术。 ## 🗺️ 开发路线图 本项目遵循**渐进式复杂度方法** - 从简单开始，充分测试，并从个人用户到 SMB 再到企业进行系统化扩展。 **当前阶段：第一阶段（OrganicLever - 生产力追踪器）** - 构建一个包含着陆网站、移动应用和后端 API 的全栈个人生产力追踪器。 **下一阶段：第二阶段（SMB 应用）** - 基于 OrganicLever 基础构建的中小企业应用。 有关包括所有阶段、技术栈和战略方法在内的完整路线图，请参阅 **[ROADMAP.md](./ROADMAP.md)**。 ## 🛠️ 技术栈 **指导原则**：让你保持自由的技术 —— 开放格式、可移植数据、无厂商锁定。 **第 0 阶段（已完成）**： - Node.js 24.13.1 & npm 11.10.1（通过 Volta）- 工具链和开发基础设施 - Hugo (Extended) - 静态站点 - Golang - CLI 工具 ([ayokoding-cli](./apps/ayokoding-cli/), [rhino-cli](./apps/rhino-cli/)) 以及未来的安全基础设施 **当前第一阶段**： - Backend：Java + Spring Boot - Frontend（着陆页）：Next.js + TypeScript → www.organiclever.com - 基础设施：Kubernetes 有关所有阶段的技术栈演进，请参阅 **[ROADMAP.md](./ROADMAP.md)**。 ## 🚀 入门指南 ### 📋 前置条件 - **Node.js** 24.13.1 LTS & **npm** 11.10.1（通过 [Volta](https://docs.volta.sh/guide/getting-started) 管理） ### 📥 安装 ``` npm install ``` ### 📂 项目结构 ``` open-sharia-enterprise/ ├── apps/ # Deployable applications (Nx monorepo) ├── apps-labs/ # Experimental apps and POCs (NOT in Nx monorepo) │ └── README.md # Labs directory documentation ├── libs/ # Reusable libraries (Nx monorepo, flat structure) ├── docs/ # Project documentation (Diataxis framework) │ ├── tutorials/ # Learning-oriented guides │ ├── how-to/ # Problem-oriented guides │ ├── reference/ # Technical reference │ └── explanation/ # Conceptual documentation ├── plans/ # Project planning documents │ ├── in-progress/ # Active project plans │ ├── backlog/ # Planned projects for future │ └── done/ # Completed and archived plans ├── nx.json # Nx workspace configuration ├── tsconfig.base.json # Base TypeScript configuration ├── package.json # Project manifest with npm workspaces └── README.md # This file ``` ### 🏗️ Monorepo 架构 本项目使用 **Nx** 来管理应用程序和库： - **`apps/`** - 可部署的应用程序（当前：[`oseplatform-web`](./apps/oseplatform-web/), [`ayokoding-web`](./apps/ayokoding-web/), [`ayokoding-cli`](./apps/ayokoding-cli/), [`rhino-cli`](./apps/rhino-cli/), [`javaproject-cli`](./apps/javaproject-cli/), [`oseplatform-cli`](./apps/oseplatform-cli/), [`organiclever-web`](./apps/organiclever-web/), [`organiclever-web-e2e`](./apps/organiclever-web-e2e/), [`organiclever-be`](./apps/organiclever-be/), [`organiclever-be-e2e`](./apps/organiclever-be-e2e/)） - **`libs/`** - 带有语言前缀的可复用库（`ts-*`，未来：`java-*`, `py-*`）- 当前为空 - **`apps-labs/`** - 实验性应用和 POC（框架评估、语言探索）- 当前为空 **常用命令**： ``` nx dev [app-name] # Start development server nx build [app-name] # Build specific project nx affected -t build # Build only affected projects nx affected -t test:quick # Run fast quality gate for affected projects nx graph # Visualize dependencies ``` **了解更多**： - [Monorepo 结构参考](./docs/reference/re__monorepo-structure.md) - [如何添加新应用](./docs/how-to/hoto__add-new-app.md) - [如何添加新库](./docs/how-to/hoto__add-new-lib.md) - [如何运行 Nx 命令](./docs/how-to/hoto__run-nx-commands.md) ## 💻 开发 **代码质量**：每次提交都会运行自动检查（Prettier 格式化、Commitlint 验证、Markdown linting）。 **常用命令**： ``` npm run build # Build all projects npm run test # Run tests npm run lint # Lint code nx dev [app-name] # Start development server nx build [app-name] # Build specific project ``` 详情请参阅 [代码质量](./governance/development/quality/code.md) 和 [提交信息](./governance/development/workflow/commit-messages.md)。 ## 🤝 贡献 🔒 **当前关闭贡献**，直到项目模式和架构足够稳定以接受外部贡献。这确保了我们在构建基础时保持代码质量和法规合规性。 不过，🎉 **欢迎你 Fork 本仓库！** 你可以自由地： - 🍴 为你所在的地区或用例创建你自己的 Fork - 🧪 试验扩展和修改 - 🏗️ 基于此项目构建你的特定需求 - 📤 与社区分享你的改进 ✨ 一旦核心模式确立且项目足够成熟，我们将开放贡献流程。我们期待在未来与社区协作！ ## 📚 文档 使用 [Diátaxis 框架](https://diataxis.fr/) 组织：[教程](./docs/tutorials/)（学习），[操作指南](./docs/how-to/)（解决问题），[参考](./docs/reference/)（查阅），[解释](./docs/explanation/)（理解）。 **查看提示**：`docs/` 文件夹可用作 [Obsidian](https://obsidian.md/) 仓库。 详情请参阅 [`docs/README.md`](./docs/README.md)。 ## 📜 许可证 **MIT 许可证** - 完全自由地用于任何目的，包括商业项目、企业解决方案和教育。无限制。详情请参阅 [LICENSE](./LICENSE)。

标签：EVTX分析, EVTX分析, JS文件枚举, MITM代理, REST API, SaaS, Spring Boot, 中小企业应用, 企业管理平台, 伊斯兰金融, 公开学习, 单体仓库, 合规系统, 子域名突变, 开源, 开源框架, 技术文档, 持续集成, 效率工具, 教育内容, 暗色界面, 清真合规, 生产力追踪, 网站建设