myoffice_public/README.md

MyOffice

Layers Frontend <-> Backend <-> Services <-> Repositories <-> Database

1. MyOffice.SPA Frontend layer Angular

2. MyOffice.Web Backend layer ASP Core

3. MyOffice.Data.Services Services layer

5. MyOffice.Data.Models Models

6. MyOffice.Data.Repositories Database layer

7. MyOffice.DbContext AppDbContext EntityFramework Core

8. MyOffice.Migrations.Postgres Postgres Migrations

9. MyOffice.Migrations.Sqlite Sqlite Migrations

DataBase

1. SQLite
2. PostgreSql
3. MS SQL

Develompent

1. Local IIS
2. Express IIS

Authentication & Authorization

1. OpenIddict (replaces IdentityServer4)
2. Custom UserStore + Identity V3 password hashes (legacy hashes rehashed on login)
3. SPA: email/password via ROPC (kept); Authorization Code + PKCE configured for interactive OIDC
4. Login with Google / Auth0 (external grant)
5. Details: docs/AUTH.md, refactoring: docs/REFACTORING_PLAN.md

Build & Deploy

1. Build with .bat
2. Deploy to Linux

Get started

1. Restore / build: dotnet build MyOffice.Web/MyOffice.Web.csproj
2. SPA: cd MyOffice.SPA && npm install && npm start (default http://localhost:4300)
3. Set startup project to MyOffice.Web, run (API default http://localhost:9100)
4. Ensure FrontEnd:Host matches the SPA origin (appsettings.json)
5. Tests: dotnet test MyOffice.Tests/MyOffice.Tests.csproj
6. Empty DB is auto-filled with demo users (rates at Jan 1, sample accounts/items/motions):
   • user_UAH@user_UAH.userUAH / user_UAH
   • user_USD@user_USD.userUSD / user_USD
   • user_EUR@user_EUR.userEUR / user_EUR

add site to IIS

1. add Site name:myproject Physical path:...\MyProject\MyProject.Web Port:9100
2. Select 'IIS', Run Backend (F5)

Settings

1. launchSettings.json
2. appsettings appsettings.json appsettings.Development.json appsettings.Production.json
3. Optional: AutoMapper:LicenseKey (or env AUTOMAPPER_LICENSE_KEY) — free Community key from https://automapper.io if under ~$5M revenue. Empty works; you only get license warning logs.

External providers

1. Auth0 appsettings ExternalProviders:Auth0
2. Google appsettings ExternalProviders:Google

PowerShell scripts

1. use 'Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass' to allow run *.ps1
2. params.txt 2.1. publish_folder=_Published (folder to publish) 2.2. linux_user=root (linux user) 2.3. linux_host=192.168.1.215 (linux host) 2.4. linux_folder=/var/www/MyProject (folder in linux)

Build

1. .\build.ps1 1.1. '.\build.ps1' - build Backend + Frontend 1.2. '.\build.ps1 dotnet' build Backend 1.3. '.\build.ps1 spa' build Frontend

Docker demo (SPA + API + Postgres + pgAdmin)

1. cd Docker then .\build.ps1 (defaults :32080 / :32081 / :32082)
2. After code changes: .\build.ps1 rebuild (or .\build.ps1 reset to wipe DB + re-seed)
3. Details: Docker/README.md

Proxmox (Gitea public scripts + release artifact)

1. Maintainer: .\proxmox\publish.ps1 -Tar → .\proxmox\release.ps1 → .\proxmox\sync-public.ps1 -Push (or Gitea Actions)
2. User on Proxmox: set GITEA_URL / GITEA_OWNER / REPO_RAW_BASE, run myoffice.sh (see proxmox/README.md)
3. Proxy nginx to http://<ct-ip>:9100
4. Lab SSH (no Gitea): .\proxmox\deploy.ps1 -TargetHost <ct-ip>