Natlinux/DotNetAngular
Template
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update README.md

Browse Source
This commit is contained in:
Nathalie Eugler
2026-02-04 13:48:23 +01:00
parent d2f62e56f2
commit 975d3ed433
2 changed files with 48 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
.idea/.idea.DotNetAngular/.idea/workspace.xml generated
View File

@@ -11,12 +11,8 @@
</component> </component>
<component name="ChangeListManager"> <component name="ChangeListManager">
<list default="true" id="1ac72a4a-52ad-4e70-9b15-c330b1ed3e7a" name="Changes" comment=""> <list default="true" id="1ac72a4a-52ad-4e70-9b15-c330b1ed3e7a" name="Changes" comment="">
<change afterPath="$PROJECT_DIR$/DotNetAngular.sln.DotSettings.user" afterDir="false" />
<change beforePath="$PROJECT_DIR$/.idea/.idea.DotNetAngular/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/.idea.DotNetAngular/.idea/workspace.xml" afterDir="false" /> <change beforePath="$PROJECT_DIR$/.idea/.idea.DotNetAngular/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/.idea.DotNetAngular/.idea/workspace.xml" afterDir="false" />
<change beforePath="$PROJECT_DIR$/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/README.md" afterDir="false" /> <change beforePath="$PROJECT_DIR$/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
<change beforePath="$PROJECT_DIR$/src/ClientApp/package-lock.json" beforeDir="false" afterPath="$PROJECT_DIR$/src/ClientApp/package-lock.json" afterDir="false" />
<change beforePath="$PROJECT_DIR$/src/ClientApp/package.json" beforeDir="false" afterPath="$PROJECT_DIR$/src/ClientApp/package.json" afterDir="false" />
<change beforePath="$PROJECT_DIR$/src/ClientApp/tsconfig.json" beforeDir="false" afterPath="$PROJECT_DIR$/src/ClientApp/tsconfig.json" afterDir="false" />
</list> </list>
<option name="SHOW_DIALOG" value="false" /> <option name="SHOW_DIALOG" value="false" />
<option name="HIGHLIGHT_CONFLICTS" value="true" /> <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -55,27 +51,27 @@
<option name="hideEmptyMiddlePackages" value="true" /> <option name="hideEmptyMiddlePackages" value="true" />
<option name="showLibraryContents" value="true" /> <option name="showLibraryContents" value="true" />
</component> </component>
<component name="PropertiesComponent"><![CDATA[{ <component name="PropertiesComponent">{
"keyToString": { &quot;keyToString&quot;: {
".NET Launch Settings Profile.API: Angular_dev.executor": "Run", &quot;.NET Launch Settings Profile.API: Angular_dev.executor&quot;: &quot;Run&quot;,
"RunOnceActivity.MCP Project settings loaded": "true", &quot;RunOnceActivity.MCP Project settings loaded&quot;: &quot;true&quot;,
"RunOnceActivity.ShowReadmeOnStart": "true", &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
"RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true", &quot;RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252&quot;: &quot;true&quot;,
"RunOnceActivity.git.unshallow": "true", &quot;RunOnceActivity.git.unshallow&quot;: &quot;true&quot;,
"RunOnceActivity.typescript.service.memoryLimit.init": "true", &quot;RunOnceActivity.typescript.service.memoryLimit.init&quot;: &quot;true&quot;,
"com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1": "true", &quot;com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1&quot;: &quot;true&quot;,
"git-widget-placeholder": "feature/setup-infrastructure", &quot;git-widget-placeholder&quot;: &quot;feature/setup-infrastructure&quot;,
"junie.onboarding.icon.badge.shown": "true", &quot;junie.onboarding.icon.badge.shown&quot;: &quot;true&quot;,
"node.js.detected.package.eslint": "true", &quot;node.js.detected.package.eslint&quot;: &quot;true&quot;,
"node.js.detected.package.tslint": "true", &quot;node.js.detected.package.tslint&quot;: &quot;true&quot;,
"node.js.selected.package.eslint": "(autodetect)", &quot;node.js.selected.package.eslint&quot;: &quot;(autodetect)&quot;,
"node.js.selected.package.tslint": "(autodetect)", &quot;node.js.selected.package.tslint&quot;: &quot;(autodetect)&quot;,
"nodejs_package_manager_path": "npm", &quot;nodejs_package_manager_path&quot;: &quot;npm&quot;,
"settings.editor.selected.configurable": "vcs.Git", &quot;settings.editor.selected.configurable&quot;: &quot;vcs.Git&quot;,
"to.speed.mode.migration.done": "true", &quot;to.speed.mode.migration.done&quot;: &quot;true&quot;,
"vue.rearranger.settings.migration": "true" &quot;vue.rearranger.settings.migration&quot;: &quot;true&quot;
} }
}]]></component> }</component>
<component name="RecapUselessUpdatesCounter"> <component name="RecapUselessUpdatesCounter">
<option name="suspendCountdown" value="9" /> <option name="suspendCountdown" value="9" />
</component> </component>
@@ -218,4 +214,8 @@
</breakpoints> </breakpoints>
</breakpoint-manager> </breakpoint-manager>
</component> </component>
<component name="XSLT-Support.FileAssociations.UIState">
<expand />
<select />
</component>
</project> </project>

