diff --git a/README.md b/README.md index d23922a..842bd2d 100644 --- a/README.md +++ b/README.md @@ -4,13 +4,21 @@ English | [Português (Brasil)](README.pt-BR.md) [![Build](https://github.com/leoars/PostgresManagementStudio/actions/workflows/build.yml/badge.svg)](https://github.com/leoars/PostgresManagementStudio/actions/workflows/build.yml) [![Pre-release](https://img.shields.io/github/v/release/leoars/PostgresManagementStudio?include_prereleases&label=pre-release)](https://github.com/leoars/PostgresManagementStudio/releases) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) -A Windows desktop application for querying and administering PostgreSQL, built with C#, WPF, .NET 10 and Npgsql. Its interface takes inspiration from SQL Server Management Studio (SSMS), with PostgreSQL semantics and its own implementation. +**The SQL Server Management Studio experience, for PostgreSQL.** A native Windows client with Object Explorer, F5 to run, execution plans, session monitoring and backup/restore, built for people who already think in SSMS. -**Pre-release: v0.1.0-alpha.1 (Windows x64).** [Download and installation](https://github.com/leoars/PostgresManagementStudio/releases/tag/v0.1.0-alpha.1) · [Release notes](docs/en/release-notes.md). Portable ZIP and [graphical installer](docs/en/graphical-installer.md) include .NET/WPF. Setup offers English/pt-BR, current-user or all-users installation and a desktop shortcut. The PowerShell 7 installer remains available. Build label M1008 is an internal identifier. See the [validation guide](docs/en/validation.md) for accepted scope and known limits; full SSMS parity is not claimed. +**[Download v0.1.0-alpha.1 for Windows x64](https://github.com/leoars/PostgresManagementStudio/releases/tag/v0.1.0-alpha.1)** · Graphical installer (EN/pt-BR) or portable ZIP, .NET runtime included · Works with PostgreSQL 17 and 18 -![PGMS editor, Object Explorer and synthetic results](docs/assets/pgms-results-m959.jpg) +![PGMS editor, Object Explorer and query results](docs/assets/pgms-results-m959.jpg) -Historical M957 preview captured during M959 using the isolated test cluster and synthetic data. This illustrates the interface, not the current release package. [Image provenance](docs/assets/README.md). +> Early pre-release. Querying, browsing and monitoring are the core of this alpha; administration and backup run through reviewable SQL and the official PostgreSQL tools. Full SSMS parity is not claimed. See [known limits](docs/en/validation.md) and [release notes](docs/en/release-notes.md). + +## Why PGMS + +- **Feels like SSMS.** Object Explorer, query tabs with their own sessions, Results/Messages, F5 and the shortcuts you already use. +- **Review before you apply.** Administrative changes are shown as SQL first, so nothing touches the server without you reading it. +- **Know what's running.** Session and blocker monitor that distinguishes cancelling a query from terminating a session. +- **Native and fast.** C#/WPF on .NET 10, no browser and no JVM. +- **Your drafts survive.** Unsaved query tabs are checkpointed and recovered after a crash or forced close, encrypted per Windows user. ## Features @@ -23,6 +31,12 @@ Historical M957 preview captured during M959 using the isolated test cluster and ## Get started +### Install + +Download the installer or the ZIP from the [latest release](https://github.com/leoars/PostgresManagementStudio/releases), run it, then use **Connect** and **New Query**. Backup/restore needs the PostgreSQL client tools (`pg_dump`, `pg_restore`, `psql`) of the same major version as the server. Details: [setup guide](docs/en/getting-started.md). + +### Build from source + For development: Windows x64, PowerShell 7 and the .NET SDK selected by [global.json](global.json) (`10.0.400`, latest installed patch in that feature band). PostgreSQL 17/18 and matching-major tools are needed for database tests and backup/restore. ```powershell diff --git a/README.pt-BR.md b/README.pt-BR.md index ba8c5fb..5fdfdec 100644 --- a/README.pt-BR.md +++ b/README.pt-BR.md @@ -4,13 +4,21 @@ [![Build](https://github.com/leoars/PostgresManagementStudio/actions/workflows/build.yml/badge.svg)](https://github.com/leoars/PostgresManagementStudio/actions/workflows/build.yml) [![Pré-release](https://img.shields.io/github/v/release/leoars/PostgresManagementStudio?include_prereleases&label=pr%C3%A9-release)](https://github.com/leoars/PostgresManagementStudio/releases) [![Licença: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) -Aplicativo Windows para consultar e administrar PostgreSQL, desenvolvido em C#, WPF, .NET 10 e Npgsql. A interface tem o SQL Server Management Studio (SSMS) como referência, com semântica PostgreSQL e implementação própria. +**A experiência do SQL Server Management Studio, para PostgreSQL.** Cliente nativo Windows com Object Explorer, F5 para executar, planos de execução, monitor de sessões e backup/restore, feito para quem já pensa em SSMS. -**Pré-release: v0.1.0-alpha.1 (Windows x64).** [Download e instalação](https://github.com/leoars/PostgresManagementStudio/releases/tag/v0.1.0-alpha.1) · [Notas da versão](docs/pt-BR/release-notes.md). ZIP portátil e [instalador gráfico](docs/pt-BR/graphical-installer.md) incluem .NET/WPF. O assistente oferece inglês/pt-BR, instalação por usuário ou para todos e atalho na área de trabalho. O instalador PowerShell 7 continua disponível. O rótulo M1008 é interno. Veja o [guia de validação](docs/pt-BR/validation.md) para escopo aceito e limites conhecidos; não se declara paridade integral com SSMS. +**[Baixar v0.1.0-alpha.1 para Windows x64](https://github.com/leoars/PostgresManagementStudio/releases/tag/v0.1.0-alpha.1)** · Instalador gráfico (EN/pt-BR) ou ZIP portátil, runtime .NET incluído · Funciona com PostgreSQL 17 e 18 -![Editor, Object Explorer e resultados sintéticos do PGMS](docs/assets/pgms-results-m959.jpg) +![Editor, Object Explorer e resultados do PGMS](docs/assets/pgms-results-m959.jpg) -Prévia histórica M957 capturada na M959, com cluster isolado e dados sintéticos. A imagem ilustra a interface, não o pacote atual. [Origem da imagem](docs/assets/README.md). +> Pré-release inicial. Consultas, navegação e monitoramento são o núcleo desta alpha; administração e backup usam SQL revisável e as ferramentas oficiais do PostgreSQL. Não se declara paridade integral com SSMS. Veja os [limites conhecidos](docs/pt-BR/validation.md) e as [notas da versão](docs/pt-BR/release-notes.md). + +## Por que o PGMS + +- **Parece o SSMS.** Object Explorer, abas de consulta com sessão própria, Results/Messages, F5 e os atalhos que você já usa. +- **Revise antes de aplicar.** Mudanças administrativas aparecem primeiro como SQL; nada chega ao servidor sem você ler. +- **Saiba o que está rodando.** Monitor de sessões e bloqueios que distingue cancelar a consulta de encerrar a sessão. +- **Nativo e rápido.** C#/WPF em .NET 10, sem navegador e sem JVM. +- **Seus rascunhos sobrevivem.** Abas não salvas têm checkpoint periódico e são recuperadas após falha ou fechamento forçado, criptografadas por usuário do Windows. ## Funcionalidades @@ -23,6 +31,12 @@ Prévia histórica M957 capturada na M959, com cluster isolado e dados sintétic ## Começar +### Instalar + +Baixe o instalador ou o ZIP na [release mais recente](https://github.com/leoars/PostgresManagementStudio/releases), execute e use **Connect** e **New Query**. Backup/restore exige as ferramentas cliente do PostgreSQL (`pg_dump`, `pg_restore`, `psql`) da mesma versão principal do servidor. Detalhes: [guia de preparação](docs/pt-BR/getting-started.md). + +### Compilar a partir do código + Para desenvolvimento: Windows x64, PowerShell 7 e SDK .NET selecionado por [global.json](global.json) (`10.0.400`, com o patch mais recente instalado nessa faixa). PostgreSQL 17/18 e ferramentas da mesma versão principal são necessários para testes com banco e backup/restore. ```powershell diff --git a/docs/assets/README.md b/docs/assets/README.md index d35f6ba..581f792 100644 --- a/docs/assets/README.md +++ b/docs/assets/README.md @@ -3,3 +3,7 @@ `pgms-results-m959.jpg` is an unmodified historical PGMS M957 preview screenshot, captured during M959 with a disposable loopback cluster and synthetic query data. It is not a current-release screenshot. No SSMS screenshot or binary is included. The Slonik application icon retains its own artwork license and trademark terms; see [third-party notices](../../THIRD-PARTY-NOTICES.md). `pgms-results-m959.jpg` é uma captura histórica do PGMS M957, sem alterações, feita na M959 com cluster descartável em loopback e dados sintéticos. Não é uma captura da release atual. Não inclui captura ou binário SSMS. O ícone Slonik mantém sua licença de arte e condições de marca; veja os [avisos de terceiros](../../THIRD-PARTY-NOTICES.md). + +The README files show this image with alt text only; the caption above is the provenance record. It is a historical M957 preview captured during M959 and illustrates the interface, not the current release package. A short recording of the alpha package may replace it later. + +Os READMEs mostram a imagem apenas com texto alternativo; a legenda acima é o registro de origem. É uma prévia histórica M957 capturada na M959 e ilustra a interface, não o pacote da release atual. Uma gravação curta do pacote alpha pode substituí-la depois.