> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akria.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 工作规划 | Work Plan

> Situation Monitor 第一周工作计划和任务分配

# 📅 工作规划 | Work Plan

本文档定义了 Situation Monitor 项目第一周的详细工作计划和任务分配。

<Warning>
  本周的核心目标是建立完整的最小数据流水线，打通从数据采集到信号推送的全链路。
</Warning>

## 🎯 本周总体目标 | Overall Goal

建立完整的最小数据流水线：

**能稳定抓取数据 → 清洗结构化 → 生成基础信号 → 推送到 Telegram**

<Tip>
  哪怕信号规则很简单，也必须打通全链路。这是项目从想法变成系统的关键一步。
</Tip>

## 🧩 各组目标与任务 | Team Goals & Tasks

### ✅ A 组：数据采集层 | Data Collection Layer

**🎯 本周目标**

至少接入 2 类核心数据源：

* 市场行情
* GMGN 新币数据

并能定时写入数据库。

#### 📌 任务清单

<AccordionGroup>
  <Accordion title="A1. 行情采集服务" icon="chart-line">
    **对接 Binance 或 OKX API**

    拉取数据：

    * BTC / ETH 价格
    * 5分钟涨跌幅
    * 成交量

    输出到表：`raw_market_data`

    字段：

    * `symbol`
    * `price`
    * `volume`
    * `change_5m`
    * `fetch_time`
  </Accordion>

  <Accordion title="A2. GMGN 数据采集" icon="database">
    **抓取新币数据**

    抓取内容：

    * 新币列表
    * 持币人数
    * 开盘时间

    输出到表：`raw_gmgn_tokens`

    字段：

    * `token`
    * `launch_time`
    * `holder_count`
    * `fetch_time`
  </Accordion>

  <Accordion title="A3. APScheduler 调度" icon="clock">
    **定时任务配置**

    调度频率：

    * 行情：每 5 分钟
    * GMGN：每 5 分钟

    必须支持：

    * 超时处理
    * 错误日志
  </Accordion>
</AccordionGroup>

#### ✅ 验收标准

* [ ] 数据库每 5 分钟新增记录
* [ ] 容器重启后自动恢复调度

***

### ✅ B 组：清洗与结构化 | Data Cleaning & Structuring

**🎯 本周目标**

把原始数据转为分析可用格式。

#### 📌 任务清单

<AccordionGroup>
  <Accordion title="B1. 市场数据清洗" icon="filter">
    **从 raw\_market\_data 生成 clean\_market**

    表：`clean_market`

    字段：

    * `symbol`
    * `price`
    * `change_5m`
    * `volume_spike` (bool)
    * `timestamp`

    规则：

    * 成交量 > 过去均值 2x → `volume_spike = true`
  </Accordion>

  <Accordion title="B2. GMGN 清洗" icon="filter">
    **从 raw\_gmgn\_tokens 生成 clean\_tokens**

    表：`clean_tokens`

    字段：

    * `token`
    * `launch_minutes`
    * `holder_count`
    * `is_hot` (bool)

    规则：

    * 开盘 \< 120 分钟 且 holder > 500 → `is_hot = true`
  </Accordion>
</AccordionGroup>

#### ✅ 验收标准

* [ ] clean 表持续产生新数据
* [ ] 字段全部结构化

***

### ✅ C 组：信号分析层 | Signal Analysis Layer

**🎯 本周目标**

实现最小可用信号生成。

#### 📌 任务清单

<AccordionGroup>
  <Accordion title="C1. 市场异动信号" icon="exclamation-triangle">
    **触发条件**

    BTC 或 ETH：

    * `change_5m > 1.5%`
    * 或 `volume_spike = true`

    生成信号：

    * `signal_type`: `opportunity`
    * `priority`: `medium`
  </Accordion>

  <Accordion title="C2. 新币机会信号" icon="lightbulb">
    **触发条件**

    `clean_tokens.is_hot = true`

    生成信号：

    * `signal_type`: `opportunity`
    * `priority`: `low`
  </Accordion>

  <Accordion title="C3. signals 表" icon="database">
    **创建 signals 表**

    字段：

    * `signal_id`
    * `type`
    * `priority`
    * `title`
    * `summary`
    * `timestamp`
  </Accordion>
</AccordionGroup>

#### ✅ 验收标准

* [ ] 数据变化时能生成 signals 记录

***

### ✅ D 组：推送与接口层 | Notification & Interface Layer

**🎯 本周目标**

实现 signals → Telegram + Ghost 草稿，打通情报分发与内容产品层。

<Info>
  D 组不只是"推送机器人"，而是情报分发与内容产品层，目标是让信号既能即时提醒，又能沉淀为可阅读内容。
</Info>

#### 🧩 D 组模块拆分

