wahidyankf/ose-public

# 🌙 Open Sharia Enterprise ✨ 一个用于符合 Sharia 规范的商业系统的企业解决方案平台。 🌐 **在线站点**： - **OSE Platform** ([oseplatform.com](https://oseplatform.com)) - 主平台网站（建设中） - **AyoKoding** ([ayokoding.com](https://ayokoding.com)) - 来自该项目的工程研究与经验，作为教育内容公开分享 - **OrganicLever** ([organiclever.com](https://www.organiclever.com/)) - 着陆和推广网站（Phase 1，开发中） ## 🚧 项目状态 **当前阶段：Phase 1 (OrganicLever - 效率追踪工具)** 正在构建 OrganicLever，一个全栈个人效率追踪工具： - 🌐 **着陆网站**: [organiclever.com](https://www.organiclever.com/) ([organiclever-web](./apps/organiclever-app-web/)) - Next.js 推广网站 - ✅ **Phase 0 已完成**: [ayokoding.com](https://ayokoding.com), [oseplatform.com](https://oseplatform.com), AI agents, governance, CLI 工具 **下一阶段：Phase 2 (SMB 应用)** - 在 OrganicLever 基础上构建中小型企业（SMB）应用。 **预期内容：** - 🔄 不另行通知的破坏性变更 - 📐 架构仍在演进中 - 🧪 实验性实现 有关完整的开发阶段和策略，请参阅 **[ROADMAP.md](./ROADMAP.md)**。 ## 🚀 快速开始 ### 📋 前置条件 - **Node.js** 24.13.1 LTS & **npm** 11.10.1（通过 [Volta](https://docs.volta.sh/guide/getting-started) 管理） ### 📥 安装 ``` npm install ``` ## 🛠️ 技术栈 **指导原则**：使用让你保持自由的技术 —— 开放格式、可移植数据、无供应商锁定。 **Phase 0（已完成）：** - Node.js & npm（通过 Volta）- 工具和开发基础设施 - Next.js 16 - 公共网站和内容平台 - Golang - CLI 工具（[ayokoding-cli](./apps/ayokoding-cli/), [rhino-cli](./apps/rhino-cli/)）及未来的安全基础设施 **当前阶段 Phase 1 (OrganicLever)：** - 前端 (着陆页): Next.js + TypeScript - 基础设施: Kubernetes 有关所有阶段完整技术栈的演进，请参阅 **[ROADMAP.md](./ROADMAP.md)**。 ## 📂 项目结构 本项目使用 **Nx** 来管理应用程序和库： ``` open-sharia-enterprise/ ├── apps/ # Deployable applications (Nx monorepo) ├── 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 ``` **Applications** (`apps/`)： - **Sites**: [`ose-web`](./apps/ose-www/), [`ayokoding-web`](./apps/ayokoding-www/), [`organiclever-web`](./apps/organiclever-app-web/), [`organiclever-be`](./apps/organiclever-be/), [`organiclever-web-e2e`](./apps/organiclever-app-web-e2e/), [`organiclever-be-e2e`](./apps/organiclever-be-e2e/), [`wahidyankf-web`](./apps/wahidyankf-www/), [`wahidyankf-web-fe-e2e`](./apps/wahidyankf-www-fe-e2e/) - **CLI tools**: [`ayokoding-cli`](./apps/ayokoding-cli/), [`rhino-cli`](./apps/rhino-cli/), [`ose-cli`](./apps/ose-cli/) - **多语言演示应用**: 于 2026-04-18 提取至下游 [`ose-primer`](https://github.com/wahidyankf/ose-primer) 模板仓库，该仓库目前是多语言展示（Go, Java, Elixir, F#, Python, Rust, Kotlin, TypeScript, C#, Clojure 后端 + Next.js, TanStack Start, Flutter Web 前端）的权威来源。 **Libraries** (`libs/`)：可重用的共享代码 **了解更多**: [Monorepo 结构参考](./docs/reference/monorepo-structure.md) | [如何添加新应用](./docs/how-to/add-new-app.md) | [如何添加新库](./docs/how-to/add-new-lib.md) | [如何运行 Nx 命令](./docs/how-to/run-nx-commands.md) ## 💻 开发 **代码质量**：每次提交都会运行自动化检查（Prettier 格式化、Commitlint 验证、markdown lint）。 **常用命令**： ``` 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 nx affected -t build # Build only affected projects nx affected -t test:quick # Run fast quality gate for affected projects nx graph # Visualize dependencies ``` 有关详细信息，请参阅 [代码质量](./repo-governance/development/quality/code.md) 和 [提交信息](./repo-governance/development/workflow/commit-messages.md)。 ## 📊 CI 与测试覆盖率 所有项目在执行 `test:quick` 时强制要求 ≥90% 的测试覆盖率。 **质量门禁**：pre-commit hooks（格式化、lint）、pre-push hooks（针对受影响项目的 `typecheck`、`lint`、`test:quick`）以及 [commons 质量门禁](./.github/workflows/commons-quality-gate.yml)。 - OSE Platform - [](https://github.com/wahidyankf/ose-public/actions/workflows/ose-www-test-local-deploy-prod.yml) - AyoKoding - [](https://github.com/wahidyankf/ose-public/actions/workflows/ayokoding-www-test-local-deploy-prod.yml) - OrganicLever (app — staging) - [](https://github.com/wahidyankf/ose-public/actions/workflows/organiclever-app-test-local-deploy-stag.yml) - Wahidyankf - [](https://github.com/wahidyankf/ose-public/actions/workflows/wahidyankf-www-test-local-deploy-prod.yml) - [`rhino-cli`](./apps/rhino-cli/) 有关多语言演示应用的 CI 徽章，请参阅 [`ose-primer`](https://github.com/wahidyankf/ose-primer) 仓库。 ## 📚 文档 使用 [Diátaxis 框架](https://diataxis.fr/) 组织：[教程](./docs/tutorials/)（学习）、[指南](./docs/how-to/)（解决问题）、[参考](./docs/reference/)（查阅）、[解释](./docs/explanation/)（理解）。 有关详细信息，请参阅 [`docs/README.md`](./docs/README.md)。 ## 🔗 相关仓库 - **[`ose-primer`](https://github.com/wahidyankf/ose-primer)** — 公开的、基于 MIT 许可证的模板仓库，派生自 `ose-public`。将脚手架（governance、AI agents、skills、约定、CI 测试套件、多语言演示应用）封装为一个可重用的起点。`ose-public` 是上游事实来源；通过与 `ose-primer` 的多仓库一致性规划工作流手动维护内容对齐。有关上下游关系和许可证差异，请参阅 [相关仓库参考](./docs/reference/related-repositories.md)。 ## 🎯 动机 我们的使命是为各种规模的组织——无论其地域或行业——普及对值得信赖的、符合 Sharia 规范的企业技术的获取途径。 **机遇：** - 伊斯兰企业（金融、商业、合作社）是一个价值数万亿美元的全球市场 - 现有平台大多是专有的、昂贵的且受领域限制的 - 大多数组织依赖于为兼容 Sharia 而进行过改造的遗留系统 - 缺口在于：开源的、优先考虑合规性的解决方案，并具备彻底的透明度 **我们的解决方案：** - 渐进的复杂性：个人（Phase 1）→ SMB（Phase 2）→ 企业（Phase 3） - 每个阶段为下一个阶段提供资金；Phase 1/2 的成功将资助 Phase 3 的认证预算 - Sharia 合规性从底层构建，而不是后期附加 **我们相信：** - 🕌 **以 Sharia 合规性为基础** - 从底层构建，而不是后期附加 - 🔓 **透明度建立信任** - 开源代码使社区能够对 Sharia 合规性进行验证 - 🤖 **AI 辅助开发** - 系统性地使用 AI 工具来提升生产力和代码质量 - 🛡️ **从第一天起就注重安全和治理** - 建筑级的基础，而非事后补充 - 📚 **公开学习** - 通过 [ayokoding.com](https://ayokoding.com) 分享我们的研究和知识 - 🏗️ **长期基础重于快速赢利** - 为终身项目打下坚实的基础 有关完整的原则，请参阅 [repo-governance/principles/](./repo-governance/principles/README.md)。 ## 🤝 贡献 🔒 在我们稳定架构和模式期间，**目前暂停接受贡献**。 🎉 **欢迎 Fork！** 为你的地区或用例构建自己的版本——一旦基础稳固，我们将向社区开放贡献。 ## 📜 许可证 本仓库基于 **[MIT License](./LICENSE)** 授权。所有代码、文档、 governance 材料、规范和 AI agent 配置均基于 MIT 许可证授权——可免费用于任何目的的 使用、fork、修改和分发。 有关完整详情，请参阅 [LICENSING-NOTICE.md](./LICENSING-NOTICE.md) | [LICENSE](./LICENSE) 获取根许可证文本 | [Licensing Convention](./repo-governance/conventions/structure/licensing.md) 获取内部规则。

标签：EVTX分析, Golang, Next.js, 企业级平台, 伊斯兰合规, 全栈开发, 安全编程, 时间追踪, 生产力工具