Initial commit: 龙虾舰队监控中心
This commit is contained in:
170
docs/需求文档.md
Normal file
170
docs/需求文档.md
Normal file
@@ -0,0 +1,170 @@
|
||||
# 监控网站需求文档
|
||||
|
||||
## 📋 项目信息
|
||||
|
||||
- **项目名称**: 龙虾舰队监控中心
|
||||
- **创建日期**: 2026-04-01
|
||||
- **当前状态**: 🟡 需求讨论中
|
||||
- **访问地址**: http://localhost:18001
|
||||
|
||||
---
|
||||
|
||||
## 🎯 核心需求（请确认）
|
||||
|
||||
### 1. 状态监控 ⭐⭐⭐
|
||||
- [ ] 显示所有龙虾的运行状态
|
||||
- [ ] 健康状态用颜色区分（绿色=健康，红色=异常）
|
||||
- [ ] 每 5 秒自动刷新
|
||||
- [ ] 统计卡片（总数/健康/警告/异常）
|
||||
|
||||
### 2. 基本信息展示 ⭐⭐⭐
|
||||
- [ ] 龙虾名称
|
||||
- [ ] 专长描述
|
||||
- [ ] 监听端口
|
||||
- [ ] 运行状态
|
||||
|
||||
### 3. 记忆查看 ⭐⭐
|
||||
- [ ] 点击龙虾卡片查看详情
|
||||
- [ ] 查看每个龙虾的 MEMORY.md
|
||||
- [ ] 查看最近的每日记忆文件
|
||||
- [ ] 支持按日期查看记忆
|
||||
|
||||
---
|
||||
|
||||
## 🦞 龙虾列表（请确认）
|
||||
|
||||
| 龙虾 | 端口 | 专长 | 飞书应用 | 状态 |
|
||||
|------|------|------|----------|------|
|
||||
| 飞行侠 | 18789 | 主力/通用 | IT 项目推广运营平台 | ✅ |
|
||||
| 道童 | 18889 | 道德经注解 | 道德经新解 | ✅ |
|
||||
| 墨子 | 18689 | 代码专家 | - | ✅ |
|
||||
| 织网者 | 18589 | 网站制作 | - | ✅ |
|
||||
| 费曼 | 18989 | 物理研究 | - | ✅ |
|
||||
| 守望者 | 18080 | 舰队监控 | - | ✅ |
|
||||
|
||||
---
|
||||
|
||||
## 📁 功能需求（请确认）
|
||||
|
||||
### 必需功能
|
||||
- [ ] 龙虾状态卡片展示
|
||||
- [ ] 点击卡片查看记忆详情
|
||||
- [ ] 记忆弹窗/详情页
|
||||
- [ ] 长期记忆 (MEMORY.md) 显示
|
||||
- [ ] 每日记忆列表显示
|
||||
|
||||
### 可选功能（需要确认是否需要）
|
||||
- [ ] 记忆日历组件
|
||||
- [ ] 技能列表显示
|
||||
- [ ] 飞书应用名称显示
|
||||
- [ ] 龙虾详情独立页面
|
||||
- [ ] 重启龙虾按钮
|
||||
- [ ] 查看日志按钮
|
||||
|
||||
### 不需要功能（已确认移除）
|
||||
- [x] Gitea Git 服务（独立项目）
|
||||
- [x] Git 访问指南页面
|
||||
- [x] 复杂的动画效果
|
||||
|
||||
---
|
||||
|
||||
## 🎨 界面需求（请确认）
|
||||
|
||||
### 布局
|
||||
- [ ] 顶部：标题 + 统计卡片
|
||||
- [ ] 中部：龙虾卡片网格
|
||||
- [ ] 底部：更新时间
|
||||
|
||||
### 卡片设计
|
||||
- [ ] 龙虾名称 + Emoji
|
||||
- [ ] 状态指示器（颜色圆点）
|
||||
- [ ] 信息行：专长、端口、状态
|
||||
- [ ] 操作按钮：记忆、日志、重启
|
||||
|
||||
### 弹窗/详情页
|
||||
- [ ] 龙虾名称标题
|
||||
- [ ] 长期记忆内容
|
||||
- [ ] 每日记忆列表
|
||||
- [ ] 关闭按钮
|
||||
|
||||
---
|
||||
|
||||
## 🔧 技术需求（请确认）
|
||||
|
||||
### 前端
|
||||
- [ ] 纯 HTML/CSS/JavaScript
|
||||
- [ ] 不需要复杂框架
|
||||
- [ ] 自动刷新（5 秒）
|
||||
- [ ] 内网访问
|
||||
|
||||
### 后端 API
|
||||
- [ ] Django REST API
|
||||
- [ ] 端口：18081
|
||||
- [ ] 接口：
|
||||
- `GET /api/status` - 获取所有龙虾状态
|
||||
- `GET /api/memory/{name}` - 获取特定龙虾记忆
|
||||
- `GET /api/memory/{name}/dates` - 获取记忆日期列表
|
||||
- `GET /api/memory/{name}/{date}` - 获取指定日期记忆
|
||||
|
||||
### 服务管理
|
||||
- [ ] 前端服务：18001
|
||||
- [ ] 记忆 API: 18081
|
||||
- [ ] 日志文件：`/tmp/frontend.log`, `/tmp/memory-api.log`
|
||||
|
||||
---
|
||||
|
||||
## 📝 待确认问题
|
||||
|
||||
### 问题 1: Gitea 服务
|
||||
**现状**: 已安装 Gitea（端口 18003）
|
||||
**问题**: 是否需要保留？
|
||||
- [ ] 保留（作为独立项目）
|
||||
- [ ] 移除（只保留监控功能）
|
||||
|
||||
### 问题 2: 记忆查看方式
|
||||
**现状**: 点击卡片打开弹窗
|
||||
**问题**: 是否需要独立详情页？
|
||||
- [ ] 弹窗（当前方式）
|
||||
- [ ] 独立页面
|
||||
- [ ] 两者都要
|
||||
|
||||
### 问题 3: 龙虾详情
|
||||
**现状**: 已创建飞行侠详情页
|
||||
**问题**: 是否需要为每只龙虾创建独立页面？
|
||||
- [ ] 需要
|
||||
- [ ] 不需要（弹窗即可）
|
||||
|
||||
### 问题 4: 飞书应用信息
|
||||
**现状**: 显示飞书应用名称
|
||||
**问题**: 是否需要显示？
|
||||
- [ ] 显示
|
||||
- [ ] 不显示（超出原始需求）
|
||||
|
||||
---
|
||||
|
||||
## 📊 当前问题（需要修复）
|
||||
|
||||
- [ ] 记忆功能可能无法正常使用
|
||||
- [ ] 页面过于复杂
|
||||
- [ ] 添加了超出需求的功能
|
||||
|
||||
---
|
||||
|
||||
## ✅ 确认签字
|
||||
|
||||
**待确认**:
|
||||
- [ ] 核心需求确认
|
||||
- [ ] 功能列表确认
|
||||
- [ ] 界面设计确认
|
||||
- [ ] 技术方案确认
|
||||
|
||||
**确认人**: 北极星 ⭐
|
||||
**确认日期**: ___________
|
||||
|
||||
---
|
||||
|
||||
## 📝 变更记录
|
||||
|
||||
| 日期 | 变更内容 | 状态 |
|
||||
|------|----------|------|
|
||||
| 2026-04-01 | 创建需求文档 | 🟡 讨论中 |
|
||||
Reference in New Issue
Block a user