feat: 投资资讯日报查询页 + 文档更新 + 拉取服务器最新内容

- 新增 charts/news_reports.php 报告查询导航页(列表+详情一体,fetch API 渲染)
- 新增 js/newsReports.js:AI 摘要/新闻联播/财经新闻/公告调研/数据总览固定模块,stats 归一化兼容多种格式
- index-2.php 研究报告卡片改为导航链接,移除 PHP 目录下拉框
- 更新 AGENTS.md/CLAUDE.md(路径、页面清单、数据模式等核实修正)
- 同步服务器拉取的文档:quant 使用手册、podcast-docs
- 生成 continuation.md 会话检查点
This commit is contained in:
2026-08-05 20:28:57 +08:00
parent 60fb1b95e1
commit 8ea9b48a9a
10 changed files with 1717 additions and 128 deletions
+28 -22
View File
@@ -32,26 +32,30 @@
- `tradeRec.inc.php` — 交易记录查询(`trade_record` / `trade_record_cj` 表)。
- `excelOperate.inc.php` — 通过 PhpSpreadsheet 读取 Excel/CSV 文件。
- `postJson.inc.php` — 使用 cURL 发送 JSON HTTP POST 请求。
- `getEstate.inc.php` — 房地产相关数据查询(`estate_listing` 表)及二手房成交/挂牌数据函数
- `getEstate.inc.php` — 房地产相关数据查询(`estate_json``estate_json_ext``estate_listing` 表)及二手房成交/挂牌数据函数(`esfTradeDaily``esfListDaily`
- `upload.php` — 文件上传处理。
- `plansetup.php` — 用于 Composer autoload 的快捷入口(`__DIR__."/../vendor/autoload.php"`)。
> 数据库表全量清单(16 张表、在用/未用/已由 API 替代状态)见根目录 `DB_REFERENCE.md`。
### 页面结构
根目录及 `charts/` 下的每个 `.php` 文件渲染一个独立的数据视图,存在种数据获取模式:
根目录及 `charts/` 下的每个 `.php` 文件渲染一个独立的数据视图,存在种数据获取模式:
**模式 A传统——服务端注入):**
1. 引入所需的 `inc/*.php`
2. 通过 `$_REQUEST` 接收查询参数
3. PHP 查询数据库,将结果通过 `json_encode()` 注入 `<script>` 标签内的 `window.chartConfig`
4. 引入对应的 `js/*.js`JS 读取 `window.chartConfig` 后用 `echarts.init()` 渲染
5. 引入 `html/head.php``html/footer.php` 组成页面布局
**模式 A(服务端注入):**
1. 引入所需的 `inc/*.php`,通过 `$_REQUEST` 接收查询参数
2. PHP 查询数据库,将结果通过 `json_encode()` 注入 `<script>` 标签内的 JS 变量
3. 引入对应的 `js/*.js` 渲染
4. 注意:`window.chartConfig` 全局变量**仅剩 `deprecated/` 在用**;活跃页面中 `charts/chartStDetail.php` 是变体(注入命名变量 `data1``data5`
**模式 B(较新——JS fetch 调用外部 API):**
1. 页面直接加载 JS,不注入数据
2. JS 在 `$(document).ready` 中通过 `fetch()` 调用 `https://api.doorcome.cn/api/*` 获取数据
3. 渲染逻辑与模式 A 相同
4. 代表页面:`stock_trend.php``stockdiv.php``stockep.php``stockmargin.php``hkholdbycode.php`
2. JS 在 `$(document).ready` 中通过 `fetch()` 调用 `https://api.doorcome.cn/api/*`(如 `stockparam``indexDatas``stockinfo``getdiv``stockep``stockmargin``stockbasic`获取数据
3. 代表页面:`stock_trend.php``stockdiv.php``stockep.php``stockmargin.php``hkholdbycode.php``index_trend.php``index_mv_all.php``index_margin.php`
**模式 CAJAX → `inc/ajax.inc.php`):**
1. 页面 JS 用 `$.ajax``../inc/ajax.inc.php`,通过 `$_REQUEST['t']` 路由(if 链):`stockList``financeData``esfTBD``esfListDaily``newTBD``moneyflowData``estateData`
2. 代表页面:`moneyflow.php``realestate.php``estateTradeDaily.php``estateListDaily.php``estateNewTradeDaily.php``stockkeydata.php``stockTradeRecord.php`
### 页面目录
@@ -66,10 +70,8 @@
| `charts/stockdiv.php` | 股价 VS 股息率 |
| `charts/stockmargin.php` | 股价 VS 融资融券余额 |
| `charts/hkholdbycode.php` | 股价 VS 北向资金持股 |
| `charts/stock_ih.php` | 股价 VS 机构持仓趋势 |
| `charts/stockkeydata.php` | 个股基本面数据 |
| `charts/index_trend.php` | 指数 VS PE/PB/PS/市值 |
| `charts/index_ih.php` | 指数 VS 机构持仓趋势 |
| `charts/index_mv_all.php` | 指数 VS 两市总市值 |
| `charts/index_margin.php` | 指数 VS 融资余额 |
| `charts/moneyflow.php` | 指数 VS 沪深港通资金流向 |
@@ -78,13 +80,14 @@
| `charts/estateTradeDaily.php` | 二手房每日成交量(宁波) |
| `charts/estateListDaily.php` | 二手房每日挂牌量(宁波) |
| `charts/stockTradeRecord.php` | 个人股票交易记录 |
| `charts/chartStDetail.php` | 个股详细图表 |
| `charts/chartSix.php` | 个股 VS 机构持仓(持股数/金额/比例 |
| `charts/chartThree.php` | 指数 VS 机构持仓(分类型:基金/QFII/社保等) |
| `charts/myexcel.php` | 交易记录 Excel/CSV 导入处理(配合上传流程) |
| `charts/chartStDetail.php` | 个股详细图表(服务端注入命名变量 data1…data5 |
> 注:`stock_ih.php`、`index_ih.php`、`chartSix.php`、`chartThree.php` 及旧版 `stock_trend.php`/`index_trend.php`/`index_mv_all.php` 已移入 `deprecated/`,勿引用。
### JavaScript 约定
每个页面加载 `js/` 中对应的 JS 文件(如 `chartStDetail.js``renderCharts.js``estate.js`)。新版页面通过 `window.chartConfig` 对象传递数据,旧版页面正逐步迁移至此模式。ECharts 库统一使用 `lib/echarts/5.4.2/echarts.js`v5)。
每个页面加载 `js/` 中对应的 JS 文件(如 `chartStDetail.js``renderCharts.js``pubfunc.js``adj.ajax.js`)。新式图表页面复用 `js/renderCharts.js``doubleLineChart()` 等)和 `js/pubfunc.js``getRows()``hideSwitch()` 等)。ECharts 库统一 `/lib/js/echarts-5.4.2.js`v5引用。`window.chartConfig` 传递模式仅存于 `deprecated/`
### 子模块
@@ -96,9 +99,10 @@
### 前端库位置
- `lib/` — jQuery、DataTables、ECharts 5.4.2
- `libai/` — Chart.js、anime.js、shader-park-coreAI/研究页面使用)
- `js/`页面专属图表逻辑、Tailwind CSS 3.4.17、ECharts GL、ecStat
- `lib/js/` — jQuery 3.6.0、DataTables 1.13.4、ECharts 5.4.2`echarts-5.4.2.js`)、ECharts GL、ecStat、Tailwind CSS 3.4.17`tailwindcss-3.4.17.js`)、Chart.js、anime.js、marked、mermaid 等第三方库
- `lib/css/``lib/webfonts/` — 第三方 CSS 与字体
- `libai/`shader-park-coreAI/研究页面使用)
- `js/` — 页面专属图表逻辑(不含第三方库)
- `css/` — 自定义样式(`style.css``css2.css`)、Font Awesome
## 常用命令
@@ -112,9 +116,11 @@ php -l charts/stock_trend.php
composer update # 更新依赖
composer dump-autoload # 更新 autoload
# 部署到远程服务器(~/.bashrc 中定义
# 部署到远程服务器(脚本位于 ~/bin/sync-echartrsync 单向推送本地 → 服务器
sync-echart -n # 预览(dry-run
sync-echart # 执行同步部署到 www.doorcome.cn
sync-echart # 执行部署到 simon@www.doorcome.cn:/var/www/html/echart/
# 排除项: .git/.vscode/.claude/.serena/.mcp.json/reasonix.toml
# 以及数据/产物目录 uploads/xls/files/research/podcast/podcast-docs(服务器为权威,不覆盖)
# 批量 PHP 语法检查(修改多个文件后)
for f in charts/*.php; do php -l "$f"; done