abdullahijaz5961/aegispulse-incident-response
GitHub: abdullahijaz5961/aegispulse-incident-response
AegisPulse 是一个事件指挥与服务可靠性平台，通过严重程度分级、责任人指派、时间线追踪和 Runbook 指导，帮助团队在统一工作区中完成重大事件的分流、确认与解决。
Stars: 0 | Forks: 0
# AegisPulse
### 具备证据、归属和恢复规范的重大事件指挥系统。
在一个统一的工作区中检测、分流、确认并解决服务重大事件。
## 项目存在的意义
监控工具会生成告警，但团队仍然需要一个责任明确的事件处理流程。AegisPulse 在原始告警的基础上，增加了严重程度、责任人、时间线事件、Runbook 指导和解决证据。
## 已实现的功能
- 事件生命周期：打开、已确认、已解决
- 基于严重程度的优先级划分
- 服务健康和可靠性摘要
- 确定性的 Runbook 建议
- 事件时间线和解决说明
- 运营指挥仪表盘
- REST API、测试、Docker 和 CI
## 架构
```
Browser (HTML/CSS/JavaScript)
│ REST/JSON
▼
FastAPI application ── SQLAlchemy ── SQLite/PostgreSQL
│
├── domain services
├── validation and state transitions
└── health and operational endpoints
```
本仓库将传输层、领域逻辑、持久层和表现层进行了分离。请参阅 [`docs/architecture.md`](docs/architecture.md) 以及 [`docs/decisions`](docs/decisions) 中的架构决策记录。
## 技术栈
| 层级 | 选择 |
|---|---|
| Frontend | Semantic HTML, modern CSS, browser JavaScript |
| Backend | FastAPI, Pydantic, SQLAlchemy |
| Database | 本地使用 SQLite；兼容 PostgreSQL 配置 |
| Quality | Pytest, GitHub Actions |
| Packaging | Docker, Docker Compose |
## 使用 Docker 运行
在仓库根目录下执行：
```
docker compose up --build
```
打开：
- Web 界面：`http://localhost:5173`
- API 文档：`http://localhost:8000/docs`
- 健康检查端点：`http://localhost:8000/health`
## 在 VS Code 中本地运行
### Backend 终端
```
cd backend
python -m venv .venv
```
Windows PowerShell：
```
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
uvicorn app.main:app --reload
```
### Frontend 终端
```
cd frontend
python -m http.server 5173
```
## 验证
```
cd backend
pytest -q
cd ../frontend
node --check assets/app.js
```
## 仓库结构图
```
backend/ FastAPI application and tests
frontend/ Dependency-free web dashboard
docs/ Architecture, API, roadmap, screenshots
.github/ Continuous integration workflow
docker-compose.yml
```
## 工程说明
Runbook 指导是基于规则且透明的。它不执行自动修复。未来的任何自动化操作都应要求明确的批准、受限的操作以及完整的审计追踪。
## 路线图
添加 Prometheus 数据接入、Slack/PagerDuty 适配器、SLO 消耗率告警以及已批准的修复操作。
## 许可证
MIT 许可证。详见 [`LICENSE`](LICENSE)。标签：AV绕过, Docker, FastAPI, SRE, 事件管理, 偏差过滤, 可靠性工程, 多模态安全, 安全防御评估, 数据可视化, 测试用例, 版权保护, 网络测绘, 请求拦截, 运维监控, 逆向工具