Plataforma de visualizacion de datos en tiempo real de nivel empresarial
Observa es una implementacion de referencia que demuestra arquitectura frontend moderna, sincronizacion de datos en tiempo real y diseno accesible. El backend proporciona APIs de alto rendimiento y comunicacion bidireccional via SignalR para dashboards de datos empresariales.
- Clean Architecture - Diseno centrado en el dominio con inversion de dependencias
- Datos en Tiempo Real - SignalR con protocolo MessagePack para latencia < 100ms
- CQRS - Modelos separados de lectura/escritura para rendimiento optimizado
- Observabilidad - OpenTelemetry para tracing distribuido, logging estructurado con Serilog
- Seguridad - Headers de seguridad, rate limiting, validacion de entrada
- Testing - xUnit, NSubstitute, FluentAssertions, NetArchTest para enforcement de arquitectura
+------------------+
| Observa.Api |
| Endpoints + Hubs |
+--------+---------+
|
+--------v-----------+
| Observa.Application|
| Commands + Queries |
+--------+-----------+
|
+--------v---------+
| Observa.Domain |
| Entidades + Reglas|
+--------+---------+
^
+--------+--------------+
| Observa.Infrastructure|
| EF Core + Redis + Hub |
+-----------------------+
git clone https://github.com/MancoMen-Software-Studio/Observa.git
cd Observa
docker-compose up -d
dotnet run --project src/Observa.Api- .NET 9 SDK
- Docker (para PostgreSQL y Redis)
- PostgreSQL 17 (o usar Docker)
- Redis 7.4 (o usar Docker)
docker-compose up --build-
Clonar y restaurar
git clone https://github.com/MancoMen-Software-Studio/Observa.git cd Observa dotnet restore -
Configurar entorno
cp src/Observa.Api/appsettings.Development.example.json \ src/Observa.Api/appsettings.Development.json
-
Ejecutar migraciones
dotnet ef database update \ --project src/Observa.Infrastructure \ --startup-project src/Observa.Api
-
Iniciar la API
dotnet run --project src/Observa.Api
Observa/
|-- src/
| |-- Observa.Domain/ # Logica de negocio pura
| |-- Observa.Application/ # Casos de uso (MediatR)
| |-- Observa.Infrastructure/ # EF Core, Redis, SignalR
| +-- Observa.Api/ # Endpoints HTTP + Hubs
|-- tests/
| |-- Observa.Domain.Tests/
| |-- Observa.Application.Tests/
| |-- Observa.Api.Tests/
| +-- Observa.Architecture.Tests/
|-- docs/
| |-- architecture/
| +-- guides/
|-- .github/
| |-- workflows/
| +-- ISSUE_TEMPLATE/
+-- CLAUDE.md
| Categoria | Tecnologia |
|---|---|
| Runtime | .NET 9.0 |
| Lenguaje | C# 13 |
| Framework | ASP.NET Core 9.0 Minimal APIs |
| Mediator | MediatR 12.x |
| Validacion | FluentValidation 11.x |
| ORM | Entity Framework Core 9.0 |
| Base de Datos | PostgreSQL 17 |
| Cache | Redis 7.4 |
| Tiempo Real | SignalR + MessagePack |
| Observabilidad | OpenTelemetry, Serilog, Seq |
| Testing | xUnit, NSubstitute, FluentAssertions |
dotnet test
dotnet test --collect:"XPlat Code Coverage"
dotnet test tests/Observa.Domain.Tests| Capa | Cobertura Minima |
|---|---|
| Domain | 90% |
| Application | 85% |
| Infrastructure | 70% |
| Api | 60% |
| Variable | Descripcion | Default |
|---|---|---|
ConnectionStrings__Database |
Connection string de PostgreSQL | -- |
ConnectionStrings__Redis |
Connection string de Redis | localhost:6379 |
SignalR__MaxReconnectAttempts |
Intentos de reconexion | 5 |
Serilog__MinimumLevel |
Nivel minimo de logging | Information |
Aceptamos contribuciones. Consulta CONTRIBUTING.md para las guias.
- Fork del repositorio
- Crear rama feature (
git checkout -b feature/nueva-funcionalidad) - Commit con Conventional Commits (
git commit -m 'feat: agregar funcionalidad') - Push a la rama (
git push origin feature/nueva-funcionalidad) - Crear Pull Request
Este proyecto esta bajo la Licencia MIT - ver LICENSE para detalles.
Desarrollado por MancoMen Software Studio
Bogota, Colombia