DCFS Dashboard is the containerized control plane for the Precision 7920 workstation. It provides a single IP-based entry point for platform status, Authentik-backed login and user identity, GitLab, user synchronization, and later restricted container operations.
- ASP.NET Core 10 Web API and .NET Worker Service
- EF Core 10 with Npgsql for PostgreSQL 18
- Valkey 9 through the official
Valkey.Glideclient - Vue 3, TypeScript, Vite, Pinia, Vue Router, and Element Plus
- Nginx gateway serving the Vue build and proxying API and Authentik traffic
The repository is a modular monolith. Domain has no infrastructure dependency, Application contains use cases and ports, Infrastructure implements persistence and external integrations, and Api owns HTTP/OIDC concerns.
Dashboard has no local password store and does not duplicate Authentik user profiles. Interactive login uses Authentik through the backend OIDC authorization-code flow. Authentik subject IDs and group claims are mapped to Dashboard-specific permissions and immutable audit events; Authentik remains the source of truth for names, email addresses, groups, credentials, MFA, and account state.
src/
Dcfs.Dashboard.Api/
Dcfs.Dashboard.Application/
Dcfs.Dashboard.Domain/
Dcfs.Dashboard.Infrastructure/
Dcfs.Dashboard.Worker/
web/
tests/
deploy/gateway/
master: stable, deployable releases onlydev: integration branch for active development- Feature branches start from
devand merge back intodev - Release changes move from
devtomasterthrough a pull request
Direct feature work must not be committed to master.
dotnet restore
dotnet build --configuration Release --no-restore
dotnet test --configuration Release --no-build
Set-Location web
corepack pnpm install --frozen-lockfile
corepack pnpm lint
corepack pnpm test:unit
corepack pnpm buildIf the workstation exports a SOCKS URL through HTTP_PROXY or HTTPS_PROXY, Node/Corepack may reject it. Clear those variables only for the current install process or provide the local proxy using an http://127.0.0.1:<port> URL. Do not change the system proxy as part of the project scripts.
Copy .env.example to .env, set mode 0600 on Linux, and replace every placeholder. Secrets are never committed. Infrastructure settings come from environment variables, dynamic platform settings live in PostgreSQL, and public Vue settings are written to /tmp/runtime-config.js when the gateway starts.
The intended canonical URLs are:
- Dashboard:
http://192.168.22.19:8080 - Authentik:
http://192.168.22.19:8081 - GitLab:
http://192.168.22.19:8082(added when GitLab is deployed)
Only the gateway publishes host ports. The API and Worker are internal containers. The API must never mount /var/run/docker.sock; future container actions go through a separate allow-listed agent.
dcfsDashboardGateway:dcfsAppDashboardanddcfsAppAuthentikdcfsDashboardApi:dcfsAppDashboard,dcfsAppAuthentik,dcfsDbPostgres, anddcfsCacheGeneraldcfsDashboardWorker:dcfsDbPostgresanddcfsCacheGeneral
Docker uses the local logging driver with a maximum of five compressed 10 MiB files per container. Application request logs below server errors are emitted at debug level to avoid repeating the previous log-volume incident.
The Dockerfiles currently pin exact base-image tags. Before the first workstation deployment, resolve and append immutable manifest digests through the configured Xuanyuan/MCR mirrors and commit those digests with the deployment change.