OMyFish — Enterprise .NET 10 Platform
OMyFish — Your AI Fishing Companion. When, Where, What you catch. A Bite Score timing forecast for when to fish, AI fish identification with GPS-logged observations on a map for where fish are being caught, and a Regs & Tips chatbot (powered by Groq) for what you can legally keep — built on .NET 10 + ASP.NET Core with Clean Architecture, CQRS (MediatR), and Event-Driven design.
[!NOTE]
Repo reorganization (July 2026): the OMyFish platform is split into six repos: omyfish-python (the AI-first origin, previously named omyfish — the old link redirects there — now kept in place for training the fish-ID model), omyfish-ai (standalone AI microservice shared by all), omyfish-java, omyfish-dotnet (this one), and the two newest siblings, omyfish-python-web (Django, public) and omyfish-ios (SwiftUI, private).
Stack
| Layer | Technology |
|---|
| Frontend | Next.js 15 · TypeScript · MapLibre GL JS |
| API Gateway | YARP Reverse Proxy |
| Services | .NET 10 · ASP.NET Core Minimal APIs · EF Core · Npgsql |
| AI Layer | Python 3.11 · PyTorch · ONNX Runtime · FastAPI |
| Messaging | RabbitMQ 3.13 (Quorum Queues) · MassTransit |
| Database | PostgreSQL 16 + PostGIS 3.4 · NetTopologySuite |
| Species Catalog | MongoDB 7 (read-mostly reference data, see BACKLOG.md item E) |
| Object Store | MinIO (dev) · AWS S3 / Azure Blob (prod) |
| Infra | Docker Compose · Kubernetes · Helm 3 |
| Observability | OpenTelemetry · Prometheus · Grafana · Jaeger · Serilog |
| CI/CD | GitHub Actions |
Quick Start (Development)
# Prerequisites: Docker, .NET 10 SDK, Node 20
# 1. Start infrastructure + all services
make up
# 2. Build all .NET services
make build
# 3. Run database migrations
make migrate
# 4. Create MinIO buckets
make minio-create-buckets
# 5. Open the app
open http://localhost:3000 # Frontend
open http://localhost:8080/health # API Gateway health
open http://localhost:15672 # RabbitMQ Management (omyfish/omyfish_dev)
open http://localhost:9001 # MinIO Console
open http://localhost:16686 # Jaeger UI
open http://localhost:3001 # Grafana (admin/admin)
Project Structure
omyfish-dotnet/
src/
services/
ApiGateway/ ← YARP + auth middleware
IdentityService/ ← JWT, OAuth2/OIDC, API keys
SpeciesService/ ← AI orchestration, CQRS, species KB
ObservationService/ ← PostGIS, EXIF, GeoJSON, MinIO
NotificationService/ ← notifications web API + MassTransit consumers
ShopService/ ← Omyshop: catalog, cart, Stripe checkout, orders
AIService/ ← builds from ../omyfish-ai (shared: Bite Score + fish ID + Regs & Tips chatbot)
shared/
OMyFish.Shared.BuildingBlocks/ ← CQRS interfaces, AggregateRoot
OMyFish.Shared.Contracts/ ← Integration events
infrastructure/
kubernetes/ ← Deployments, HPA, Ingress
helm/omyfish/ ← Helm chart
migrations/ ← SQL migration scripts
.gitlab-ci.yml
docker-compose.yml
Makefile
Frontend: not vendored here — extracted to its own repo/image, shared across every
omyfish-* backend: https://github.com/fenghebonjour/omyfish-frontend (Next.js 15, /, /timing,
/observations, /notifications, /login, /register). docker-compose.yml's frontend service
pulls a pinned tag; develop the frontend itself by cloning that repo directly. make up/
build-up warn (without blocking) if that pin is behind a sibling ../omyfish-frontend
checkout — bump the tag to pick up frontend changes.
Architecture
See ARCHITECTURE.md for full diagrams, DDD bounded contexts, CQRS flow, database schemas, scaling strategy, and migration roadmap.
Service Ports (dev)
| Service | Port |
|---|
| Frontend | 3000 |
| API Gateway (YARP) | 8080 |
| Identity Service | 8081 |
| Species Service | 8082 |
| Observation Service | 8083 |
| Notification Service | 8084 |
| Shop Service | 8085 |
| AI Service (Python) | 8000 |
| PostgreSQL | 5432 |
| MongoDB | 27017 |
| RabbitMQ AMQP | 5672 |
| RabbitMQ Management | 15672 |
| MinIO API | 9000 |
| MinIO Console | 9001 |
| Prometheus | 9090 |
| Grafana | 3001 |
| Jaeger UI | 16686 |
