SIENTIAPDE-2202

SIENTIAPDE-2202-escrita-opc-timestamp-qualidade: Enable granular control over OPC UA SourceTimestamp and StatusCode in write commands. This implements write_timestamp and write_quality flags (command > env > default true) for DataValue construction. Upgraded asyncua to 2.0+ to fix StatusCode field naming. Enhanced README.md with new gateway environment variables and detailed write command behavior. Added comprehensive unit and E2E tests for this feature, and removed obsolete planning documents.

tests/unit/engines/test_write.py

@@ -140,6 +140,36 @@ async def test_write_engine_flags_off_omit_statuscode_and_timestamp():
     assert dv.SourceTimestamp is None
 
 
+@pytest.mark.asyncio
+async def test_write_engine_timestamp_off_keeps_statuscode():
+    eng = make_engine(write_timestamp=False)
+    node = make_node()
+    eng.pool.get.return_value = make_client(node)
+
+    await eng.write(base_cmd())
+
+    dv = node.write_value.await_args.args[0]
+    assert dv.Value.Value == 42.0
+    assert dv.SourceTimestamp is None
+    assert dv.StatusCode is not None
+    assert dv.StatusCode.is_good()
+
+
+@pytest.mark.asyncio
+async def test_write_engine_quality_off_keeps_timestamp():
+    # The command has no write_quality, so the engine (env) default applies.
+    eng = make_engine(write_quality=False)
+    node = make_node()
+    eng.pool.get.return_value = make_client(node)
+
+    await eng.write(base_cmd())
+
+    dv = node.write_value.await_args.args[0]
+    assert dv.Value.Value == 42.0
+    assert dv.StatusCode is None
+    assert dv.SourceTimestamp == datetime.fromisoformat('2026-07-13T12:00:00Z')
+
+
 @pytest.mark.asyncio
 async def test_per_message_flag_override_disables_timestamp():
     # Engine default is True, but the command explicitly turns it off.

tests/unit/test_config.py

@@ -41,6 +41,7 @@ def test_from_env_overrides(monkeypatch):
     monkeypatch.setenv('GRPC_ENABLED', 'true')
     monkeypatch.setenv('GRPC_PORT', '6000')
     monkeypatch.setenv('WRITE_MIN_PAUSE_S', '0.5')
+    monkeypatch.setenv('WRITE_TIMESTAMP', 'false')
     monkeypatch.setenv('WRITE_QUALITY', 'false')
 
     cfg = GatewayConfig.from_env()
@@ -48,6 +49,7 @@ def test_from_env_overrides(monkeypatch):
     assert cfg.grpc_enabled is True
     assert cfg.grpc_port == 6000
     assert cfg.write_min_pause_s == 0.5
+    assert cfg.write_timestamp is False
     assert cfg.write_quality is False