dohertj2/scadalink-design
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add test infrastructure with Docker services, CLI tools, and resolve Phase 0 questions

Browse Source 
Stand up local dev infrastructure (OPC UA, LDAP, MS SQL) with Docker Compose,
Python CLI tools for service interaction, and teardown script. Fix GLAuth config
mount, OPC PLC node format, and document actual DN/namespace behavior discovered
during testing. Resolve Q1-Q8,Q10: .NET 10, Akka.NET 1.5.x, monorepo with slnx,
appsettings JWT, Windows Server 2022 site target.
This commit is contained in:
Joseph Doherty
2026-03-16 14:03:12 -04:00
parent 7a0bd0f701
commit 652378b470
17 changed files with 1538 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
docs/plans/questions.md
View File

@@ -6,30 +6,11 @@
## Open Questions
### Phase 0: Solution Skeleton
| # | Question | Context | Impact | Status |
|---|----------|---------|--------|--------|
| Q1 | What .NET version should we target? (.NET 8 LTS or .NET 9?) | Affects available APIs, Akka.NET compatibility, and support lifecycle. | Phase 0 — must decide before creating solution. | Open |
| Q2 | What Akka.NET version? (v1.5.x stable or preview features?) | Affects hosting APIs, serialization options, and cluster features. | Phase 0 — must decide before creating solution. | Open |
| Q3 | Should we use a monorepo (single .sln) or separate repos per component? | Affects CI/CD, versioning, and developer workflow. Monorepo recommended for a tightly coupled system. | Phase 0. | Open |
| Q4 | What CI/CD platform? (GitHub Actions, Azure DevOps, Jenkins, etc.) | Affects pipeline configuration in Phase 0. | Phase 0. | Open |
### Phase 1: Central Foundations
| # | Question | Context | Impact | Status |
|---|----------|---------|--------|--------|
| Q5 | What LDAP server will be used for dev/test? (Real AD, lightweight LDAP like OpenLDAP, or mock?) | Affects integration test setup for Security & Auth. | Phase 1 — needed for auth development. | Open |
| Q6 | What MS SQL version and hosting? (SQL Server 2019/2022, Azure SQL, local?) | Affects EF Core provider and connection string configuration. | Phase 1 — needed for Config DB. | Open |
| Q7 | Should the JWT signing key be stored in appsettings.json, Azure Key Vault, or elsewhere? | Affects security posture and operational procedures. Currently specified as "configuration." | Phase 1. | Open |
### Phase 3: Site Execution
| # | Question | Context | Impact | Status |
|---|----------|---------|--------|--------|
| Q8 | Is a real OPC UA server available for dev/test, or do we need a simulator? | Affects Data Connection Layer development. Best practices doc recommends mock protocol adapters. | Phase 3 — needed for DCL development. | Open |
| Q9 | What is the custom protocol? Is there an existing specification or SDK? | The design mentions "custom protocol" as a second adapter alongside OPC UA. Need details to implement. | Phase 3. | Open |
| Q10 | What is the target site hardware? (Server specs, network topology between nodes) | Affects performance tuning and Akka.NET dispatcher configuration. | Phase 3, Phase 8. | Open |
| Q9 | What is the custom protocol? Is there an existing specification or SDK? | The design mentions "custom protocol" as a second adapter alongside OPC UA. Need details to implement. | Phase 3. | Deferred — owner will provide details later |
### Phase 7: Integrations
@@ -52,4 +33,12 @@
| # | Question | Resolution | Date |
|---|----------|------------|------|
| — | (none yet) | — | — |
| Q1 | What .NET version should we target? | .NET 10 LTS (released November 2025, supported through 2028). | 2026-03-16 |
| Q2 | What Akka.NET version? | Latest stable 1.5.x (currently 1.5.62). | 2026-03-16 |
| Q3 | Monorepo or separate repos? | Single monorepo with SLNX solution file (`.slnx`, the new XML-based format default in .NET 10). | 2026-03-16 |
| Q4 | What CI/CD platform? | None for now. No CI/CD pipeline. | 2026-03-16 |
| Q5 | What LDAP server for dev/test? | GLAuth (lightweight LDAP) in Docker. See `infra/glauth/config.toml` and `test_infra_ldap.md`. | 2026-03-16 |
| Q6 | What MS SQL version and hosting? | SQL Server 2022 Developer Edition in Docker. See `infra/docker-compose.yml` and `test_infra_db.md`. | 2026-03-16 |
| Q7 | JWT signing key storage? | `appsettings.json` (per environment). | 2026-03-16 |
| Q8 | OPC UA server for dev/test? | Azure IoT OPC PLC simulator in Docker. See `infra/opcua/nodes.json` and `test_infra_opcua.md`. | 2026-03-16 |
| Q10 | Target site hardware? | Windows Server 2022, 24 GB RAM, 1 TB drive, 16-core Xeon. | 2026-03-16 |