Jarvis Dotnet

Jarvis Framework — Orchestrator

Skill điều phối scaffold solution chuẩn và cài đặt Jarvis trên ASP.NET Core .NET 9.

Luồng chính (khuyến nghị)

Folder trống → skill jarvis-dotnet → solution phân lớp + Jarvis → F5

| Bước | Workflow | |---|---| | 1. Scaffold từ đầu | [workflows/scaffold.md](workflows/scaffold.md) | | 2. Thêm module Jarvis | [workflows/add.md](workflows/add.md) | | 3. Chỉ cài package (solution có sẵn) | [workflows/init.md](workflows/init.md) |

Cấu trúc solution tiêu chuẩn

{product}-backend/
├── src/{Product}.sln
│   ├── {Product}.Domain.Shared
│   ├── {Product}.Domain
│   ├── {Product}.Application      → Jarvis.DDD.Application
│   ├── {Product}.Infrastructure   → Jarvis.EntityFramework
│   └── {Product}.Host             → Jarvis.Mvc, OTEL, HealthChecks, Swagger
└── tests/

Chi tiết folder, DI convention, Jarvis mapping: [reference/solution-structure.md](reference/solution-structure.md).

Composition root: Program.cs chỉ gọi AddHostLayer() / UseHostLayer().

Templates scaffold

| Tài nguyên | Path | |---|---| | Bản đồ scaffold → skill | [templates/SKILLS.md](templates/SKILLS.md) | | Cây thư mục | [templates/solution-tree.txt](templates/solution-tree.txt) | | Layer extensions + Host | [templates/layers/](templates/layers/) | | csproj Jarvis refs | [templates/layer-csproj/](templates/layer-csproj/) | | README / Architecture | [templates/docs-README.md](templates/docs-README.md) |

Hai cách cài Jarvis

| Cách | Khi nào | |---|---| | ProjectReference | Monorepo cạnh repo Jarvis ({JarvisRoot}) — packages cross-cutting trong {JarvisRoot}/frameworks/ | | NuGet | Repo độc lập, feed nội bộ |

PackageId: Jarvis.Authentication.* folder → NuGet Jarvis.Authentications.*.

Catalog package (NuGet)

Phiên bản tham chiếu từ repo Jarvis (develop):

| Module | PackageId | Version | Layer | |---|---|---|---| | Domain shared | Jarvis.DDD.Domain.Shared | 1.0.0 | Domain.Shared | | Domain | Jarvis.DDD.Domain | 1.1.1 | Host (enricher) | | Application | Jarvis.DDD.Application | 1.2.1 | Application | | Application contracts | Jarvis.DDD.Application.Contracts | 1.2.1 | Application | | Entity Framework | Jarvis.EntityFramework | 1.0.0 | Infrastructure | | Caching | Jarvis.Caching | 1.1.0 | Infrastructure (bắt buộc trước EF) | | Caching Redis | Jarvis.Caching.Redis | 1.1.0 | Infrastructure (tùy chọn) | | MVC | Jarvis.Mvc | 1.1.0 | Host | | Swashbuckle | Jarvis.Swashbuckle | 1.0.1 | Host | | Health checks | Jarvis.HealthChecks | 1.0.0 | Host | | OpenTelemetry | Jarvis.OpenTelemetry | 1.0.1 | Host | | Authentication | Jarvis.Authentications.* | 1.0.1 | Host |

Bảng đầy đủ / monorepo ProjectReference: [workflows/init.md](workflows/init.md), csproj repo Jarvis.

Quy tắc DI (develop)

| Thứ tự | Lý do | |---|---| | AddJarvisCaching() → AddEntityFramework() | EF bọc ITenantConnectionStringResolver qua ICacheService | | AddCoreDbContext sau AddEntityFramework | Multitenancy + interceptor | | AddJarvisOpenTelemetry trước Build() | Plug-in trong callback configureServices |

Skill chuyên sâu: [entityframework-dotnet](../entityframework-dotnet/README.md) · [caching-dotnet](../caching-dotnet/README.md) · [telemetry-dotnet](../telemetry-dotnet/README.md)

Modules (atomic)

| Module | Skill chuyên sâu | |---|---| | Foundation | [foundation-dotnet](../foundation-dotnet/README.md) | | Application | [application-dotnet](../application-dotnet/README.md) | | Authentication | [authentication-dotnet](../authentication-dotnet/README.md) | | Notification | [notification-dotnet](../notification-dotnet/README.md) | | Entity Framework | [entityframework-dotnet](../entityframework-dotnet/README.md) | | Caching | [caching-dotnet](../caching-dotnet/README.md) | | Blob storing | [blobstoring-dotnet](../blobstoring-dotnet/README.md) | | Swashbuckle | [swashbuckle-dotnet](../swashbuckle-dotnet/README.md) | | OpenTelemetry | [telemetry-dotnet](../telemetry-dotnet/README.md) | | Health checks | [healthcheck-dotnet](../healthcheck-dotnet/README.md) |

Mở rộng module: dùng [templates/SKILLS.md](templates/SKILLS.md) và skill *-dotnet trong .opencode/skills/.

F5 sau scaffold

• Startup project: {Product}.Host
• launchSettings.json → Swagger
• GET /api/ping — không cần DB
• /health/live — OK; /health/ready cần PostgreSQL nếu bật DB check

Output bắt buộc (scaffold)

• Solution 5 project + 2 test projects
• *LayerExtension.cs mỗi layer
• Program.cs mỏng
• appsettings + launchSettings
• dotnet build thành công

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hoangnh2412
• Source: hoangnh2412/ai-skills
• License: MIT

Install and usage instructions live in the source repository linked above.