# Haio Main - 用户发行版（预览 1.0.0）

**Repository Path**: hzywljs/haio-main

## Basic Information

- **Project Name**: Haio Main - 用户发行版（预览 1.0.0）
- **Description**: 面向最终用户的 Haio 发行版：精简核心、安装即授权、Vue 后台（Ant 风格）、Blade 前台可选。
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-24
- **Last Updated**: 2026-02-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Haio Main - 用户发行版（预览 1.0.0）

**Haioo ，海鸥系统，莆田市海之云网络技术有限公司研发，作者 @陈立伟**

面向最终用户的 Haio 发行版：精简核心、安装即授权、Vue 后台（Ant 风格）、Blade 前台可选。

---

## 版权与出处说明（重要）

本项目采用开源方式发布，但**版权归属与研发出处必须保留**：

- **版权**：莆田市海之云网络技术有限公司  
- **研发/作者**：@陈立伟（HaiO 工程师）  
- **产品**：Haioo 海鸥系统  

**请您在使用、二次开发或分发本代码时：**

1. **保留文件头与函数注释**：不要删除或篡改各源文件中的「Haioo ，海鸥系统，莆田市海之云网络技术有限公司研发，作者@陈立伟」及「HaiO 工程师@陈立伟」等版权与出处信息。  
2. **注明来源**：在基于本项目的衍生作品或文档中，请注明“基于 Haioo 海鸥系统（莆田市海之云网络技术有限公司）研发”或类似出处说明。  
3. **遵守开源协议**：在遵守项目所采用的开源协议前提下，保留公司研发来源出处是对研发团队与公司的尊重，也是开源生态的良好实践。  

感谢您对 Haioo 与海之云的支持。

---

## 与主仓库的关系

- 本目录为 **独立发行包**，部署时可将主项目除 `haio-main` 外文件与 `haio-main` 内文件合并，或通过构建脚本产出「haio-main 发行版」。
- 核心框架仍使用主项目 `src/`、`vendor/`；`haio-main` 提供：覆盖的安装流程、配置、路由、Vue 后台、Blade 视图及门户插件精简版。

## 功能概览

| 功能 | 说明 |
|------|------|
| **安装** | 访问 `/` 未安装时自动跳转 `/install`；配置完成后向 https://www.haioos.com 申请授权并生成授权码（预览版 1.0.0） |
| **Vue 后台** | 仿 Ant Design 风格，参考 `haio_admin_vue`：仪表盘、授权状态、版本、升级（占位）、门户新闻、菜单权限、管理员资料/改密、应用市场/模板市场（对接 haioos.com） |
| **前台模式** | 可选 Blade 视图输出 或 Vue SPA；后台可切换「模板」 |
| **默认插件** | 门户（portal-main）：新闻资讯的发布、上架、下架、编辑 |

## 目录说明

```
haio-main/
  config/          覆盖或新增配置（授权、haioos.com API）
  app/             覆盖控制器（安装、授权、首页重定向）
  routes/          发行版路由（/ -> /install 未安装时）
  install/views    安装向导视图
  resources/views  Blade 前台模板
  plugins/portal-main  精简门户插件（新闻 + Blade 输出）
  haio_admin_main/     Vue 后台（Ant 风格）
  database/        发行版用 schema 等
```

## 安装后授权流程

1. 用户在 `/install` 完成数据库等配置并执行初始化。
2. 安装脚本请求 `https://www.haioos.com` 授权 API，传入站点信息，获取授权码（预览版 1.0.0）。
3. 授权码写入 `.env` 或 `storage/license.json`，后台「授权状态」页可读。

## 独立运行（整套程序在 haio-main 内）

可将文档根指向 `haio-main/public`，在 haio-main 内独立跑通安装、首页、后台与 API：

1. **环境**：PHP 8.0+，MySQL，主项目根目录已执行 `composer install`（haio-main 共用父级 `vendor/` 与 `src/`）。
2. **配置**：在 **主项目根目录** **haio-main** 下复制 `.env.example` 为 `.env`，填写数据库等（安装向导也会写入 .env）。
3. **入口**：Web 根目录指向 `haio-main/public`。入口中 `HAIOO_ROOT = haio-main`，`HAIOO_PATH = 主项目根`。
4. **安装**：未安装时访问 `/` 会跳转 `/install`，按步骤完成数据库配置与初始化；step4 会向 haioos.com 申请预览授权。
5. **后台构建**：`cd haio_admin_main && npm i && npm run build`，产物在 `haio-main/public/haioAdmin/dist`，访问 `/haioAdmin` 进入后台。
6. **默认账号**：安装完成后管理员 `admin` / `123456`。

## 使用方式（与主项目合并部署）


1. **未安装时 / 跳转 /install**
   - 在主项目 `public/index.php` 中，在 `$app->handle(null)` 之前调用：
     `require __DIR__.'/../routes/redirect_uninstalled.php'; haio_main_redirect_if_uninstalled();`
   - 或在 `Application::dispatch()` 中，在处理 `/` 之前判断 `installed.lock`，不存在则 `header('Location: /install'); exit;`

2. **安装路由使用 InstallControllerMain**
   - 将主项目中原安装路由改为指向 `InstallControllerMain`（或合并 `routes/web_main.php` 中的路由表）。

3. **后台授权 API**
   - 注册 `GET /api/admin/license/status`、`POST /api/admin/license/apply` 指向 `App\Controllers\Api\LicenseStatusController`。

4. **Vue 后台**
   - 按 `haio_admin_main/README.md` 以 `haio_admin_vue` 为蓝本制作并构建，输出到 `public/haioAdmin/`。

5. **Blade 前台**
   - 当 `FRONTEND_MODE=blade` 时，根路径 `/` 由主项目路由渲染 `resources/views/home.blade.php`，并从 portal 插件拉取新闻列表传入视图。

**Nginx 伪静态**
- location / {
-    try_files $uri $uri/ /index.php?$query_string;
- }
- location ^~ /haioAdmin/ {
-     try_files $uri $uri/ /haioManage/dist/index.html;
- }
- location ^~ /docs/ { try_files $uri $uri/ /index.php?$query_string; }

## 版本

- 预览版：**1.0.0**
- 版权：莆田市海之云网络技术有限公司 · 作者 @陈立伟