# demo

**Repository Path**: doc_my/demo

## Basic Information

- **Project Name**: demo
- **Description**: day by day
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2022-11-24
- **Last Updated**: 2026-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 金零（Matrix Demo）

主题社交导航门户：H5 业务层 + Java API + Go 爬虫脚本 + uni-app 壳。

## 快速启动

**换机 / 新 clone 请先运行：** [docs/SETUP.md](docs/SETUP.md)（或 `matrix_go/scripts/tools/bootstrap_dev.ps1` / `bootstrap_dev.sh`）

```bash
# H5 本地预览
cd matrix_html
npx serve -s . -l 8080

# Java 后端（聊天、足彩、会员等 API）
cd matrix_java
mvn spring-boot:run

# 或使用项目根目录脚本（Windows，仅 H5 + uni-app）
start_dev.bat
```

浏览器访问：`http://localhost:8080/index.html`

## 模块入口（`?c=` 路由）

| 参数 | 功能 |
|------|------|
| `websites` | 网站导航 |
| `chat` | 主题聊天 |
| `maoQuotes` | 毛选语录 |
| `cityGame` / `cityCards` / `cityDraw` | 百城打卡 / 卡牌图鉴 / 幸运抽卡 |
| `pets` | 宠物领养 |
| `pastNews` | 往日旧闻 |
| `jobBoard` | 招聘聚合 |
| `tangPoetry` | 唐诗精选 |
| `examEssays` | 作文真题 |
| `memorialTimer` | 纪念时光 |
| `zucaiTianxia` | 足彩世界 |
| `contact` / `helloWorld` | 联系我们 |
| `ningboService` | 技术支持 |
| `navigationNb` | 我在南滨 |
| `userManage` | 用户管理 |

## 目录

- `matrix_html/` — 前端 H5（`static/module/` 各业务页）
- `matrix_java/` — Spring Boot API（会员、积分、聊天、宠物、活动追踪等）
- `matrix_go/qclaw/` — 爬虫与数据生成脚本
- `matrix_app/` — uni-app Webview 壳
- `docs/` — 部署、架构、模块说明与 [数据分类说明](docs/DATA_LAYOUT.md)
- `matrix_go/scripts/tools/` — 足彩运维、归档、打开官网等脚本

## 数据与 Git

业务主数据（会员、足彩用户、赛程 JSON 等）**提交仓库**；备份、日志、发送标记等运行时文件**不入库**，详见 [docs/DATA_LAYOUT.md](docs/DATA_LAYOUT.md)。

本地归档备份：

```powershell
powershell -File matrix_go/scripts/tools/archive_runtime_data.ps1
```

## 数据脚本

```bash
# 一键刷新内容线数据（历史事件 / 招聘 / 毛选语录 JSON）
matrix_go/qclaw/refresh_content_data.bat   # Windows
matrix_go/qclaw/refresh_content_data.sh    # macOS / Linux

# 生成全年历史事件 JSON
python matrix_go/qclaw/generate_historical_events.py

# 导出招聘 IT 岗位到 H5（自动取最新爬虫缓存，含新增/移除统计）
python matrix_go/qclaw/export_jobs_for_web.py

# 招聘爬虫（默认爬最近 2 天更新；超过 2 天未更新则从缓存移除，再次更新视为新增）
python matrix_go/qclaw/crawler_job_nhrc.py
python matrix_go/qclaw/crawler_job_nbrc.py
python matrix_go/qclaw/crawler_job_51job.py

# 从 HTML 提取毛选语录到 JSON
python matrix_go/qclaw/extract_mao_quotes.py

# 生成近50年中高考作文库（1976-2025）
python matrix_go/qclaw/generate_exam_essays.py

# 生成宠物数据
python matrix_go/qclaw/generate_pet_data.py
```

## 离线模式

前端在 `matrix-env.js` 之后加载 `static/js/offline-sync.js`，全局拦截 `/api/` 请求：

- **GET 失败**：读取本地缓存（上次成功响应）
- **POST/PUT/PATCH/DELETE 失败**：写入 `localStorage` 队列 `matrix_offline_queue_v1`
- **健康探测**：每 15 秒请求 `GET /api/health`；每 30 秒尝试同步队列
- **恢复联网**：自动重放队列；顶部显示 `#matrixOfflineBar` 状态条

业务脚本可通过 `window.MatrixOffline` 访问：

```javascript
MatrixOffline.isOnline()       // 服务端是否可达
MatrixOffline.getPendingCount() // 待同步条数
MatrixOffline.flushQueue()     // 手动触发同步
```

支付/开通会员在离线时会入队但**不会**本地假开通；积分消耗、宠物发布、聊天等会乐观更新 UI。

## 文档

- [ARCHITECTURE.md](ARCHITECTURE.md) — 整体架构
- [PETS_QUICK_START.md](PETS_QUICK_START.md) — 宠物模块
- [IMPLEMENTATION_SUMMARY.md](IMPLEMENTATION_SUMMARY.md) — 活动追踪说明

## 链接

- [防止失联](https://www.yamhk.top)
- [认证官网](https://www.task2030.xyz/)