<CardGroup cols={3}>
  <Card title="实时推送模块" icon="paper-plane">
    Telegram Bot 推送
  </Card>

  <Card title="内容生成模块" icon="file-lines">
    Ghost CMS 集成
  </Card>

  <Card title="编排与专题" icon="layer-group">
    内容聚合机制
  </Card>
</CardGroup>

#### 📌 任务清单

<AccordionGroup>
  <Accordion title="D1. Telegram 推送（必须完成）" icon="paper-plane">
    **功能要求**

    * 接收 signals
    * 根据优先级推送（priority ≥ medium）
    * 格式化消息：
      ```
      🚨 市场异动
      BTC 5分钟涨幅 1.8%
      建议关注短线波动
      ```
    * 同类信号 10 分钟内合并
    * 避免刷屏
  </Accordion>

  <Accordion title="D2. Ghost API 对接（重点）" icon="ghost">
    **Ghost Admin API 集成**

    本周最低能力：

    * 接收 signals
    * 生成文章草稿
    * 发布为 draft 状态

    字段映射：

    | Signal 字段 | Ghost 文章     |
    | --------- | ------------ |
    | title     | post.title   |
    | summary   | post.excerpt |
    | evidence  | post.html 内容 |

    文章结构模板：

    ```markdown theme={null}
    ## 事件概览
    {{summary}}

    ## 触发原因
    - 市场数据：{{market_reason}}
    - 链上行为：{{token_reason}}

    ## 风险提示
    当前风险等级：{{risk_level}}

    ## 建议
    {{suggested_action}}
    ```
  </Accordion>

  <Accordion title="D3. 专题标签机制" icon="tags">
    **Ghost Tags 支持**

    本周至少支持：

    * `market` - 市场异动
    * `new-token` - 新币机会
    * `sentiment` - 舆情分析

    后续可以做专题页聚合。
  </Accordion>
</AccordionGroup>

#### ✅ 验收标准

* [ ] Telegram 能收到真实推送
* [ ] Ghost 后台有自动生成的草稿文章
* [ ] 不刷屏，推送有价值

<Warning>
  **重要架构原则**：不要让 C 组直接写 Ghost。正确链路是 C 组 → signals 表，D 组 → 消费 signals → 分发到 Telegram / Ghost。否则分析层会被内容逻辑污染。
</Warning>

***

## 🧱 基础设施任务 | Infrastructure Tasks

<Steps>
  <Step title="K3s 命名空间">
    创建 `situation-monitor` 命名空间
  </Step>

  <Step title="服务部署">
    每组一个 Deployment
  </Step>

  <Step title="数据库">
    Postgres StatefulSet
  </Step>
</Steps>

## 🚫 本周不做的事情 | Out of Scope

为了防止范围膨胀，本周明确禁止：

<CardGroup cols={2}>
  <Card title="前端面板" icon="ban">
    不做前端面板
  </Card>

  <Card title="Twitter 接入" icon="ban">
    不接 Twitter
  </Card>

  <Card title="AI 分析" icon="ban">
    不做 AI 分析
  </Card>

  <Card title="用户系统" icon="ban">
    不做用户系统
  </Card>
</CardGroup>

**本周只做**：数据 → 信号 → 推送

## 🎯 周末验收目标 | Weekend Acceptance Criteria

周末你应该能看到：

<AccordionGroup>
  <Accordion title="市场波动提醒" icon="bell">
    市场波动时手机收到提醒
  </Accordion>

  <Accordion title="新币提示" icon="lightbulb">
    新币出现时有低优先级提示
  </Accordion>

  <Accordion title="内容沉淀" icon="file-lines">
    Ghost 后台有自动生成的文章草稿
  </Accordion>
</AccordionGroup>

<Tip>
  如果这一步打通，项目就已经从想法变成系统了。
</Tip>

## 🧠 项目负责人关注点 | Key Focus Areas

作为项目负责人，本周只需要盯三件事：

1. **各组是否真的在写入数据库**
2. **是否真的生成了 signals**
3. **推送是否有价值**（哪怕很粗糙）

<Danger>
  技术都能补，信号价值才决定这个项目值不值得继续。
</Danger>

## 📚 相关文档 | Related Documentation

<CardGroup cols={2}>
  <Card title="态势监控系统" icon="radar" href="/guides/project-vision/situation-monitor">
    了解系统整体架构
  </Card>

  <Card title="接口规范" icon="plug" href="/guides/project-vision/situation-monitor-interfaces">
    模块接口与数据流规范
  </Card>

  <Card title="信号结构" icon="signal" href="/guides/project-vision/situation-monitor-signals">
    signals.json 核心协议定义
  </Card>

  <Card title="部署指南" icon="rocket" href="/technical/infra-deploy/deployment-guide">
    服务部署操作指南
  </Card>
</CardGroup>

<Note>
  下一步计划：Week 2 工作计划（加入舆情 + 初级 AI）、各组 Repo 结构与 GitHub 协作规范、数据库表结构完整版 SQL。
</Note>
