Meteor Fullstack - Distributed Monitoring Network
Overview
Meteor Fullstack 是一个覆盖边缘设备、云端 API、数据处理和 Web 前端的完整流星监测网络。仓库采用 npm workspace 管理前后端，并通过 Go、Rust 等多语言组件连接实时观测、事件验证和观测结果展示。
System Topology
meteor-edge-client/：Rust 编写的边缘客户端 CLI（命令在src/main.rs），负责摄像头采集、事件检测与上传，核心运行循环位于src/app.rs::Application::run。meteor-web-backend/：NestJS Web API，入口src/main.ts启动AppModule，聚合认证、设备注册、事件存取、支付与指标等子模块，持久化通过 TypeORM/PostgreSQL。meteor-frontend/：Next.js 15 应用（App Router），入口src/app/layout.tsx，主要页面位于src/app/dashboard|gallery|analysis等目录，使用 React Query 与自建服务交互。meteor-compute-service/：Go 处理服务，入口cmd/meteor-compute-service/main.go，从 SQS 拉取事件、执行校验并写入数据库，辅以 CloudWatch 指标与健康检查。infrastructure/：Terraform 定义 S3、SQS、CloudWatch、RDS/VPC 等资源，为各服务提供统一云端环境。
Execution Entry Points
- 边缘采集：
meteor-edge-client/src/main.rs解析 CLI（Run子命令），构造Application，根据camera参数（例如sim:pattern:meteor）覆盖配置并启动摄像头、检测、存储、心跳等控制器。 - Web API：
meteor-web-backend/src/main.ts通过NestFactory启动服务，AppModule汇集devices,events,metrics等模块；Socket 网关与定时任务由ScheduleModule提供。 - 前端应用：
meteor-frontend/src/app/page.tsx定义默认仪表盘；路由由app/目录自动生成，services/封装 API 调用，contexts/提供跨页面状态。 - 计算服务：
meteor-compute-service/internal/processor中的Processor.Start协程消费 SQS 消息，配合internal/validation动态加载检测策略。
Data Flow Summary
- 边缘设备通过
meteor-edge-client run --camera …捕获帧，storage模块归档事件，communication模块将打包结果上传后端。 - NestJS 后端在
events与devices模块中接收上传，写入事件表并向 SQS 推送需要进一步分析的数据。 - Go 计算服务从 SQS 获取消息，调用验证提供者生成分析结果，再回写数据库并发送 CloudWatch 指标。
- 前端通过 React Query 请求 NestJS API，展示仪表盘、图库与分析视图，实现实时监控闭环。
Development Workflow
npm run install:all # 初始化依赖
npm run dev # 并行启动前端(3001)与后端(3000)
npm run test:fullstack
./test-setup.sh # 启动 LocalStack + 测试数据库
Rust 与 Go 组件分别使用 cargo run, cargo test, go run, go test ./...；详细测试矩阵参见 TESTING.md。
Testing & Verification
- 前端：Jest + Testing Library (
npm run test:frontend)，Playwright E2E (npm run test:e2e). - 后端：Jest 单元与集成测试 (
npm run test:backend,npm run test:integration). - 边缘客户端：
cargo check、cargo test；模拟摄像机脚本位于meteor-edge-client/scripts/。 - 组合流程：
npm run test:fullstack调用前后端及集成测试，配合docker-compose.test.yml。
Infrastructure & Operations
- Terraform 输出的 S3/SQS/CloudWatch 资源需同步到
.env与部署配置，细节参见infrastructure/README.md。 - Pino + CloudWatch 提供日志链路，
metrics模块和 Gometrics包推送业务指标。 - CI/CD 可利用
meteor-edge-client/.github/workflows/示例以及 repo 根目录的 npm scripts。
Additional Documentation
- 贡献者指南：
AGENTS.md - 测试细节：
TESTING.md - 边缘摄像模拟：
meteor-edge-client/CAMERA_SIMULATION_USAGE.md - 基础设施：
infrastructure/README.md