Skip to content

Commit 7a43c62

Browse files
Merge pull request #89 from Genocs/features/net10
Features/net10
2 parents f48847a + 3025bb3 commit 7a43c62

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

44 files changed

+551
-286
lines changed

.github/CODE_OF_CONDUCT.md

Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
# Contributor Covenant Code of Conduct
2+
3+
## Our Pledge
4+
5+
We as members, contributors, and leaders pledge to make participation in our
6+
community a harassment-free experience for everyone, regardless of age, body
7+
size, visible or invisible disability, ethnicity, sex characteristics, gender
8+
identity and expression, level of experience, education, socio-economic status,
9+
nationality, personal appearance, race, religion, or sexual identity
10+
and orientation.
11+
12+
We pledge to act and interact in ways that contribute to an open, welcoming,
13+
diverse, inclusive, and healthy community.
14+
15+
## Our Standards
16+
17+
Examples of behavior that contributes to a positive environment for our
18+
community include:
19+
20+
* Demonstrating empathy and kindness toward other people
21+
* Being respectful of differing opinions, viewpoints, and experiences
22+
* Giving and gracefully accepting constructive feedback
23+
* Accepting responsibility and apologizing to those affected by our mistakes,
24+
and learning from the experience
25+
* Focusing on what is best not just for us as individuals, but for the
26+
overall community
27+
28+
Examples of unacceptable behavior include:
29+
30+
* The use of sexualized language or imagery, and sexual attention or
31+
advances of any kind
32+
* Trolling, insulting or derogatory comments, and personal or political attacks
33+
* Public or private harassment
34+
* Publishing others' private information, such as a physical or email
35+
address, without their explicit permission
36+
* Other conduct which could reasonably be considered inappropriate in a
37+
professional setting
38+
39+
## Enforcement Responsibilities
40+
41+
Community leaders are responsible for clarifying and enforcing our standards of
42+
acceptable behavior and will take appropriate and fair corrective action in
43+
response to any behavior that they deem inappropriate, threatening, offensive,
44+
or harmful.
45+
46+
Community leaders have the right and responsibility to remove, edit, or reject
47+
comments, commits, code, wiki edits, issues, and other contributions that are
48+
not aligned to this Code of Conduct, and will communicate reasons for moderation
49+
decisions when appropriate.
50+
51+
## Scope
52+
53+
This Code of Conduct applies within all community spaces, and also applies when
54+
an individual is officially representing the community in public spaces.
55+
Examples of representing our community include using an official e-mail address,
56+
posting via an official social media account, or acting as an appointed
57+
representative at an online or offline event.
58+
59+
## Enforcement
60+
61+
Instances of abusive, harassing, or otherwise unacceptable behavior may be
62+
reported to the community leaders responsible for enforcement at
63+
info@genocs.com.
64+
All complaints will be reviewed and investigated promptly and fairly.
65+
66+
All community leaders are obligated to respect the privacy and security of the
67+
reporter of any incident.
68+
69+
## Enforcement Guidelines
70+
71+
Community leaders will follow these Community Impact Guidelines in determining
72+
the consequences for any action they deem in violation of this Code of Conduct:
73+
74+
### 1. Correction
75+
76+
**Community Impact**: Use of inappropriate language or other behavior deemed
77+
unprofessional or unwelcome in the community.
78+
79+
**Consequence**: A private, written warning from community leaders, providing
80+
clarity around the nature of the violation and an explanation of why the
81+
behavior was inappropriate. A public apology may be requested.
82+
83+
### 2. Warning
84+
85+
**Community Impact**: A violation through a single incident or series
86+
of actions.
87+
88+
**Consequence**: A warning with consequences for continued behavior. No
89+
interaction with the people involved, including unsolicited interaction with
90+
those enforcing the Code of Conduct, for a specified period of time. This
91+
includes avoiding interactions in community spaces as well as external channels
92+
like social media. Violating these terms may lead to a temporary or
93+
permanent ban.
94+
95+
### 3. Temporary Ban
96+
97+
**Community Impact**: A serious violation of community standards, including
98+
sustained inappropriate behavior.
99+
100+
**Consequence**: A temporary ban from any sort of interaction or public
101+
communication with the community for a specified period of time. No public or
102+
private interaction with the people involved, including unsolicited interaction
103+
with those enforcing the Code of Conduct, is allowed during this period.
104+
Violating these terms may lead to a permanent ban.
105+
106+
### 4. Permanent Ban
107+
108+
**Community Impact**: Demonstrating a pattern of violation of community
109+
standards, including sustained inappropriate behavior, harassment of an
110+
individual, or aggression toward or disparagement of classes of individuals.
111+
112+
**Consequence**: A permanent ban from any sort of public interaction within
113+
the community.
114+
115+
## Attribution
116+
117+
This Code of Conduct is adapted from the [Contributor Covenant][homepage],
118+
version 2.0, available at
119+
https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
120+
121+
Community Impact Guidelines were inspired by [Mozilla's code of conduct
122+
enforcement ladder](https://github.com/mozilla/diversity).
123+
124+
[homepage]: https://www.contributor-covenant.org
125+
126+
For answers to common questions about this code of conduct, see the FAQ at
127+
https://www.contributor-covenant.org/faq. Translations are available at
128+
https://www.contributor-covenant.org/translations.

.github/ISSUE_TEMPLATE.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
<!--
2+
IF SUFFICIENT INFORMATION IS NOT PROVIDED VIA THE FOLLOWING TEMPLATE THE ISSUE MIGHT BE CLOSED WITHOUT FURTHER CONSIDERATION OR INVESTIGATION
3+
-->
4+
> Please provide us with the following information:
5+
> ---------------------------------------------------------------
6+
7+
### This issue is for a: (mark with an `x`)
8+
```
9+
- [ ] bug report -> please search issues before submitting
10+
- [ ] feature request
11+
- [ ] documentation issue or request
12+
- [ ] regression (a behavior that used to work and stopped in a new release)
13+
```
14+
15+
### Minimal steps to reproduce
16+
>
17+
18+
### Any log messages given by the failure
19+
>
20+
21+
### Expected/desired behavior
22+
>
23+
24+
### OS and Version?
25+
> Windows 10, 11. Linux (which distribution). macOS (Yosemite? El Capitan? Sierra?)
26+
27+
### Versions
28+
>
29+
30+
### Mention any other details that might be useful
31+
32+
> ---------------------------------------------------------------
33+
> Thanks! We'll be in touch soon.

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
## Purpose
2+
<!-- Describe the intention of the changes being proposed. What problem does it solve or functionality does it add? -->
3+
* ...
4+
5+
## Does this introduce a breaking change?
6+
<!-- Mark one with an "x". -->
7+
```
8+
[ ] Yes
9+
[ ] No
10+
```
11+
12+
## Pull Request Type
13+
What kind of change does this Pull Request introduce?
14+
15+
<!-- Please check the one that applies to this PR using "x". -->
16+
```
17+
[ ] Bugfix
18+
[ ] Feature
19+
[ ] Code style update (formatting, local variables)
20+
[ ] Refactoring (no functional changes, no api changes)
21+
[ ] Documentation content changes
22+
[ ] Other... Please describe:
23+
```
24+
25+
## How to Test
26+
* Get the code
27+
28+
```
29+
git clone [repo-address]
30+
cd [repo-name]
31+
git checkout [branch-name]
32+
npm install
33+
```
34+
35+
* Test the code
36+
<!-- Add steps to run the tests suite and/or manually test -->
37+
```
38+
```
39+
40+
## What to Check
41+
Verify that the following are valid
42+
* ...
43+
44+
## Other Information
45+
<!-- Add any other helpful information that may be needed here. -->

.github/chatmodes/Code Reviewer.chatmode.md renamed to .github/agents/Code Reviewer.agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
description: 'Review code for quality and adherence to best practices.'
3-
tools: ['codebase', 'usages', 'vscodeAPI', 'problems', 'fetch', 'githubRepo', 'search']
3+
tools: ['vscode', 'execute', 'read', 'edit', 'search', 'web', 'agent', 'todo']
44
---
55
# Code Reviewer Mode
66

.github/chatmodes/Documentation Writer.chatmode.md renamed to .github/agents/Documentation Writer.agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
description: 'Document code and its functionality.'
3-
tools: ['search']
3+
tools: ['read/readFile', 'search']
44
---
55

66
# Documentation Writer Mode

.github/dependabot.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,4 +8,4 @@ updates:
88
- package-ecosystem: "nuget" # See documentation for possible values
99
directory: "/src/template" # Location of package manifests
1010
schedule:
11-
interval: "weekly" # How often to check for updates (can be "daily", "weekly" or "monthly")
11+
interval: "monthly" # How often to check for updates (can be "daily", "weekly" or "monthly")

.github/workflows/build_and_test.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,12 +13,12 @@ jobs:
1313

1414
steps:
1515
- name: Checkout
16-
uses: actions/checkout@v5
16+
uses: actions/checkout@v6
1717

1818
- name: Setup .NET
1919
uses: actions/setup-dotnet@v5
2020
with:
21-
dotnet-version: 9.0.x
21+
dotnet-version: 10.0.x
2222

2323
- name: Restore dependencies
2424
run: dotnet restore ./src/template

.github/workflows/publish_nuget.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ on:
1313
description: "Package Version"
1414

1515
# Default value if no value is explicitly provided
16-
default: "4.0.0"
16+
default: "5.0.0"
1717

1818
# Input has to be provided for the workflow to run
1919
required: true
@@ -25,12 +25,12 @@ jobs:
2525

2626
steps:
2727
- name: Checkout
28-
uses: actions/checkout@v5
28+
uses: actions/checkout@v6
2929

3030
- name: Setup .NET
3131
uses: actions/setup-dotnet@v5
3232
with:
33-
dotnet-version: 9.0.x
33+
dotnet-version: 10.0.x
3434

3535
- name: Restore dependencies
3636
run: dotnet restore ./src/template

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2025 Genocs Services
3+
Copyright (c) 2026 Genocs Services
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 31 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
[license-url]: https://github.com/Genocs/clean-architecture-template/blob/main/LICENSE
2020
[build-shield]: https://github.com/Genocs/clean-architecture-template/actions/workflows/build_and_test.yml/badge.svg?branch=main
2121
[build-url]: https://github.com/Genocs/clean-architecture-template/actions/workflows/build_and_test.yml
22-
[package-shield]: https://img.shields.io/badge/nuget-v.4.0.1-blue?&label=latests&logo=nuget
22+
[package-shield]: https://img.shields.io/badge/nuget-v.5.0.0-blue?&label=latests&logo=nuget
2323
[package-url]: https://github.com/Genocs/clean-architecture-template/actions/workflows/build_and_test.yml
2424
[downloads-prev-shield]: https://img.shields.io/nuget/dt/Genocs.CleanArchitectureTemplate.svg?color=2da44e&label=downloads%20prev&logo=nuget
2525
[downloads-prev-url]: https://www.nuget.org/packages/Genocs.CleanArchitectureTemplate
@@ -50,7 +50,7 @@
5050

5151
# Genocs Clean Architecture Template
5252

53-
A comprehensive .NET 9 project template that follows Clean Architecture principles and Domain-Driven Design (DDD). This template helps you rapidly scaffold microservices applications with built-in support for multiple databases, message brokers, and enterprise patterns.
53+
A comprehensive .NET 10 project template that follows Clean Architecture Principles and Domain-Driven Design (DDD). This template helps you rapidly scaffold microservices applications with built-in support for multiple databases, message brokers, and enterprise patterns.
5454

5555
## ✨ Features
5656

@@ -80,9 +80,9 @@ A comprehensive .NET 9 project template that follows Clean Architecture principl
8080

8181
## 📋 Prerequisites
8282

83-
- [.NET 9 SDK](https://dotnet.microsoft.com/download/dotnet/9.0) (latest version)
83+
- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) (latest version)
8484
- **IDE** (choose one):
85-
- [Visual Studio 2022](https://visualstudio.microsoft.com/vs/) (recommended)
85+
- [Visual Studio 2026](https://visualstudio.microsoft.com/vs/) (recommended)
8686
- [Visual Studio Code](https://code.visualstudio.com/) with C# extension
8787
- [JetBrains Rider](https://www.jetbrains.com/rider/)
8888
- **Optional for development**:
@@ -98,7 +98,7 @@ A comprehensive .NET 9 project template that follows Clean Architecture principl
9898
dotnet new install Genocs.CleanArchitecture.Template
9999

100100
# Or install a specific version
101-
dotnet new install Genocs.CleanArchitecture.Template::4.0.1
101+
dotnet new install Genocs.CleanArchitecture.Template::5.0.0
102102

103103
# View all available options
104104
dotnet new cleanarchitecture --help
@@ -141,19 +141,17 @@ src/
141141

142142
To build the package run the following commands:
143143

144-
[custom-templates](https://docs.microsoft.com/en-us/dotnet/core/tools/custom-templates)
145-
146-
[dotnet-templating](https://github.com/dotnet/templating)
147-
148144
```bash
149145
# To clone the repository
150146
git clone https://github.com/Genocs/clean-architecture-template
151147
cd clean-architecture-template
152148

153149
# To pack and install the template
154-
dotnet pack ./src/Package.Template.csproj -p:PackageVersion=4.0.1 --configuration Release --output ./out
150+
dotnet pack ./src/Package.Template.csproj -p:PackageVersion=5.0.0 --configuration Release --output ./out
151+
152+
dotnet new install ./out/Genocs.CleanArchitecture.Template.5.0.0.nupkg
155153

156-
dotnet new install ./out/Genocs.CleanArchitecture.Template.4.0.1.nupkg
154+
# To verify the installation and see available options
157155
dotnet new cleanarchitecture --help
158156

159157
# To uninstall the template
@@ -163,6 +161,11 @@ dotnet new uninstall Genocs.CleanArchitecture.Template
163161
dotnet new cleanarchitecture --name {CompanyName.ServiceName} -da inmemory -sb rebus
164162
```
165163

164+
Official Documentation:
165+
- [custom-templates](https://docs.microsoft.com/en-us/dotnet/core/tools/custom-templates)
166+
- [dotnet-templating](https://github.com/dotnet/templating)
167+
168+
166169
### Miscellaneous
167170

168171
Useful commands:
@@ -184,10 +187,10 @@ dotnet new list
184187
docker-compose -f ./infrastructure/docker/docker-compose-infrastructure.yml up -d
185188

186189
# Run the API
187-
dotnet run --project src/YourProject.WebApi
190+
dotnet run --project src/WebApi/Host.csproj
188191

189192
# Run the Worker
190-
dotnet run --project src/YourProject.Worker
193+
dotnet run --project src/Worker/Host.csproj
191194

192195
# Run all tests
193196
dotnet test
@@ -196,6 +199,20 @@ dotnet test
196199
dotnet test src/UnitTests
197200
dotnet test src/IntegrationTests
198201
dotnet test src/AcceptanceTests
202+
203+
# Stop infrastructure services
204+
docker-compose -f ./infrastructure/docker/docker-compose-infrastructure.yml down
205+
206+
207+
# Build Docker WebApi image
208+
docker build -t genocs/clean-architecture-template -f ./src/WebApi/Dockerfile .
209+
210+
# Run Docker WebApi container
211+
docker run -d -p 8080:80 --name clean-architecture-template genocs/clean-architecture-template
212+
213+
# Stop and remove Docker WebApi container
214+
docker stop clean-architecture-template
215+
docker rm clean-architecture-template
199216
```
200217

201218
## 💬 Community & Support
@@ -224,7 +241,7 @@ dotnet test src/AcceptanceTests
224241

225242
For more details on getting started, [read the documentation](https://genocs-blog.netlify.app/library/)
226243

227-
Please check the [documentation](https://learn.microsoft.com/en-us/visualstudio/ide/how-to-locate-and-organize-project-and-item-templates?view=vs-2022) for more details.
244+
Please check the [documentation](https://learn.microsoft.com/en-us/visualstudio/ide/how-to-locate-and-organize-project-and-item-templates?view=visualstudio) for more details.
228245

229246
## Changelogs
230247

0 commit comments

Comments
 (0)