39
README.md
View File

@@ -4,18 +4,32 @@ This project is a full-stack web application Template combining **ASP.NET Core**
## 🛠️ Technologies Used ## 🛠️ Technologies Used
- **Backend:** ASP.NET Core (.NET 9) - **Backend:** ASP.NET Core (.NET 10)
- **Frontend:** Angular - **Frontend:** Angular
- **API Documentation:** Swagger (Swashbuckle) - **API Documentation:** Swagger (Swashbuckle)
## 🔐 Authentication (Register & Login)
The template includes a preconfigured user registration and authentication flow, designed as a solid baseline for production-ready applications.
- **Register:**
Creation of new user accounts via a dedicated API endpoint with server-side validation and secure password hashing.
- **Login:**
Token-based authentication using JWT (JSON Web Token). Upon successful authentication, a token is issued for authorized API access.
- **Authorization:**
Protected backend endpoints and frontend routes are secured using role- or policy-based access control.
The authentication architecture is secure, extensible, and aligned with enterprise best practices.
## 🚀 Getting Started ## 🚀 Getting Started
### Prerequisites ### Prerequisites
- [.NET 9 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/9.0) - [.NET 10 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/10.0)
- [Node.js (LTS)](https://nodejs.org/) - [Node.js (LTS)](https://nodejs.org/)
@@ -48,34 +62,27 @@ This project is a full-stack web application Template combining **ASP.NET Core**
--- ---
## 🧪 Angular-Tests ausführen (Wie mache ich Tests in Angular?) ## 🧪 Running Angular Tests
Die Angular-Frontend-Tests sind mit Karma + Jasmine eingerichtet. Alle Testdateien enden auf `.spec.ts` und liegen neben den jeweiligen Komponenten/Services im Ordner `src/ClientApp/src/`. Angular frontend tests are set up using Karma + Jasmine. All test files follow the `.spec.ts` naming convention and are located alongside their respective components and services in `src/ClientApp/src/`.
### Schnellstart ### Quick Start
1. Abhängigkeiten installieren (falls noch nicht erledigt):
```bash ```bash
cd src/ClientApp cd src/ClientApp
npm install npm test
```
2. Tests im Watch-Modus starten (öffnet den Browser, ideal für Entwicklung):
```bash
npm test
``` ```
### Headless/CI und Coverage ### Headless/CI und Coverage
- Einmalige Testausführung mit Coverage-Bericht (headless):
```bash ```bash
cd src/ClientApp cd src/ClientApp
npm run test:coverage npm run test:coverage
``` ```
Der Coverage-Report wird unter `src/ClientApp/coverage/` erzeugt (HTML-Report in `index.html`). The coverage report is generated under `src/ClientApp/coverage/` (HTML-Report in `index.html`).
- CI-freundliche Ausführung in Chrome Headless inklusive Coverage:
```bash ```bash
cd src/ClientApp cd src/ClientApp
npm run test:ci npm run test:ci
``` ```
Hinweis: Für Headless-Tests muss eine Chrome/Chromium-Laufzeit auf der Maschine vorhanden sein. Note: For headless tests, a Chrome/Chromium runtime must be present on the machine.