From 299790d38f2cf0f16d5b115c868ebc653b2e6a2a Mon Sep 17 00:00:00 2001
From: shy3130 <415333856@qq.com>
Date: Sun, 30 Aug 2026 19:05:49 +0800
Subject: [PATCH] =?UTF-8?q?docs(readme):=20=E4=BF=AE=E6=94=B9readme?=
=?UTF-8?q?=E7=9B=B8=E5=85=B3=E5=86=85=E5=AE=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
README.md | 242 ++++++++++++++++++-------
assets/support/alipay.jpg | Bin 0 -> 174016 bytes
assets/support/wechat-appreciation.jpg | Bin 0 -> 72651 bytes
3 files changed, 177 insertions(+), 65 deletions(-)
create mode 100644 assets/support/alipay.jpg
create mode 100644 assets/support/wechat-appreciation.jpg
diff --git a/README.md b/README.md
index 56638a4..823548c 100644
--- a/README.md
+++ b/README.md
@@ -1,42 +1,32 @@
-# 📈 A股智能量化工作台
-
-[](https://github.com/shy3130/tick-stock-panel)
-
+# TSP--A股智能量化工作台
+[](https://github.com/shy3130/tick-stock-panel)
**自托管、零运维的 A 股「选股 + 监控 + 回测」量化工作台**
-**面向个人散户与量化爱好者而生**
+**多数据源能力路由 · 分钟级策略执行 · 全时段异动监控 · AI 辅助研究**
[](./LICENSE)
-[](https://www.python.org/)
-[](https://react.dev/)
-[](https://tickflow.org/auth/register?ref=V3KDKGXPEA)
+[](https://pola.rs/)
+[](./docs/custom-data-source.md)
[](./Dockerfile)
+[](https://github.com/shy3130/tick-stock-panel/actions/workflows/docker.yml)
[](https://github.com/shy3130/tick-stock-panel/stargazers)
-
-
-**[快速开始](#-快速开始)** · **[核心功能](#-核心功能)** · **[配置](#️-配置)** · **[完整文档](#-完整文档)**
+**[快速开始](#-快速开始)** · **[核心功能](#-核心功能)** · **[技术架构](#️-技术架构)** · **[配置](#️-配置)** · **[完整文档](#-完整文档)**
-
---
-
-
-**本项目个人开源，数据源插件化，可任意接入第三方数据源。仅供学习研究使用，严禁商业用途。**
-
-
-
+**本项目以个人开源为主进行开发维护，数据源插件化，可任意接入第三方数据源。仅供学习研究使用，严禁商业用途。**
> ⚠️ 小白请绕路，本开源项目谨作为本地量化提供解决思路Demo，不作为投资软件或者看盘软件。
>
@@ -50,59 +40,60 @@
## ✨ 核心功能
-| 模块 | 一句话 | 详见 |
+| 模块 | 一句话 | 详见 |
| :--------------- | :--------------------------------------------------------------------- | :-------------------------------- |
-| 🔍 **选股引擎** | 18 个内置策略 + 自定义信号 + AI 生成 + 代码迁移,Polars 毫秒级扫全 A 股 | [strategy.md](./docs/strategy.md) |
-| 📊 **指标流水线** | MA/EMA/MACD/RSI/KDJ/布林/量比等,一次扫表落盘 enriched Parquet | [features.md](./docs/features.md) |
-| 🧪 **回测研究** | 因子/策略回测 + 财务快照因子(点时口径),T+1/费用/滑点约束,SSE 持久任务 | [features.md](./docs/features.md) |
+| 🔀 **能力路由** | 多数据集(日K/除权/实时/分钟/盘口/财务,持续扩展)按源能力独立路由,任选组合 | [custom-data-source.md](./docs/custom-data-source.md) |
+| 🔍 **选股引擎** | 18 个内置策略 + 分钟策略 + 自定义信号 + AI 生成,Polars 毫秒级扫全 A 股 | [strategy.md](./docs/strategy.md) |
+| 📊 **指标流水线** | MA/EMA/MACD/RSI/KDJ/布林/量比等 68 列指标与信号,一次扫表落盘 enriched Parquet | [features.md](./docs/features.md) |
+| 🧪 **回测研究** | 因子/策略/分钟回测 + 财务快照因子(点时口径),T+1/费用/滑点约束,结果可导出 | [features.md](./docs/features.md) |
| ⛏️ **因子挖掘** | 嵌套样本外搜索多因子排名组合,与自有策略对照,候选库显式发布、永不自动上线 | [mining.md](./docs/mining.md) |
| 🌡️ **市场环境** | 情绪周期 6 阶段(连板梯队驱动)+ 概念/行业主线排名,与 5 档环境分并存 | [market-phase.md](./docs/market-phase.md) |
-| 🚨 **异动监控** | 交易所异动规则口径(3/10/30 日偏离值),盘中实时接近度,系统告警与推送接入 | — |
+| 🚨 **异动监控** | 竞价/盘中/偏移三类异动一页覆盖:同花顺风向标 + 当日信号聚合 + 交易所偏离值口径 | — |
| 📡 **监控中心** | 四类监控(策略/个股信号/价格/异动),多条件 AND/OR + 语音播报 + 飞书推送 | [features.md](./docs/features.md) |
| 📈 **个股分析** | 9 类关键价位 + AI 四维分析(技术/基本面/财务/消息面) | [features.md](./docs/features.md) |
-| 🏆 **连板梯队** | 连板层级统计 + 概念涨幅轮动 + 盘后 AI 复盘 + 炸板/翘板预警 | [features.md](./docs/features.md) |
-| 🧰 **数据扩展** | 数据源插件化(stock-sdk 示例 + YAML 自定义源),扩展字段配成一级页面同台分析 | [custom-data-source.md](./docs/custom-data-source.md) |
-
-
-
-
+| 🏆 **连板梯队** | 连板层级统计 + 概念涨幅轮动 + 盘后 AI 复盘(龙虎榜/盘前风向标注入) + 炸板/翘板预警 | [features.md](./docs/features.md) |
+| 🧰 **数据扩展** | 数据源插件化(TickFlow/fuyao/stock-sdk + YAML 自定义源),扩展字段配成一级页面同台分析 | [custom-data-source.md](./docs/custom-data-source.md) |
📦 主要页面与功能
**📊 行情总览**
-- **看板** Dashboard — 市场情绪评分 + 涨跌/成交额榜单 + 概念领涨领跌 + 大盘异动事件流,一日全貌
-- **自选** Watchlist — 自选股池,多分组管理(M:N),表格/卡片双视图,换手/量比/RSI 等实时指标
+- **看板** Dashboard — 市场情绪评分 + 涨跌/成交额榜单 + 概念/行业领涨领跌(点击板块直达成分股,领涨股带涨跌幅) + 大盘异动事件流,一日全貌
+- **自选** Watchlist — 自选股池,多分组管理(M:N),表格/卡片双视图,换手/量比/RSI 等实时指标,按档位分流实时刷新
- **指数** Indices — 沪深指数浏览与同步
**🔍 选股与回测**
-- **策略** Screener — Polars 毫秒级扫描全 A 股,18 个内置策略卡片 + 自定义条件
-- **回测** Backtest — 两种模式:
- - **因子回测** — IC/IR、分层收益、多空组合,先筛掉无效指标
- - **策略回测** — 净值曲线、回撤、夏普、胜率,支持 T+1/手续费/滑点/止损,SSE 流式进度
+- **策略** Screener — Polars 毫秒级扫描全 A 股,日线/分钟策略统一单池,按策略声明周期自动路由执行
+- **回测** Backtest — 四种研究视图:
+ - **因子回测** — IC/IR、分层收益、多空组合,62+ 因子目录先筛掉无效指标
+ - **策略回测** — 净值曲线、回撤、夏普、胜率,T+1/手续费/滑点/止损,SSE 流式进度
+ - **分钟策略回测** — 逐交易日回放信号、分钟收盘入场,分钟级成交明细
+ - **验证** — 参数敏感性与滚动样本外
+ - 研究闭环:结果导出 CSV(概要/净值/交易明细/分标的统计) → 保存候选 → **一键载入复测**
- **挖掘** Mining — 嵌套样本外因子与策略挖掘:训练区间因子方向重估 + 相关性去重 + 多因子排名组合搜索,自有策略作对照轨;候选入库,显式确认后才发布,永不自动上线
**📈 个股与板块分析**
- **个股分析** Stock Analysis (Beta) — 日K + 9 类关键价位 + AI 四维分析(技术/基本面/财务/消息面)
-- **财务分析** Financials — 利润表/资负表/现金流/关键指标 + AI 解读
-- **概念分析** Concept Analysis — ths 概念涨幅轮动矩阵 + 领涨/领跌主线 + 个股穿透
-- **行业分析** Industry Analysis — 行业分层涨幅轮动 + 领涨/领跌主线 + 成分股
+- **财务分析** Financials — 利润表/资负表/现金流/关键指标(多源并集合并,fuyao 财务四表适配) + AI 解读
+- **概念分析 / 行业分析** — ths 维度涨幅轮动矩阵 + 领涨/领跌主线 + 个股穿透
- **市场环境** Regime — 情绪周期 6 阶段(冰点/启动/主升/高潮/退潮/修复,连板梯队驱动,EMA 平滑 + 2 日确认)+ 概念/行业主线排名,与 5 档环境分并存
- **连板梯队** Limit Up Ladder — 连板层级统计 + 概念/行业分布 + 封单监控(可切换连跌梯队)
**🔔 监控与复盘**
- **监控中心** Monitor — 策略/个股信号/价格/异动四类规则,支持自选分组作用域,盘中实时弹窗 + 语音播报(播报个股名称与信号) + 触发记录持久化
-- **异动监控** Abnormal Moves — 按交易所异动规则口径(3日 ±20%/±30%/±40% · 10日 +100% · 30日 +200%)实时计算个股偏离值接近度,盯住异动边缘名单;触发记录 + 站内通知/飞书·企微推送
-- **复盘** Review (Beta) — 盘后 AI 自动生成市场复盘,可定时执行、推送飞书、下载 Markdown
+- **异动监控** Abnormal Moves — 按交易时间线三 tab:
+ - **竞价异动** — 同花顺盘前风向标(含当日/次日真实收益对照、追高风险标记)+ 全市场竞价扫描(待采集任务)
+ - **盘中异动** — 涨停/炸板/翘板/跌停/新高/新低/放量当日信号聚合,零新增采集
+ - **偏移异动** — 交易所异动偏离值口径(主板 3 日 ±20%、创业板/科创板 ±30%、北交所 ±40%;10 日 +100%/−50%、30 日 +200%/−70%),实时接近度
+- **复盘** Review (Beta) — 盘后 AI 自动生成市场复盘,注入龙虎榜资金动向与盘前风向标对照;可定时执行、推送飞书、下载 Markdown
**🗄️ 数据与扩展**
- **数据** Data — 本地数据画像与同步状态(维表/日K/除权/Enriched/指数/ETF/分钟K/财务),盘后管道与历史扩展
- **扩展分析** (动态菜单) — 把任意第三方/扩展数据字段配成一级菜单,与内置数据同台分析
-- **设置** Settings — 数据源与能力检测、AI 接口、实时监控、扩展页面、信号库、菜单与系统设置
+- **设置** Settings — 数据源与能力检测(能力路由矩阵、档位徽章)、AI 接口、实时监控、扩展页面、信号库、菜单与系统设置
-
---
## 📸 界面预览
@@ -148,11 +139,116 @@
-
---
+## 🏗️ 技术架构
+### 分层总览
+```mermaid
+flowchart TB
+ subgraph DATA["数据源层 · 插件化"]
+ direction LR
+ D1["TickFlow SDK"] ~~~ D2["fuyao
同花顺 REST"] ~~~ D3["stock-sdk"] ~~~ D4["YAML 自定义源"] ~~~ D5["+ 更多插件…"]
+ end
+
+ subgraph ROUTE["能力路由层"]
+ direction LR
+ R(["多数据集 · 按能力独立路由 · 档位探测"])
+ end
+
+ subgraph STORE["存储层"]
+ direction LR
+ ST1[("Parquet 分区表")] ~~~ ST2[("DuckDB")] ~~~ ST3[("JSON 按日缓存")]
+ end
+
+ subgraph CALC["计算层 · Polars"]
+ direction LR
+ C1["指标流水线"] ~~~ C2["复权与信号"]
+ end
+
+ subgraph RES["研究层"]
+ direction LR
+ G1["因子引擎"] ~~~ G2["回测引擎"] ~~~ G3["因子挖掘"]
+ end
+
+ subgraph SVC["应用层 · FastAPI"]
+ direction LR
+ S1["REST · SSE"] ~~~ S2["监控引擎"] ~~~ S3["任务调度"] ~~~ S4["交易日探针"]
+ end
+
+ subgraph FE["呈现层 · React 18"]
+ direction LR
+ F1["功能页面"] ~~~ F2["图表可视化"] ~~~ F3["实时推送"]
+ end
+
+ subgraph EXT["二次开发与扩展 · 贯穿各层的插槽"]
+ direction LR
+ X1["自定义策略"] ~~~ X2["自定义信号"] ~~~ X3["扩展分析页面"] ~~~ X4["AI 接口"]
+ end
+
+ DATA --- ROUTE
+ ROUTE --- STORE
+ STORE --- CALC
+ CALC --- RES
+ RES --- SVC
+ SVC --- FE
+ FE ~~~ EXT
+
+ classDef fe fill:#eef2ff,stroke:#6366f1,color:#312e81
+ classDef svc fill:#ecfeff,stroke:#06b6d4,color:#164e63
+ classDef res fill:#fff7ed,stroke:#f97316,color:#7c2d12
+ classDef calc fill:#f0f9ff,stroke:#0ea5e9,color:#0c4a6e
+ classDef store fill:#ecfdf5,stroke:#10b981,color:#064e3b
+ classDef data fill:#fdf2f8,stroke:#ec4899,color:#831843
+ classDef pluginSlot fill:#fdf2f8,stroke:#ec4899,color:#831843,stroke-dasharray:5 4
+ classDef route fill:#faf5ff,stroke:#8b5cf6,color:#6b21a8,stroke-width:2px
+ classDef ext fill:#f8fafc,stroke:#94a3b8,color:#334155,stroke-dasharray:5 4
+
+ class F1,F2,F3 fe
+ class S1,S2,S3,S4 svc
+ class G1,G2,G3 res
+ class C1,C2 calc
+ class ST1,ST2,ST3 store
+ class D1,D2,D3,D4 data
+ class D5 pluginSlot
+ class R route
+ class X1,X2,X3,X4 ext
+
+ style FE fill:#f5f3ff,stroke:#c7d2fe,color:#3730a3
+ style SVC fill:#ecfeff,stroke:#a5f3fc,color:#155e75
+ style RES fill:#fff7ed,stroke:#fed7aa,color:#9a3412
+ style CALC fill:#f0f9ff,stroke:#bae6fd,color:#075985
+ style STORE fill:#ecfdf5,stroke:#a7f3d0,color:#065f46
+ style ROUTE fill:#faf5ff,stroke:#ddd6fe,color:#6b21a8
+ style DATA fill:#fdf2f8,stroke:#fbcfe8,color:#9d174d
+ style EXT fill:#f8fafc,stroke:#94a3b8,color:#334155,stroke-dasharray:7 5
+```
+
+### 关键机制
+
+| 机制 | 说明 |
+| :--- | :--- |
+| **能力路由矩阵** | 各数据集按源声明能力独立路由,注册表集中定义、可扩展:TICKFLOW 档位探测(None/Free/Starter/Pro/Expert)+ 插件源能力声明,fail-closed(声明 `pct_unit` 未声明即拒)。同一数据集可随时换源,指标与回测口径不变 |
+| **交易日探针** | fuyao 交易日历(确定性,含调休)→ tickflow 全市场行情时间戳探针(OR 语义)→ 工作日兜底;节假日自动停掉实时轮询与分钟增量,零无效请求 |
+| **财务多源合并** | 按 `(symbol, period_end)` 报告期累积,多源取并集、逐列按公告日取最新(PIT);公告前一律空值,绝不填 0 |
+| **非路由数据集直连** | 龙虎榜/盘前风向标/交易日历等 fuyao 专有能力不进路由矩阵,由独立服务直连消费——按日 JSON 缓存(历史不可变)、交易日回退、四态降级 |
+| **回测执行隔离** | 回测在 spawn worker 子进程运行,持久 run ID,刷新/切页重连不丢任务;子进程结果消息经锁保护回传 |
+| **分层缓存** | enriched 读取时现算指标(存储仅 15 列基础数据,现算 68 列指标与信号)+ 进程内快照缓存;扩展字段按日分区快照,页面即配即用 |
+
+### 技术栈
+
+| 层 | 选型 |
+| :----------- | :------------------------------------------------------------------------------------------------ |
+| **后端** | FastAPI · Pydantic v2 · APScheduler · sse-starlette |
+| **数据** | Polars(计算)· DuckDB(查询)· Parquet(存储) |
+| **回测** | 自研仓位模拟引擎(T+1/费用/滑点/分钟回放)· vectorbt(部分路径) |
+| **数据源** | [TickFlow](https://tickflow.org/auth/register?ref=V3KDKGXPEA) 官方 SDK · fuyao(同花顺 REST) · 插件化扩展(stock-sdk 示例插件 · YAML 自定义源) |
+| **AI**(可选) | OpenAI 兼容接口(DeepSeek / 通义 / Ollama 等) |
+| **前端** | React 18 · Vite · TypeScript · Tailwind · Tanstack Query · [Lightweight Charts](https://www.tradingview.com/lightweight-charts/)(TradingView 开源) · ECharts · dnd-kit |
+| **部署** | Docker 两阶段构建,前端 dist 拷进后端镜像,**单容器** |
+
+---
## 🚀 快速开始
@@ -195,11 +291,11 @@ CODEX_CLI_VERSION=0.144.3 docker compose up --build
### 跑起来后的第一次使用
-1. **设置 → 凭据与能力** → 点 **重新检测**,确认档位标签
+1. **设置 → 凭据与能力** → 点 **重新检测**,确认档位标签与能力路由矩阵
2. **设置** → **立即跑盘后管道**:拉日 K + 计算 enriched 表(None / Free 走 free-api,当日数据盘后 1-2 小时可用)
3. **自选**页加标的 → **选股**页点策略卡片扫描 / 配自定义信号
-4. **回测**页选策略 + 区间 → 看净值 / 夏普 / 交易明细(SSE 实时进度)
-5. **监控中心**配规则,盘中实时弹窗 + 持久化记录
+4. **回测**页选策略 + 区间 → 看净值 / 夏普 / 交易明细(SSE 实时进度),结果可导出 CSV、存候选一键复测
+5. **监控中心**配规则,盘中实时弹窗 + 持久化记录;**异动监控**覆盖竞价/盘中/偏移全时段
---
@@ -217,30 +313,17 @@ PORT=3018 # 服务端口
---
-## 🏗️ 技术栈
-
-| 层 | 选型 |
-| :----------- | :------------------------------------------------------------------------------------------------ |
-| **后端** | FastAPI · Pydantic v2 · APScheduler · sse-starlette |
-| **数据** | Polars(计算)· DuckDB(查询)· Parquet(存储) |
-| **回测** | vectorbt(全项目唯一 pandas 边界) |
-| **数据源** | [TickFlow](https://tickflow.org/auth/register?ref=V3KDKGXPEA) 官方 SDK · 插件化扩展(stock-sdk 示例插件 · YAML 自定义源) |
-| **AI**(可选) | OpenAI 兼容接口(DeepSeek / 通义 / Ollama 等) |
-| **前端** | React 18 · Vite · TypeScript · Tailwind · Tanstack Query · Lightweight Charts · ECharts · dnd-kit |
-| **部署** | Docker 两阶段构建,前端 dist 拷进后端镜像,**单容器** |
-
----
-
## 🗺️ 路线图
| Phase | 内容 | 状态 |
| :----- | :----------------------------------------------------------------- | :--- |
| 0-1 | 仓库骨架 · FastAPI 壳 · 能力探测 · K 线同步与分析页 | ✅ |
-| 2-3 | Polars enriched 流水线 · Screener · vectorbt 回测(T+1/手续费/止损) | ✅ |
+| 2-3 | Polars enriched 流水线 · Screener · 回测引擎(T+1/手续费/止损) | ✅ |
| 4-5 | 监控引擎 · 四类监控规则 · 实时 SSE 推送 · 持久化记录 | ✅ |
| 6 | 个股分析(专用日 K + 9 类关键价位 + AI 四维分析) | ✅ |
| **v0.2** | 因子挖掘全链路 · 市场阶段与主线识别 · 异动监控 · 数据源插件化 | ✅ |
-| **v2** | Webhook 推送· 板块异动 · 早晚报 · 更多扩展 | 🚧 |
+| **v0.3** | 能力路由矩阵 · fuyao 数据源(财务/龙虎榜/风向标) · 分钟策略与回测 · 交易日探针 · 全时段异动中心 · 回测导出与候选复测 | ✅ |
+| **v2** | Webhook 推送· 板块异动 · 早晚报 · 全市场竞价采集 · 更多扩展 | 🚧 |
---
@@ -251,11 +334,11 @@ PORT=3018 # 服务端口
| [docs/deployment.md](./docs/deployment.md) | 部署方式(Dev / Docker / GH Actions)、老 CPU 兼容、更新代码、访问密码 |
| [docs/configuration.md](./docs/configuration.md) | 所有 `.env` 配置项详解(数据源、AI、服务、密码、数据目录) |
| [docs/features.md](./docs/features.md) | 各功能模块详细说明(选股/指标/回测/监控/个股分析/数据扩展) |
-| [docs/custom-data-source.md](./docs/custom-data-source.md) | 自定义数据源接入、YAML 配置与 mock 联调示例 |
+| [docs/custom-data-source.md](./docs/custom-data-source.md) | 自定义数据源接入、能力路由契约、YAML 配置与 mock 联调示例 |
| [docs/strategy.md](./docs/strategy.md) | 策略体系(18 内置策略 + 三种扩展方式 + 文件结构) |
| [docs/mining.md](./docs/mining.md) | 因子与策略挖掘口径、防泄漏、任务隔离和发布边界 |
| [docs/market-phase.md](./docs/market-phase.md) | 市场情绪周期 6 阶段与概念/行业主线识别的口径与设计 |
-| [docs/plugin-development.md](./docs/plugin-development.md) | 数据源插件开发规范(以 stock-sdk 为参考实现) |
+| [docs/plugin-development.md](./docs/plugin-development.md) | 数据源插件开发规范(以 stock-sdk / fuyao 为参考实现) |
| [docs/secondary-development.md](./docs/secondary-development.md) | 代码二次开发、前端插槽、后端策略接口与 AI 开发模板 |
| [backend/app/strategy/prompts/strategy-guide.md](./backend/app/strategy/prompts/strategy-guide.md) | 策略开发完整规范(AI 生成与手写) |
@@ -271,9 +354,36 @@ fork同时请点个star哦,欢迎 Issue 和 PR。
---
+## ❤️ 支持项目
+
+
+
+如果这个项目对你有帮助,欢迎请作者喝杯咖啡 ☕
+
+
+
+ | 微信赞赏 |
+ 支付宝 |
+
+
+  |
+  |
+
+
+
+愿道友一路长红 📈
+
+
|pP_5H&iBA$$PCEOr^m5G0bHdXZ7qpD?Kk6>r)fT1gi
zrOYkrC~|4gxEjx>Cy1}JfSqPmqqBCMMZAmJfT|#701$~k`2+cAE}WX-h2MT(HjVd@
zB`Bb*{dH-aQR#Q;tA^*GY=_5^60LCq1p@dpb?DsyL|$*m{F$B~O4I*m|Ne^_sfGQ0
z*BVwr9P1k?*grkU=$f1e))!8?XUTRZrqVM;Y+7;<
zXxj`kdK|-n(jUQ{9E{*how&eB(y(>oh@!C|%uzA)zuWCeqAeh3{(Hd~&xiZmnkdyR
z2iBN)lJ5fSr7o5ZAiQ{#qihj}1reOfU<6kzFV$_@ZUcnYl`x3%h$5TT+}O`3o*6q%
z7vkI}-F}(jI5WskkiTFMYh5#42Rk{2)MLxcQfO1Aw9CXbzuq5n$#!`}fwOGp(;Z!F
zA0ZJwkEEMhI6+lqm>!;Ku{%P#ej)&(;5l@(cnUbe3|#-piaU1Ji!2V)rDEa(M_!X$
z{9dy^e|2)>gSVHwie>!5n|!CE1#3Btk~49Po;}Q0fF5+4NIfd$j7~VoOu8cpNj$8w
z^I65rN}aKDpTD}o-W2**&a}T|uH1n~%t2;Kikp|GC0GcIj07GdI5jDYS>db2SB>UJ
zXS=_ysEqX)pL|Fu`qI3LO#fWdqj-hYn7jjZJawgn*_;owwtDR1Hp~|9n
zk%;2TX$s#G5fRFRlfd(F?JihUe?HE?y#4Q*0G;-+B9qoffzifguMnTUc7Cx;X;cPT
z@&JzgzLvxTg6DfWVE3}tx3YSq%g|1sWnU%+joC>(0&;rhg>A}htCVfaeJvw5-`;Z7
z_t2fYHE^7T3OzLOvXiHA8)ktCg77CioI3*UTjw##S_19?p?)^@QHNmUYb2bt^Jds*
z5C>Tj`!?hr!RYsWK-q>fQsD_TQ?mx;f%0fkTxDgY%5k+D^4s6)ua{QPN2mhP4nSae
z0qB=k*g^ZTlzmilzVq(-zJ$YTh2NQNyED&^xLciYr-5i*$6(*?(Sq+L^<~3%6PItY
z=ha*J+v*0SEqLO@ablJh?3Lc|c=m(JISFqHJ(kS&o19V1hufc9l*QnEr&VTX(aD^=
zyu*95szzP8cKH5w3xzwg72F-Zym4OvP)FZGtKH!TG6Pe^AD`9`3V=zDI3z<2AVYPS
z8r7^^4^<7Oe73C`xAdFdsXW(14l51HrLqT;YEnG+wi38vE=ef94G$%eg_4ZV(U{pK
zlqb;bR%nrz`bJD_6o-IX()o-YMfwem_Mr0yaxb|rPifz7eH<4x<-Vv6x$|hwbZ$*r
zE2hN2eR2(0U#ckv>a$PesIy1xNn)&JlE%yTv^L~mT{xrKY
zfX%hKbi93P%fVTJ?Voql=YGo!$@RT1Ra8PT1JQG&^h^iIz6qZW;vaygr=JcFlfd(u
ztz`-mm4z0VQtDc`>~{bm)I4a=8TJ9c1=uhb6|cp9m=&uP(Cm9dFVjbd>~tKVu3h=JnUecw7b~aOIc>knkGl-dg3Kg*A}V~aDa!!XOF>i+_Y(>9{*fvpO*yw5EI;t^R
z_r3xHzd$yF>cZg_p8xFizgPMB@7A%^TSA7^xqC{-jr>ti1u<>ts>+Z8P6C8k1U8wu
zI;c_ANA?e|bzG`8^L6KGTGy5|eb~2);>*Wo4}XpL+({p$aU2hmBF_04EacPi6UnCZ
zP6S`DHhxdKa~&a*uHsaqQ<)@3GCCM{#AR;qf>GIXj@`&#v54?pLmHE3W)p;p`vAG!
zMES3g+NStUOuh*J8(8=^H%WYmFgAz{!QOdUiN}KJx)?cOa$pAp0mJ_atoyJ}A#9C5
zqb~cgV9OlpWF+HC(b^3}v7L`1hrG5tZ6!xoWLX(^Ij-T@yF#TChoooC37vafTk6Y6
zI`I!$vv5SW(toD$yRvi
zUHa`_c-yr+pqKE}Kd)XJ*+lM+&f9wVryMZLOBXS=2&P0pTfEONo(+uaY@OXhD!59DxDLZj-
zJ_E*n8CM!R+c>!KJo@MAw+6E~cfTiMv&zB?j%-#qe``~pf)?$y)uTv)qw4&qCr-MR
z!o!zycx@S$Nr{KGLgh7J~oB&dI|y
z4l?+GNJq2Nxq#SDtyQ~}BSJ`3i#nv1SR{oV9eMgKa%D|yj}*QwC}0bs#0RLuNb*OW
z9`|+%P9TGVQ#PYb3f-6c*)|29Xw}eYlwGjdeyiVUfPkGH{?{P>
zE(Yv%)1IKA8ynG?173UT`)msDJCEz*W5k_PM>~}iG@^CY$=mUB``nk)r*As1X7|Bs
zd??~OFM|T<5seq6m;#@%UO(>M<@;M`Kw
zv5{|oAUT!9K&oOLVeCb>I@Og=&wivneHWBEt>~+|s;Mo~*c9{d?YJ*i)0Zr6p8I#8
zzS#eAiYxZOs?Q4Qhrqj1;JLGcVrkqkY9#Z4
zt5Dks3L9SpM!n`$U<)SS(z}Y7EjMR#g~Qa|lU=JVW^JxsV2D9rfqqKhn*BB8Iy^$fEq=A(3trkJL887Ys#e%ufvE
zM16~F3W2Wub?T?Db_H`cB#gHCGSV+%yMM74^CJt_f4E&htwRQ2P&7ce*S7v{CH{}z
z1%e>UfZ)Ro%Y-Ae;rg#k)=o6qv^N85u*A_$&d&MYZW!sQ
zJDn?7G2To(3h^<)qsO(9lK*Y4x!-wOm<^BE|IAbVzhf|2zZgwmFe$I0W|DDy3)oD&
zobR^?8Daj(G6ER$A1GaxER69D^klQ2zU|-+
z5>A7Q5y-K?vwvVf$*g*uJrllB7pw_oDXiqcqlmTxnLGVp`=kVK2ne1C7?Bvz7ow%WAv8i>#H#OD=%)n5$P
zMZ9oPI!5QU^3i6?BLGR4{>+f{4rWLQf(88
z_qhov+l*SqG;GyQl!7xK8x}}v+E)P-ly)zS3{bKefSom
zRQ?sBeCxz4dP_of*o!AmYSxeNpYyj=#3-M;l<^*AFbmolV|0*u_F79r{Ii4$ElXZ`
z13N%Y!rlujV`J@G>$jG7YOUM!#(LMruEPb?dRGWI^sXd90Wd|3dISx`v-72!j#PZa
zOL~I6>#RhhA=TXUGXDJWc=tLhaR^iee_GlI6~)rNg{H$ozic3rkONGX~pz)^kuC1H@zsLL#UQVA5cYhCH?WNT;2#P%={rh)B^^*zw5Zt4yuG#T
zQ0Jw?GGVb7d7C^CO{HpMb__A)pT_lVOcViF59SQ>Aj-yb$O{4;
z7dt0QVi*k%K&%Ez9PJEe6pB{z18mE&Svncfv8)=S-UU1N=Vaxlj5>NWn^~qB`;GEB
z2s7V;G9iyTnOw0|N+C~pi}aQBE@LcoP0~7vQ2e?JeH2oK?i_2!a=J7c2*pZ{W?lJ-MlMjU*NGHh{N6b
zucvN)EL~QaW`Rv1fZHt288U`m&_m(?nUWe+xEh%#ls{4X-ES2HLLSlCioSD8Q^n!tVcj%mfe8(Y0&r?ImOG35Dt>)G+U*B(WtwNiF7^GS&^;?T=3*eA5{f;9i%5OOXoCkE84w(aRT;R>nU*0UiF;b2WtAP78`nig&=zufR
z8FXe(Z3h>H4qp>EGyUJ!bfe|F_xlTrwbX;_JU2GpATRphW2P4#2x3%&?xXW10CL@u
zv18=oq;BSKsWKLxDf@+pab%2RJV6=g^KU&E3oBp1gkbMZp&$entFx8d>_Mr`DQ5mL0x9+T4?IIrKf2LZ(;L|-1nAANsFex
zl{MKu-T@hpg*si`Tr3kRw&Pp5)wdt}D3sf#qL7^2C7Y)9o|^OG?Tn;sNEYb;+9)mn
z3*{FFpov_f4OIsxX>#!f6ThfmS