Skip to content

Commit d6fdec0

Browse files
committed
Document Windows execution model
1 parent 32b1e71 commit d6fdec0

1 file changed

Lines changed: 17 additions & 0 deletions

File tree

src/windows/README.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Windows Execution Model
2+
3+
This package provides the Windows-side execution vocabulary for the Java 21 server/frontend reference architecture.
4+
5+
The model is deliberately separated into seven concepts:
6+
7+
- **Execution** — performs a controlled process launch and records its result.
8+
- **Program** — identifies an executable and constructs its argument vector.
9+
- **Directive** — expresses the policy under which execution is permitted.
10+
- **Citizen** — supplies a non-secret identity/accountability context.
11+
- **Call** — records who requested which program under which directive.
12+
- **Choice** — represents ordered executable alternatives and selects an available one.
13+
- **Structure** — binds the complete execution context into one immutable envelope.
14+
15+
The implementation uses Java 21 records where the object is naturally immutable and a final class for the executable operation. It does not embed credentials or silently elevate privileges.
16+
17+
For production hardening, process timeouts, Windows ACL checks, executable allow-lists, audit persistence, and explicit cancellation should be implemented by the surrounding service before unrestricted process execution is enabled.

0 commit comments

Comments
 (0)