---

inclusion: always

Codex 项目规则

字符集

• 所有新增或修改的文本文件统一使用 UTF-8 编码。
• 涉及中文内容（配置、脚本、文档、日志）时，禁止使用本地 ANSI 编码，避免乱码。

项目结构说明

HaHRCS/
├─ src/
│  ├─ Rcs.Api              # 表示层：ASP.NET Core Web API、控制器、Hub、后台服务
│  ├─ Rcs.Application      # 应用层：DTO、应用服务、消息命令/查询
│  ├─ Rcs.Domain           # 领域层：实体、值对象、领域服务、仓储接口
│  ├─ Rcs.Infrastructure   # 基础设施层：EF Core、仓储实现、消息总线、MQTT、路径服务
│  ├─ Rcs.Shared           # 共享层：通用工具、扩展、公共选项
│  ├─ Rcs.Cyaninetech      # 第三方/集成相关模块
│  ├─ init-db              # 数据库初始化脚本
│  └─ docker-compose.yml   # 本地/测试环境容器编排
├─ docs/                   # 项目文档
├─ scripts/                # 脚本工具
├─ artifacts/              # 构建产物
├─ HaHRCS.sln              # 解决方案入口
└─ DEPLOY.md               # 部署说明

技术栈

• 语言与框架：C# / .NET 8（net8.0）、ASP.NET Core Web API
• 架构模式：DDD + Onion Architecture + CQRS
• 数据访问：Entity Framework Core 8 + Npgsql
• 数据存储：PostgreSQL 15（含 PostGIS 扩展）
• 缓存：Redis 7
• 消息总线：MassTransit 8 + RabbitMQ
• 设备通信：MQTTnet 4 + EMQX
• 映射与工具：AutoMapper、System.Linq.Dynamic.Core
• 可观测性与日志：OpenTelemetry、Serilog
• API 文档：Swashbuckle / Swagger
• 容器化：Docker Compose（api、nginx、postgres、redis、rabbitmq、emqx）