mohammed-saad-git/vanguard-core

# Vanguard-Core: GenAI 体育场指挥与控制编排器 ## 🏟️ 项目概述 **Vanguard-Core** 是一个高级的指挥与控制 (C2) 事件运营仪表板，专为 **2026 年 FIFA 世界杯** 设计。它利用 **Google Gemini 3.5** 来接收实时的体育场遥测数据（例如人群密度级别、比赛阶段和员工事件日志），并动态协调应急响应计划、动态人群重新引导以及多语言的公共广播 (PA) 语音播报。 它采用优质的深色主题指挥中心界面，确保快速、自动化且安全的人群控制流程，从而保障球迷安全并优化物流。 ## ⚡ 核心功能 * **数据采集门户**：支持实时员工遥测日志、比赛阶段和目标体育场预设。 * **动态遥测网格地图**：基于 SVG 的交互式可视化，显示各区域占用密度（低、中、高、危急）以及实时的球迷重新引导路径指示。 * **结构化严重性评估**：利用 Gemini JSON schema 即时确定事件的紧急程度、影响范围和优先级。 * **战术行动计划**：自动生成循序渐进的响应人员指令和志愿者部署指南。 * **PA 音频广播模拟器**：本地文本转语音音频模拟，支持将紧急警报翻译成英语、西班牙语以及参赛队伍的母语（如德语、葡萄牙语、日语）。 * **事件历史审计日志**：持久化的历史记录表格，允许操作员审查或恢复过去的战术决策。 ## 🛡️ 生产级安全标准 专为在严格的运营条件下部署而设计，Vanguard-Core 实施了关键的安全防御措施： 1. **Prompt Injection 缓解**：Gemini prompt 模板中严格的数据边界指令强制模型将变量严格视为不受信任的数据输入，忽略劫持命令。 2. **内存中 Rate Limiting**：REST endpoint 的 rate limiting（每个 IP 每分钟最多 15 个请求），以防止针对 API 的暴力垃圾请求。 3. **OWASP 安全 Headers**：自定义 Express middleware，用于配置 `X-Content-Type-Options`、`X-Frame-Options`、`X-XSS-Protection`、`Referrer-Policy` 以及作用域内的 `Content-Security-Policy`。 4. **Payload 验证与清理**：限制 body 解析大小（`10kb`），根据允许的枚举严格验证字段，并剥离恶意的 HTML/JS 脚本以防止跨站脚本攻击 (XSS)。 ## 🛠️ 技术栈 * **Frontend**：React (v19)、Tailwind CSS、Lucide React Icons、HTML5 Canvas/SVG、SpeechSynthesis API。 * **Backend**：Node.js、Express、TypeScript（`tsx` 运行环境）、`@google/genai`（Gemini SDK）。 * **构建/开发**：Vite、ESBuild、TypeScript Compiler。 ## 🚀 快速开始 ### 前置条件 * [Node.js](https://nodejs.org/) (v18+) * NPM (v9+) ### 安装与本地运行 1. **克隆代码仓库** git clone https://github.com/mohammed-saad-git/vanguard-core.git cd vanguard-core 2. **安装依赖** npm install 3. **配置环境变量** 在根目录下创建一个 `.env.local` 文件： GEMINI_API_KEY="your_gemini_api_key_here" PORT=3000 *注意：如果未指定 API key，Vanguard-Core 将自动激活其离线模拟回退模式。* 4. **启动开发服务器** npm run dev 在浏览器中打开 **[http://localhost:3000](http://localhost:3000)** 以查看应用程序。 5. **构建并在生产环境中运行** npm run build 启动生产服务器： npm start ## 🏗️ 文件夹结构 ``` vanguard-core/ ├── src/ │ ├── components/ # UI Components (Header, Map, Ingestion Form, Audit Trail) │ │ ├── BroadcastSimulator.tsx │ │ ├── Header.tsx │ │ ├── IncidentAuditTrail.tsx │ │ ├── PresetScenarios.tsx │ │ ├── StadiumMap.tsx │ │ └── TelemetryForm.tsx │ ├── App.tsx # Main App Entry and state orchestration │ ├── data.ts # Stadium details and scenario preset data │ ├── types.ts # TypeScript Interfaces │ └── main.tsx ├── server.ts # Secured Express API Backend & Vite dev server integration ├── vite.config.ts # Bundler Configurations ├── tsconfig.json # TypeScript Options └── package.json ```

标签：HTTP/HTTPS抓包, MITM代理, 公共安全, 前端可视化, 应急管理, 态势感知, 指挥调度系统, 自动化攻击