Core
A shared foundation for accountable municipal work.
Operating manual →diff --git a/README.md b/README.md index 7ba878b..69c9115 100644 --- a/README.md +++ b/README.md @@ -67,12 +67,18 @@ Staff should begin with First run and Daily workflow. Administrators should also | Native desktop source version | 1.8.0-1 | | Candidate hashes | [SHA-256 checksums](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/SHA256SUMS-Windows-1.8.0.1.txt) and [Windows acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) | | Current owned software license | AGPL-3.0-only | -| Acceptance composition | Fresh Windows x64 profile; inspections-preview; Station configured separately | +| Acceptance composition | Windows x64 fresh install and upgrade from 1.7.2.1. Select the full profile. Station uses separate configuration. | Start a new installation with an empty database and fresh Windows profile. For an upgrade from Windows 1.7.2.1, keep the existing profile. The approved profile path is `%LOCALAPPDATA%\CivicSuite`. Keep existing profiles and backups. ## First run +**Upgrade from 1.7.2.1.** For the tested upgrade from 1.7.2.1, back up city data and settings, close Townlight, run the signed Windows 1.8.0.1 MSI, and reopen Townlight under the same Windows account with its existing profile. Keep the existing `%LOCALAPPDATA%\CivicSuite` directory. Upgrade paths from versions older than 1.7.2.1 are unverified. Station uses its separately configured service. + +### Fresh installation + +Run the signed Windows 1.8.0.1 MSI and use an empty database and a new Townlight profile for first run. + 1. Download the signed MSI, matching source companion and checksums from the [public Windows release](https://github.com/townlight/townlight/releases/tag/townlight-windows-v1.8.0.1). 2. Verify the MSI hash and Authenticode publisher before installation. See the [Windows acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) for the tested setup. 3. Launch Townlight under the intended named Windows account. Choose the storage folders. Select **Townlight Inspections candidate** (`inspections-preview`) for the bounded desktop composition, including Access and Notice. A narrower default selection will not expose all workspaces. @@ -198,7 +204,7 @@ Source contracts: `townlight_runtime/zoning_bridge.py`, `townlight_zoning/main.p ### Runtime and storage -The accepted package targets **Windows x64 fresh installation**. Its native shell uses **Rust 2021, Tauri 2 and Microsoft WebView2**; browser assets are JavaScript built with **Vite 8.1.6**. This describes the native desktop frontend; Station has a separate React operator, specified below or in its product manual. Canonical business workflows use bundled **CPython 3.13.5, FastAPI, Pydantic, SQLAlchemy and Alembic**, with **PostgreSQL 17 / PostGIS** and managed original files. The installed runtime tested here contains FastAPI 0.162.0. Package minimum Python requirements can differ from the bundled executable; the metadata reference preserves both. No stack rewrite is implied by the beta label. +The accepted package supports Windows x64 fresh installation and upgrade from 1.7.2.1. Its native shell uses **Rust 2021, Tauri 2 and Microsoft WebView2**; browser assets are JavaScript built with **Vite 8.1.6**. This describes the native desktop frontend; Station has a separate React operator, specified below or in its product manual. Canonical business workflows use bundled **CPython 3.13.5, FastAPI, Pydantic, SQLAlchemy and Alembic**, with **PostgreSQL 17 / PostGIS** and managed original files. The installed runtime tested here contains FastAPI 0.162.0. Package minimum Python requirements can differ from the bundled executable; the metadata reference preserves both. No stack rewrite is implied by the beta label. The native transport is fixed to loopback `127.0.0.1:15480`; PostgreSQL uses the configured local runtime port (default `15432`). Optional local model service defaults to `127.0.0.1:15434`. Those are deployment defaults, not internet endpoints. The runtime has health, module and readiness endpoints; readiness is stronger than process existence. The task queue is the existing local Core task infrastructure, not an assertion that a separate Redis service is required for this desktop composition. @@ -317,7 +323,7 @@ Use protected local folders, account permissions and credential storage. Never i Save work and use Core’s canonical **Backup Now** before maintenance. That operation stops writers. Preserve the coherent profile/database/document backup and its receipt, then use **Start** to resume. A source export is not a full backup. -Use **Restore Latest Backup** through the supported controls. If the result says **Restore needs service start**, use **Start**, then **Check**, and reopen a known record. Do not repeat restore merely because services need to start. The fresh-profile acceptance verified that a fulfilled request survived restore and a post-backup marker did not. +Use **Restore Latest Backup** through the supported controls. If the result says **Restore needs service start**, use **Start**, then **Check**, and reopen a known record. Do not repeat restore merely because services need to start. The [Windows 1.6.0.1 Beta 1 fresh-install acceptance](https://github.com/townlight/townlight/releases/tag/townlight-beta-1) verified that a fulfilled request survived restore and a post-backup marker did not. Keep Station’s dedicated database and media evidence together in its own backup. Core’s native-profile backup must not be assumed to include an external Station data directory. Stop writers during a coordinated backup. Preserve failed media attempts and logs. @@ -338,15 +344,13 @@ On failure, record the time, selected composition, component/installer versions ## Verified workflows and limits +The table records selected synthetic workflows from the original [Windows 1.6.0.1 Beta 1](https://github.com/townlight/townlight/releases/tag/townlight-beta-1) Sandbox run. Station’s later delivery has [separate Windows 1.6.0.1 acceptance](https://github.com/townlight/townlight/releases/tag/townlight-beta-1-station-delivery). See the [Windows 1.8.0.1 acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) for the workflows and upgrade path exercised on the current MSI. + | Product | Recorded result | Precisely exercised | |----|----|----| | Zoning | PASS | GeoJSON/PostGIS import, cited dimensional rule, parcel answer, staff review/history/snapshot and native workspace. | -These results come from the identified signed candidate’s fresh normal-profile Sandbox exercise: real native IPC/HTTP/PostgreSQL and selected headless controls. All accounts, source bundles and media were synthetic. The guest install/uninstall and recovery passed, and the owned Sandbox stopped. No host installed application or standalone CivicCast was changed. This documentation task reuses those receipts; it does not claim a new software acceptance run. - -See the [Windows acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) for this MSI. The historical [evidence index](https://townlight.github.io/reference/sandbox-evidence-index.json) applies to its original build. - -The limits remain: actual city field acceptance and equipment/network commissioning; Station automatic provisioning/SCM commissioning; every UI/role combination; field recognition accuracy; and historical in-place upgrades are not certified. They are not five invented feature requirements. Fresh-install controlled beta handoff remains the accepted scope. This package makes no city-deployment, publication or general-availability claim. +The Windows 1.8.0.1 acceptance covers the tested installation paths and selected synthetic workflows, including Boards & Commissions, Contracts, and Procurement. Earlier results apply to their original builds. City field acceptance, physical equipment and network commissioning, Station automatic provisioning, and comprehensive UI and role coverage remain outside the 1.8.0.1 checks. ## Terms of service and license @@ -374,7 +378,7 @@ Staff verify the jurisdiction, source currency, permissions, citations and propo ### Beta operation and recovery -Use the identified candidate in its supported fresh-install scope. Preserve backups and original evidence. Test physical equipment and chosen network/service configuration before relying on them. The supplied acceptance describes selected synthetic workflows, not every screen, vendor, field condition or upgrade. Operators decide whether a particular deployment meets their own operational obligations. +Windows 1.8.0.1 was tested for fresh installation and in-place upgrade from 1.7.2.1. Upgrade paths from versions older than 1.7.2.1 are unverified. Station uses its separately configured service. Keep backups and original evidence. Test your physical equipment and network and service configuration before relying on them. See the [acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) for the tested paths. ### Warranty and liability @@ -484,9 +488,7 @@ python -c "import townlight_zoning; from importlib.metadata import version; prin ``` Expected principal import: `townlight_zoning`; expected distribution version: -`0.2.3`. Use a fresh empty database/profile for workflow testing. Existing -city data and the previous release remain untouched; no in-place upgrade or -old-import compatibility shim is supplied. +`0.2.3`. For standalone component workflow testing, use a fresh empty database and profile. These component commands do not perform a Windows MSI upgrade. See First run for the supported Windows upgrade. ## License and responsible use diff --git a/README.txt b/README.txt index 83e5ad9..7486e87 100644 --- a/README.txt +++ b/README.txt @@ -1,7 +1,7 @@ Windows x64 Beta 1 · MSI 1.8.0.1 -The signed Windows x64 beta 1.8.0.1 updates installer metadata while -preserving the accepted signed application/runtime cabinet. +The signed Windows x64 beta 1.8.0.1 adds the three staff workspaces and +automatically refreshes the bundled runtime when upgrading from 1.7.2.1. - Townlight Zoning Manual - Contents @@ -70,22 +70,35 @@ included with the same documentation companion. Beta identity Identity Value - -------------------------------- ------------------------------------------------------------------------------- + -------------------------------- ------------------------------------------------------------------------------------------------------------------- Documentation Townlight Beta 1 naming, Access and Notice candidate - Windows MSI version 1.8.0.1 + Windows MSI version 1.8.0.1 Product component townlight-zoning 0.2.3 Principal import package townlight_zoning Native desktop source version 1.8.0-1 Candidate hashes SHA-256 checksums and Windows acceptance summary Current owned software license AGPL-3.0-only - Acceptance composition Fresh Windows x64 profile; inspections-preview; Station configured separately + Acceptance composition Windows x64 fresh install and upgrade from 1.7.2.1. Select the full profile. Station uses separate configuration. -Use an empty database and fresh Windows profile. The installer refuses -legacy profile initialization. The approved profile path is -%LOCALAPPDATA%\CivicSuite. Keep existing profiles and backups. +Start a new installation with an empty database and fresh Windows +profile. For an upgrade from Windows 1.7.2.1, keep the existing profile. +The approved profile path is %LOCALAPPDATA%\CivicSuite. Keep existing +profiles and backups. First run +Upgrade from 1.7.2.1. For the tested upgrade from 1.7.2.1, back up city +data and settings, close Townlight, run the signed Windows 1.8.0.1 MSI, +and reopen Townlight under the same Windows account with its existing +profile. Keep the existing %LOCALAPPDATA%\CivicSuite directory. Upgrade +paths from versions older than 1.7.2.1 are unverified. Station uses its +separately configured service. + +Fresh installation + +Run the signed Windows 1.8.0.1 MSI and use an empty database and a new +Townlight profile for first run. + 1. Download the signed MSI, matching source companion and checksums from the public Windows release. 2. Verify the MSI hash and Authenticode publisher before installation. @@ -283,16 +296,16 @@ Technical specifications Runtime and storage -The accepted package targets Windows x64 fresh installation. Its native -shell uses Rust 2021, Tauri 2 and Microsoft WebView2; browser assets are -JavaScript built with Vite 8.1.6. This describes the native desktop -frontend; Station has a separate React operator, specified below or in -its product manual. Canonical business workflows use bundled CPython -3.13.5, FastAPI, Pydantic, SQLAlchemy and Alembic, with PostgreSQL 17 / -PostGIS and managed original files. The installed runtime tested here -contains FastAPI 0.162.0. Package minimum Python requirements can differ -from the bundled executable; the metadata reference preserves both. No -stack rewrite is implied by the beta label. +The accepted package supports Windows x64 fresh installation and upgrade +from 1.7.2.1. Its native shell uses Rust 2021, Tauri 2 and Microsoft +WebView2; browser assets are JavaScript built with Vite 8.1.6. This +describes the native desktop frontend; Station has a separate React +operator, specified below or in its product manual. Canonical business +workflows use bundled CPython 3.13.5, FastAPI, Pydantic, SQLAlchemy and +Alembic, with PostgreSQL 17 / PostGIS and managed original files. The +installed runtime tested here contains FastAPI 0.162.0. Package minimum +Python requirements can differ from the bundled executable; the metadata +reference preserves both. No stack rewrite is implied by the beta label. The native transport is fixed to loopback 127.0.0.1:15480; PostgreSQL uses the configured local runtime port (default 15432). Optional local @@ -519,8 +532,8 @@ a full backup. Use Restore Latest Backup through the supported controls. If the result says Restore needs service start, use Start, then Check, and reopen a known record. Do not repeat restore merely because services need to -start. The fresh-profile acceptance verified that a fulfilled request -survived restore and a post-backup marker did not. +start. The Windows 1.6.0.1 Beta 1 fresh-install acceptance verified that +a fulfilled request survived restore and a post-backup marker did not. Keep Station’s dedicated database and media evidence together in its own backup. Core’s native-profile backup must not be assumed to include an @@ -549,28 +562,21 @@ Troubleshooting Verified workflows and limits +The table records selected synthetic workflows from the original Windows +1.6.0.1 Beta 1 Sandbox run. Station’s later delivery has separate +Windows 1.6.0.1 acceptance. See the Windows 1.8.0.1 acceptance summary +for the workflows and upgrade path exercised on the current MSI. + Product Recorded result Precisely exercised --------- ----------------- -------------------------------------------------------------------------------------------------------------------- Zoning PASS GeoJSON/PostGIS import, cited dimensional rule, parcel answer, staff review/history/snapshot and native workspace. -These results come from the identified signed candidate’s fresh -normal-profile Sandbox exercise: real native IPC/HTTP/PostgreSQL and -selected headless controls. All accounts, source bundles and media were -synthetic. The guest install/uninstall and recovery passed, and the -owned Sandbox stopped. No host installed application or standalone -CivicCast was changed. This documentation task reuses those receipts; it -does not claim a new software acceptance run. - -See the Windows acceptance summary for this MSI. The historical evidence -index applies to its original build. - -The limits remain: actual city field acceptance and equipment/network -commissioning; Station automatic provisioning/SCM commissioning; every -UI/role combination; field recognition accuracy; and historical in-place -upgrades are not certified. They are not five invented feature -requirements. Fresh-install controlled beta handoff remains the accepted -scope. This package makes no city-deployment, publication or -general-availability claim. +The Windows 1.8.0.1 acceptance covers the tested installation paths and +selected synthetic workflows, including Boards & Commissions, Contracts, +and Procurement. Earlier results apply to their original builds. City +field acceptance, physical equipment and network commissioning, Station +automatic provisioning, and comprehensive UI and role coverage remain +outside the 1.8.0.1 checks. Terms of service and license @@ -635,12 +641,12 @@ amounts do not become a new authoritative calculation. Beta operation and recovery -Use the identified candidate in its supported fresh-install scope. -Preserve backups and original evidence. Test physical equipment and -chosen network/service configuration before relying on them. The -supplied acceptance describes selected synthetic workflows, not every -screen, vendor, field condition or upgrade. Operators decide whether a -particular deployment meets their own operational obligations. +Windows 1.8.0.1 was tested for fresh installation and in-place upgrade +from 1.7.2.1. Upgrade paths from versions older than 1.7.2.1 are +unverified. Station uses its separately configured service. Keep backups +and original evidence. Test your physical equipment and network and +service configuration before relying on them. See the acceptance summary +for the tested paths. Warranty and liability @@ -774,9 +780,9 @@ matching pinned source and verify its SHA256 manifest: python -c "import townlight_zoning; from importlib.metadata import version; print(version('townlight-zoning'))" Expected principal import: townlight_zoning; expected distribution -version: 0.2.3. Use a fresh empty database/profile for workflow testing. -Existing city data and the previous release remain untouched; no -in-place upgrade or old-import compatibility shim is supplied. +version: 0.2.3. For standalone component workflow testing, use a fresh +empty database and profile. These component commands do not perform a +Windows MSI upgrade. See First run for the supported Windows upgrade. License and responsible use diff --git a/USER-MANUAL.docx b/USER-MANUAL.docx index c884ef7..517d4a5 100644 Binary files a/USER-MANUAL.docx and b/USER-MANUAL.docx differ diff --git a/USER-MANUAL.md b/USER-MANUAL.md index f73cf7c..200ec6b 100644 --- a/USER-MANUAL.md +++ b/USER-MANUAL.md @@ -67,12 +67,18 @@ Staff should begin with First run and Daily workflow. Administrators should also | Native desktop source version | 1.8.0-1 | | Candidate hashes | [SHA-256 checksums](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/SHA256SUMS-Windows-1.8.0.1.txt) and [Windows acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) | | Current owned software license | AGPL-3.0-only | -| Acceptance composition | Fresh Windows x64 profile; inspections-preview; Station configured separately | +| Acceptance composition | Windows x64 fresh install and upgrade from 1.7.2.1. Select the full profile. Station uses separate configuration. | Start a new installation with an empty database and fresh Windows profile. For an upgrade from Windows 1.7.2.1, keep the existing profile. The approved profile path is `%LOCALAPPDATA%\CivicSuite`. Keep existing profiles and backups. ## First run +**Upgrade from 1.7.2.1.** For the tested upgrade from 1.7.2.1, back up city data and settings, close Townlight, run the signed Windows 1.8.0.1 MSI, and reopen Townlight under the same Windows account with its existing profile. Keep the existing `%LOCALAPPDATA%\CivicSuite` directory. Upgrade paths from versions older than 1.7.2.1 are unverified. Station uses its separately configured service. + +### Fresh installation + +Run the signed Windows 1.8.0.1 MSI and use an empty database and a new Townlight profile for first run. + 1. Download the signed MSI, matching source companion and checksums from the [public Windows release](https://github.com/townlight/townlight/releases/tag/townlight-windows-v1.8.0.1). 2. Verify the MSI hash and Authenticode publisher before installation. See the [Windows acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) for the tested setup. 3. Launch Townlight under the intended named Windows account. Choose the storage folders. Select **Townlight Inspections candidate** (`inspections-preview`) for the bounded desktop composition, including Access and Notice. A narrower default selection will not expose all workspaces. @@ -198,7 +204,7 @@ Source contracts: `townlight_runtime/zoning_bridge.py`, `townlight_zoning/main.p ### Runtime and storage -The accepted package targets **Windows x64 fresh installation**. Its native shell uses **Rust 2021, Tauri 2 and Microsoft WebView2**; browser assets are JavaScript built with **Vite 8.1.6**. This describes the native desktop frontend; Station has a separate React operator, specified below or in its product manual. Canonical business workflows use bundled **CPython 3.13.5, FastAPI, Pydantic, SQLAlchemy and Alembic**, with **PostgreSQL 17 / PostGIS** and managed original files. The installed runtime tested here contains FastAPI 0.162.0. Package minimum Python requirements can differ from the bundled executable; the metadata reference preserves both. No stack rewrite is implied by the beta label. +The accepted package supports Windows x64 fresh installation and upgrade from 1.7.2.1. Its native shell uses **Rust 2021, Tauri 2 and Microsoft WebView2**; browser assets are JavaScript built with **Vite 8.1.6**. This describes the native desktop frontend; Station has a separate React operator, specified below or in its product manual. Canonical business workflows use bundled **CPython 3.13.5, FastAPI, Pydantic, SQLAlchemy and Alembic**, with **PostgreSQL 17 / PostGIS** and managed original files. The installed runtime tested here contains FastAPI 0.162.0. Package minimum Python requirements can differ from the bundled executable; the metadata reference preserves both. No stack rewrite is implied by the beta label. The native transport is fixed to loopback `127.0.0.1:15480`; PostgreSQL uses the configured local runtime port (default `15432`). Optional local model service defaults to `127.0.0.1:15434`. Those are deployment defaults, not internet endpoints. The runtime has health, module and readiness endpoints; readiness is stronger than process existence. The task queue is the existing local Core task infrastructure, not an assertion that a separate Redis service is required for this desktop composition. @@ -317,7 +323,7 @@ Use protected local folders, account permissions and credential storage. Never i Save work and use Core’s canonical **Backup Now** before maintenance. That operation stops writers. Preserve the coherent profile/database/document backup and its receipt, then use **Start** to resume. A source export is not a full backup. -Use **Restore Latest Backup** through the supported controls. If the result says **Restore needs service start**, use **Start**, then **Check**, and reopen a known record. Do not repeat restore merely because services need to start. The fresh-profile acceptance verified that a fulfilled request survived restore and a post-backup marker did not. +Use **Restore Latest Backup** through the supported controls. If the result says **Restore needs service start**, use **Start**, then **Check**, and reopen a known record. Do not repeat restore merely because services need to start. The [Windows 1.6.0.1 Beta 1 fresh-install acceptance](https://github.com/townlight/townlight/releases/tag/townlight-beta-1) verified that a fulfilled request survived restore and a post-backup marker did not. Keep Station’s dedicated database and media evidence together in its own backup. Core’s native-profile backup must not be assumed to include an external Station data directory. Stop writers during a coordinated backup. Preserve failed media attempts and logs. @@ -338,15 +344,13 @@ On failure, record the time, selected composition, component/installer versions ## Verified workflows and limits +The table records selected synthetic workflows from the original [Windows 1.6.0.1 Beta 1](https://github.com/townlight/townlight/releases/tag/townlight-beta-1) Sandbox run. Station’s later delivery has [separate Windows 1.6.0.1 acceptance](https://github.com/townlight/townlight/releases/tag/townlight-beta-1-station-delivery). See the [Windows 1.8.0.1 acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) for the workflows and upgrade path exercised on the current MSI. + | Product | Recorded result | Precisely exercised | |----|----|----| | Zoning | PASS | GeoJSON/PostGIS import, cited dimensional rule, parcel answer, staff review/history/snapshot and native workspace. | -These results come from the identified signed candidate’s fresh normal-profile Sandbox exercise: real native IPC/HTTP/PostgreSQL and selected headless controls. All accounts, source bundles and media were synthetic. The guest install/uninstall and recovery passed, and the owned Sandbox stopped. No host installed application or standalone CivicCast was changed. This documentation task reuses those receipts; it does not claim a new software acceptance run. - -See the [Windows acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) for this MSI. The historical [evidence index](https://townlight.github.io/reference/sandbox-evidence-index.json) applies to its original build. - -The limits remain: actual city field acceptance and equipment/network commissioning; Station automatic provisioning/SCM commissioning; every UI/role combination; field recognition accuracy; and historical in-place upgrades are not certified. They are not five invented feature requirements. Fresh-install controlled beta handoff remains the accepted scope. This package makes no city-deployment, publication or general-availability claim. +The Windows 1.8.0.1 acceptance covers the tested installation paths and selected synthetic workflows, including Boards & Commissions, Contracts, and Procurement. Earlier results apply to their original builds. City field acceptance, physical equipment and network commissioning, Station automatic provisioning, and comprehensive UI and role coverage remain outside the 1.8.0.1 checks. ## Terms of service and license @@ -374,7 +378,7 @@ Staff verify the jurisdiction, source currency, permissions, citations and propo ### Beta operation and recovery -Use the identified candidate in its supported fresh-install scope. Preserve backups and original evidence. Test physical equipment and chosen network/service configuration before relying on them. The supplied acceptance describes selected synthetic workflows, not every screen, vendor, field condition or upgrade. Operators decide whether a particular deployment meets their own operational obligations. +Windows 1.8.0.1 was tested for fresh installation and in-place upgrade from 1.7.2.1. Upgrade paths from versions older than 1.7.2.1 are unverified. Station uses its separately configured service. Keep backups and original evidence. Test your physical equipment and network and service configuration before relying on them. See the [acceptance summary](https://github.com/townlight/townlight/releases/download/townlight-windows-v1.8.0.1/ACCEPTANCE-Windows-1.8.0.1.md) for the tested paths. ### Warranty and liability diff --git a/USER-MANUAL.pdf b/USER-MANUAL.pdf index 42d882f..016ef9a 100644 Binary files a/USER-MANUAL.pdf and b/USER-MANUAL.pdf differ diff --git a/USER-MANUAL.txt b/USER-MANUAL.txt index 7587908..9a10abb 100644 --- a/USER-MANUAL.txt +++ b/USER-MANUAL.txt @@ -1,7 +1,7 @@ Windows x64 Beta 1 · MSI 1.8.0.1 -The signed Windows x64 beta 1.8.0.1 updates installer metadata while -preserving the accepted signed application/runtime cabinet. +The signed Windows x64 beta 1.8.0.1 adds the three staff workspaces and +automatically refreshes the bundled runtime when upgrading from 1.7.2.1. - Townlight Zoning Manual - Contents @@ -70,22 +70,35 @@ included with the same documentation companion. Beta identity Identity Value - -------------------------------- ------------------------------------------------------------------------------- + -------------------------------- ------------------------------------------------------------------------------------------------------------------- Documentation Townlight Beta 1 naming, Access and Notice candidate - Windows MSI version 1.8.0.1 + Windows MSI version 1.8.0.1 Product component townlight-zoning 0.2.3 Principal import package townlight_zoning Native desktop source version 1.8.0-1 Candidate hashes SHA-256 checksums and Windows acceptance summary Current owned software license AGPL-3.0-only - Acceptance composition Fresh Windows x64 profile; inspections-preview; Station configured separately + Acceptance composition Windows x64 fresh install and upgrade from 1.7.2.1. Select the full profile. Station uses separate configuration. -Use an empty database and fresh Windows profile. The installer refuses -legacy profile initialization. The approved profile path is -%LOCALAPPDATA%\CivicSuite. Keep existing profiles and backups. +Start a new installation with an empty database and fresh Windows +profile. For an upgrade from Windows 1.7.2.1, keep the existing profile. +The approved profile path is %LOCALAPPDATA%\CivicSuite. Keep existing +profiles and backups. First run +Upgrade from 1.7.2.1. For the tested upgrade from 1.7.2.1, back up city +data and settings, close Townlight, run the signed Windows 1.8.0.1 MSI, +and reopen Townlight under the same Windows account with its existing +profile. Keep the existing %LOCALAPPDATA%\CivicSuite directory. Upgrade +paths from versions older than 1.7.2.1 are unverified. Station uses its +separately configured service. + +Fresh installation + +Run the signed Windows 1.8.0.1 MSI and use an empty database and a new +Townlight profile for first run. + 1. Download the signed MSI, matching source companion and checksums from the public Windows release. 2. Verify the MSI hash and Authenticode publisher before installation. @@ -283,16 +296,16 @@ Technical specifications Runtime and storage -The accepted package targets Windows x64 fresh installation. Its native -shell uses Rust 2021, Tauri 2 and Microsoft WebView2; browser assets are -JavaScript built with Vite 8.1.6. This describes the native desktop -frontend; Station has a separate React operator, specified below or in -its product manual. Canonical business workflows use bundled CPython -3.13.5, FastAPI, Pydantic, SQLAlchemy and Alembic, with PostgreSQL 17 / -PostGIS and managed original files. The installed runtime tested here -contains FastAPI 0.162.0. Package minimum Python requirements can differ -from the bundled executable; the metadata reference preserves both. No -stack rewrite is implied by the beta label. +The accepted package supports Windows x64 fresh installation and upgrade +from 1.7.2.1. Its native shell uses Rust 2021, Tauri 2 and Microsoft +WebView2; browser assets are JavaScript built with Vite 8.1.6. This +describes the native desktop frontend; Station has a separate React +operator, specified below or in its product manual. Canonical business +workflows use bundled CPython 3.13.5, FastAPI, Pydantic, SQLAlchemy and +Alembic, with PostgreSQL 17 / PostGIS and managed original files. The +installed runtime tested here contains FastAPI 0.162.0. Package minimum +Python requirements can differ from the bundled executable; the metadata +reference preserves both. No stack rewrite is implied by the beta label. The native transport is fixed to loopback 127.0.0.1:15480; PostgreSQL uses the configured local runtime port (default 15432). Optional local @@ -519,8 +532,8 @@ a full backup. Use Restore Latest Backup through the supported controls. If the result says Restore needs service start, use Start, then Check, and reopen a known record. Do not repeat restore merely because services need to -start. The fresh-profile acceptance verified that a fulfilled request -survived restore and a post-backup marker did not. +start. The Windows 1.6.0.1 Beta 1 fresh-install acceptance verified that +a fulfilled request survived restore and a post-backup marker did not. Keep Station’s dedicated database and media evidence together in its own backup. Core’s native-profile backup must not be assumed to include an @@ -549,28 +562,21 @@ Troubleshooting Verified workflows and limits +The table records selected synthetic workflows from the original Windows +1.6.0.1 Beta 1 Sandbox run. Station’s later delivery has separate +Windows 1.6.0.1 acceptance. See the Windows 1.8.0.1 acceptance summary +for the workflows and upgrade path exercised on the current MSI. + Product Recorded result Precisely exercised --------- ----------------- -------------------------------------------------------------------------------------------------------------------- Zoning PASS GeoJSON/PostGIS import, cited dimensional rule, parcel answer, staff review/history/snapshot and native workspace. -These results come from the identified signed candidate’s fresh -normal-profile Sandbox exercise: real native IPC/HTTP/PostgreSQL and -selected headless controls. All accounts, source bundles and media were -synthetic. The guest install/uninstall and recovery passed, and the -owned Sandbox stopped. No host installed application or standalone -CivicCast was changed. This documentation task reuses those receipts; it -does not claim a new software acceptance run. - -See the Windows acceptance summary for this MSI. The historical evidence -index applies to its original build. - -The limits remain: actual city field acceptance and equipment/network -commissioning; Station automatic provisioning/SCM commissioning; every -UI/role combination; field recognition accuracy; and historical in-place -upgrades are not certified. They are not five invented feature -requirements. Fresh-install controlled beta handoff remains the accepted -scope. This package makes no city-deployment, publication or -general-availability claim. +The Windows 1.8.0.1 acceptance covers the tested installation paths and +selected synthetic workflows, including Boards & Commissions, Contracts, +and Procurement. Earlier results apply to their original builds. City +field acceptance, physical equipment and network commissioning, Station +automatic provisioning, and comprehensive UI and role coverage remain +outside the 1.8.0.1 checks. Terms of service and license @@ -635,12 +641,12 @@ amounts do not become a new authoritative calculation. Beta operation and recovery -Use the identified candidate in its supported fresh-install scope. -Preserve backups and original evidence. Test physical equipment and -chosen network/service configuration before relying on them. The -supplied acceptance describes selected synthetic workflows, not every -screen, vendor, field condition or upgrade. Operators decide whether a -particular deployment meets their own operational obligations. +Windows 1.8.0.1 was tested for fresh installation and in-place upgrade +from 1.7.2.1. Upgrade paths from versions older than 1.7.2.1 are +unverified. Station uses its separately configured service. Keep backups +and original evidence. Test your physical equipment and network and +service configuration before relying on them. See the acceptance summary +for the tested paths. Warranty and liability diff --git a/docs/beta-1/docx/Townlight-Code-Manual-Beta-1.docx b/docs/beta-1/docx/Townlight-Code-Manual-Beta-1.docx index 533044f..c9d03a7 100644 Binary files a/docs/beta-1/docx/Townlight-Code-Manual-Beta-1.docx and b/docs/beta-1/docx/Townlight-Code-Manual-Beta-1.docx differ diff --git a/docs/beta-1/docx/Townlight-Core-Manual-Beta-1.docx b/docs/beta-1/docx/Townlight-Core-Manual-Beta-1.docx index 2217ed2..0d6c110 100644 Binary files a/docs/beta-1/docx/Townlight-Core-Manual-Beta-1.docx and b/docs/beta-1/docx/Townlight-Core-Manual-Beta-1.docx differ diff --git a/docs/beta-1/docx/Townlight-Inspections-Manual-Beta-1.docx b/docs/beta-1/docx/Townlight-Inspections-Manual-Beta-1.docx index 41f08b5..c1d12c9 100644 Binary files a/docs/beta-1/docx/Townlight-Inspections-Manual-Beta-1.docx and b/docs/beta-1/docx/Townlight-Inspections-Manual-Beta-1.docx differ diff --git a/docs/beta-1/docx/Townlight-Meetings-Manual-Beta-1.docx b/docs/beta-1/docx/Townlight-Meetings-Manual-Beta-1.docx index 083bd29..0eebbb9 100644 Binary files a/docs/beta-1/docx/Townlight-Meetings-Manual-Beta-1.docx and b/docs/beta-1/docx/Townlight-Meetings-Manual-Beta-1.docx differ diff --git a/docs/beta-1/docx/Townlight-Permitting-Manual-Beta-1.docx b/docs/beta-1/docx/Townlight-Permitting-Manual-Beta-1.docx index b83237e..b16b652 100644 Binary files a/docs/beta-1/docx/Townlight-Permitting-Manual-Beta-1.docx and b/docs/beta-1/docx/Townlight-Permitting-Manual-Beta-1.docx differ diff --git a/docs/beta-1/docx/Townlight-Planning-Manual-Beta-1.docx b/docs/beta-1/docx/Townlight-Planning-Manual-Beta-1.docx index b040999..50a8193 100644 Binary files a/docs/beta-1/docx/Townlight-Planning-Manual-Beta-1.docx and b/docs/beta-1/docx/Townlight-Planning-Manual-Beta-1.docx differ diff --git a/docs/beta-1/docx/Townlight-Records-Manual-Beta-1.docx b/docs/beta-1/docx/Townlight-Records-Manual-Beta-1.docx index dfdeb4a..6688ade 100644 Binary files a/docs/beta-1/docx/Townlight-Records-Manual-Beta-1.docx and b/docs/beta-1/docx/Townlight-Records-Manual-Beta-1.docx differ diff --git a/docs/beta-1/docx/Townlight-Station-Manual-Beta-1.docx b/docs/beta-1/docx/Townlight-Station-Manual-Beta-1.docx index 9ace432..99cb82a 100644 Binary files a/docs/beta-1/docx/Townlight-Station-Manual-Beta-1.docx and b/docs/beta-1/docx/Townlight-Station-Manual-Beta-1.docx differ diff --git a/docs/beta-1/docx/Townlight-Suite-Manual-Beta-1.docx b/docs/beta-1/docx/Townlight-Suite-Manual-Beta-1.docx index 3abbeee..94378e0 100644 Binary files a/docs/beta-1/docx/Townlight-Suite-Manual-Beta-1.docx and b/docs/beta-1/docx/Townlight-Suite-Manual-Beta-1.docx differ diff --git a/docs/beta-1/docx/Townlight-Zoning-Manual-Beta-1.docx b/docs/beta-1/docx/Townlight-Zoning-Manual-Beta-1.docx index 68eb999..517d4a5 100644 Binary files a/docs/beta-1/docx/Townlight-Zoning-Manual-Beta-1.docx and b/docs/beta-1/docx/Townlight-Zoning-Manual-Beta-1.docx differ diff --git a/docs/beta-1/index.html b/docs/beta-1/index.html index 4e31cc8..ad439d8 100644 --- a/docs/beta-1/index.html +++ b/docs/beta-1/index.html @@ -1 +1 @@ -
Connected municipal products help staff prepare, review and retain municipal work. Start with a controlled beta evaluation, keep original evidence, and make each official decision deliberately.
A shared foundation for accountable municipal work.
Operating manual →From request intake to a deliberate release.
Operating manual →Keep the agenda, decisions and evidence connected.
Operating manual →Trace every section to its source and history.
Operating manual →Retain reviewed source, advice and draft provenance for human review.
Operating manual →Review, approve and retain actual posting proof and a verified archive.
Operating manual →Bring parcel context and cited rules into one review.
Operating manual →Connect policy, analysis and municipal progress.
Operating manual →Prepare a complete, cited intake for staff review.
Operating manual →Preserve evidence and review every draft finding.
Operating manual →Capture the meeting and preserve its evidence.
Operating manual →Keep source versions and original hashes connected to staff work. Select the intended audience, review the saved revision, and explicitly attach the resulting evidence. Records retains the final response and release decisions.
The selected Townlight desktop composition includes Access and Notice staff workspaces alongside the existing municipal workflows. Station is a separately configured capture and media service. Standalone CivicCast keeps its own product, installation and data.
Download the Windows x64 beta 1.8.0.1, matching source and checksums from GitHub.
Native staff workspaces use canonical Python/PostgreSQL services. Station has a separate database, media store and explicit Townlight authority.
The Windows acceptance summary describes the fresh Windows install, staff workflow, and 1.7.2.1 upgrade checks. See its scope for coverage of other workflows and equipment.
Read the exact acceptance and limits →Begin with the current manual and download the Windows x64 beta 1.8.0.1. Configure the chosen test site and have its staff review source applicability and run the existing workflows.
Station offers an encrypted live SRT feed to separate CivicCast while recording. The PEG operator controls cable broadcast. Completed recordings can be explicitly uploaded to YouTube with a reviewed title and chosen visibility. The private Records original stays intact.
See the Townlight Portal Guide for the separately deployed resident portal.
Connected municipal products help staff prepare, review and retain municipal work. Start with a controlled beta evaluation, keep original evidence, and make each official decision deliberately.
A shared foundation for accountable municipal work.
Operating manual →From request intake to a deliberate release.
Operating manual →Keep the agenda, decisions and evidence connected.
Operating manual →Trace every section to its source and history.
Operating manual →Retain reviewed source, advice and draft provenance for human review.
Operating manual →Review, approve and retain actual posting proof and a verified archive.
Operating manual →Bring parcel context and cited rules into one review.
Operating manual →Connect policy, analysis and municipal progress.
Operating manual →Prepare a complete, cited intake for staff review.
Operating manual →Preserve evidence and review every draft finding.
Operating manual →Capture the meeting and preserve its evidence.
Operating manual →Keep source versions and original hashes connected to staff work. Select the intended audience, review the saved revision, and explicitly attach the resulting evidence. Records retains the final response and release decisions.
The selected Townlight desktop composition includes Access and Notice staff workspaces alongside the existing municipal workflows. Station is a separately configured capture and media service. Standalone CivicCast keeps its own product, installation and data.
Download the Windows x64 beta 1.8.0.1, matching source and checksums from GitHub.
Native staff workspaces use canonical Python/PostgreSQL services. Station has a separate database, media store and explicit Townlight authority.
The Windows acceptance summary describes the fresh Windows install, staff workflow, and 1.7.2.1 upgrade checks. See its scope for coverage of other workflows and equipment.
Read the exact acceptance and limits →Begin with the current manual and download the Windows x64 beta 1.8.0.1. Configure the chosen test site and have its staff review source applicability and run the existing workflows.
Station offers an encrypted live SRT feed to separate CivicCast while recording. The PEG operator controls cable broadcast. Completed recordings can be explicitly uploaded to YouTube with a reviewed title and chosen visibility. The private Records original stays intact.
See the Townlight Portal Guide for the separately deployed resident portal.
Start a new installation with an empty database and fresh Windows profile. For an upgrade from Windows 1.7.2.1, keep the existing profile. The approved profile path is %LOCALAPPDATA%\CivicSuite. Keep existing profiles and backups.
Upgrade from 1.7.2.1. For the tested upgrade from 1.7.2.1, back up city data and settings, close Townlight, run the signed Windows 1.8.0.1 MSI, and reopen Townlight under the same Windows account with its existing profile. Keep the existing %LOCALAPPDATA%\CivicSuite directory. Upgrade paths from versions older than 1.7.2.1 are unverified. Station uses its separately configured service.
Run the signed Windows 1.8.0.1 MSI and use an empty database and a new Townlight profile for first run.
The accepted package targets Windows x64 fresh
-installation. Its native shell uses Rust 2021, Tauri 2
+ The accepted package supports Windows x64 fresh installation and upgrade from 1.7.2.1. Its native shell uses Rust 2021, Tauri 2
and Microsoft WebView2; browser assets are JavaScript built
with Vite 8.1.6. This describes the native desktop
frontend; Station has a separate React operator, specified below or in
@@ -594,7 +595,7 @@ Backup recovery and
controls. If the result says Restore needs service
start, use Start, then Check,
and reopen a known record. Do not repeat restore merely because services
-need to start. The fresh-profile acceptance verified that a fulfilled
+need to start. The Windows 1.6.0.1 Beta 1 fresh-install acceptance verified that a fulfilled
request survived restore and a post-backup marker did not.
Keep Station’s dedicated database and media evidence together in its own backup. Core’s native-profile backup must not be assumed to include @@ -675,6 +676,7 @@
The table records selected synthetic workflows from the original Windows 1.6.0.1 Beta 1 Sandbox run. Station’s later delivery has separate Windows 1.6.0.1 acceptance. See the Windows 1.8.0.1 acceptance summary for the workflows and upgrade path exercised on the current MSI.
These results come from the identified signed candidate’s fresh -normal-profile Sandbox exercise: real native IPC/HTTP/PostgreSQL and -selected headless controls. All accounts, source bundles and media were -synthetic. The guest install/uninstall and recovery passed, and the -owned Sandbox stopped. No host installed application or standalone -CivicCast was changed. This documentation task reuses those receipts; it -does not claim a new software acceptance run.
-See the Windows acceptance summary for this MSI. The historical evidence index applies to its original build.
-The limits remain: actual city field acceptance and equipment/network -commissioning; Station automatic provisioning/SCM commissioning; every -UI/role combination; field recognition accuracy; and historical in-place -upgrades are not certified. They are not five invented feature -requirements. Fresh-install controlled beta handoff remains the accepted -scope. This package makes no city-deployment, publication or -general-availability claim.
+ +The Windows 1.8.0.1 acceptance covers the tested installation paths and selected synthetic workflows, including Boards & Commissions, Contracts, and Procurement. Earlier results apply to their original builds. City field acceptance, physical equipment and network commissioning, Station automatic provisioning, and comprehensive UI and role coverage remain outside the 1.8.0.1 checks.
These terms describe the Townlight Beta 1 software and this @@ -769,12 +758,7 @@
Use the identified candidate in its supported fresh-install scope. -Preserve backups and original evidence. Test physical equipment and -chosen network/service configuration before relying on them. The -supplied acceptance describes selected synthetic workflows, not every -screen, vendor, field condition or upgrade. Operators decide whether a -particular deployment meets their own operational obligations.
+Windows 1.8.0.1 was tested for fresh installation and in-place upgrade from 1.7.2.1. Upgrade paths from versions older than 1.7.2.1 are unverified. Station uses its separately configured service. Keep backups and original evidence. Test your physical equipment and network and service configuration before relying on them. See the acceptance summary for the tested paths.
The covered software’s warranty and liability conditions are those in sections 15–17 of the supplied AGPL and any applicable separate written @@ -980,4 +964,4 @@