refactor: clean up project structure and rename base package

Author: Soturine

.github/ISSUE_TEMPLATE/config.yml

@@ -1,6 +1,5 @@
 blank_issues_enabled: false
 contact_links:
   - name: Segurança
-    url: https://github.com/seunome/scanora/security
+    url: https://github.com/Soturine/scanora/security
     about: Não abra issues públicas para vulnerabilidades.
-

.github/workflows/pages.yml

@@ -4,7 +4,7 @@ on:
   push:
     branches: ["main"]
     paths:
-      - "docs/**"
+      - "site/**"
       - ".github/workflows/pages.yml"
   workflow_dispatch:
 
@@ -31,7 +31,7 @@ jobs:
         run: |
           rm -rf _site
           mkdir -p _site
-          cp -R docs/. _site/
+          cp -R site/. _site/
           touch _site/.nojekyll
 
       - name: Upload artifact
@@ -42,7 +42,7 @@ jobs:
   deploy:
     environment:
       name: github-pages
-      url: placeholder-page-url
+      url: ${{ steps.deployment.outputs.page_url }}
     needs: build
     runs-on: ubuntu-latest
     steps:

.gitignore

@@ -1,5 +1,6 @@
 .gradle/
 .idea/
+.vscode/
 build/
 **/build/
 local.properties

CHANGELOG.md

@@ -2,6 +2,30 @@
 
 Este projeto segue Semantic Versioning e recomenda Conventional Commits no fluxo de contribuição.
 
+## [0.1.2] - 2026-04-22
+
+### Added
+
+- Estrutura `planning/` para documentos de escopo e planejamento.
+- Diretório `site/` dedicado ao GitHub Pages, separado da documentação técnica.
+
+### Changed
+
+- Rename completo de package, namespace e `applicationId` para `com.soturine.scanora`.
+- README, site e workflows foram revisados para deixar a apresentação pública mais direta e consistente.
+- `docs/` passou a conter apenas documentação técnica em Markdown.
+
+### Fixed
+
+- Links e templates que ainda apontavam para placeholders antigos ou para caminhos legados do site.
+- Workflow do GitHub Pages agora publica `site/` em vez de `docs/`.
+- Referências internas do projeto foram alinhadas ao package real sem quebrar imports.
+
+### Planned
+
+- Substituir mockups e placeholders por capturas reais do app em emulador ou dispositivo.
+- Refinar o material de release e o checklist para publicação 1.0.
+
 ## [0.1.1] - 2026-04-21
 
 ### Added
@@ -23,7 +47,7 @@ Este projeto segue Semantic Versioning e recomenda Conventional Commits no fluxo
 
 ### Planned
 
-- Rodar revisão visual em emulador/dispositivos reais para validar espaçamento, responsividade e estados extremos.
+- Rodar revisão visual em emulador ou dispositivos reais para validar espaçamento, responsividade e estados extremos.
 - Ampliar cobertura de testes instrumentados para fluxos de revisão, OCR e exportação.
 
 ## [0.1.0] - 2026-04-21

README.md

@@ -3,47 +3,32 @@
 ![Android](https://img.shields.io/badge/platform-Android-2E7D8C)
 ![Kotlin](https://img.shields.io/badge/Kotlin-2.3.10-23414B)
 ![Compose](https://img.shields.io/badge/Jetpack%20Compose-2026.03.00-DD8A2E)
-![Version](https://img.shields.io/badge/version-0.1.1-133942)
-![Status](https://img.shields.io/badge/status-MVP%20ativo-2E7D8C)
+![Version](https://img.shields.io/badge/version-0.1.2-133942)
 [![Android CI](https://github.com/Soturine/scanora/actions/workflows/android-ci.yml/badge.svg)](https://github.com/Soturine/scanora/actions/workflows/android-ci.yml)
 [![Deploy Pages](https://github.com/Soturine/scanora/actions/workflows/pages.yml/badge.svg)](https://github.com/Soturine/scanora/actions/workflows/pages.yml)
 
-Repositorio: https://github.com/Soturine/scanora
-Site: https://soturine.github.io/scanora/
-Releases: https://github.com/Soturine/scanora/releases
+Scanora é um app Android de escaneamento de documentos com foco em processamento local, OCR no dispositivo e um fluxo direto de captura, revisão e exportação.
 
-Scanora é um app Android original de escaneamento de documentos com foco em privacidade, processamento local e uma experiência rápida de captura, revisão e exportação.
+Repositório: https://github.com/Soturine/scanora  
+Releases: https://github.com/Soturine/scanora/releases  
+Site: https://soturine.github.io/scanora/
 
 ## Proposta de valor
 
-- Escanear documentos, recibos e páginas de estudo sem depender de upload obrigatório.
-- Corrigir perspectiva, aplicar filtros e organizar lotes localmente.
-- Exportar PDF, JPG e PNG com fluxo pensado para MVP evolutivo.
-- Executar OCR local para copiar texto reconhecido com poucos toques.
-
-## Destaques do MVP
-
-- Fluxo híbrido com `CameraX` para captura manual e `ML Kit Document Scanner` para scanner guiado.
-- OCR com `ML Kit Text Recognition`.
-- Organização local com `Room`, busca por título, favoritos e tags.
-- Preferências locais com `DataStore`.
-- Exportação local com `PdfDocument` e compartilhamento via `FileProvider`.
-- Tema claro/escuro e onboarding curto em português do Brasil.
+- escanear documentos, recibos e páginas de estudo sem upload obrigatório;
+- corrigir perspectiva, aplicar filtros e organizar lotes localmente;
+- exportar PDF, JPG e PNG com compartilhamento nativo do Android;
+- executar OCR local para copiar texto reconhecido com poucos toques.
 
-## Screenshots
+## Capturas
 
-Placeholders iniciais:
-
-- ![Home](docs/assets/screenshots/home.svg)
-- ![Captura](docs/assets/screenshots/camera.svg)
-- ![Editor](docs/assets/screenshots/editor.svg)
-- ![Histórico](docs/assets/screenshots/history.svg)
+Capturas reais em breve.  
+Enquanto isso, o repositório já está validado com build Android, lint e testes unitários passando no CI.
 
 ## Stack
 
 - Kotlin
 - Android Gradle Plugin 9.1.0
-- Gradle 9.3.1 Wrapper
 - Jetpack Compose + Material 3
 - Navigation Compose
 - ViewModel + Coroutines + Flow
@@ -54,62 +39,50 @@ Placeholders iniciais:
 - ML Kit Document Scanner
 - ML Kit Text Recognition
 
-## Arquitetura resumida
-
-Estrutura modular usada no repositório:
+## Arquitetura
 
-- `app`: entrypoint, navegação, onboarding, splash e composição dos módulos.
-- `core-common`: modelos, contratos de repositório e use cases centrais.
-- `core-data`: Room, DataStore, OCR, exportação e pipeline local de imagem.
-- `core-ui`: tema e componentes reutilizáveis de UI.
-- `feature-home`, `feature-camera`, `feature-editor`, `feature-export`, `feature-history`, `feature-settings`, `feature-ocr`: telas e ViewModels por contexto funcional.
+- `app`: bootstrap, navegação, onboarding e integração dos módulos
+- `core-common`: modelos, contratos e use cases
+- `core-data`: Room, DataStore, OCR, exportação e processamento de imagem
+- `core-ui`: tema e componentes reutilizáveis
+- `feature-*`: telas e ViewModels por contexto funcional
 
-Mais detalhes em [docs/architecture.md](docs/architecture.md).
+Documentação técnica:
+- [docs/architecture.md](docs/architecture.md)
+- [docs/decisions.md](docs/decisions.md)
+- [docs/setup.md](docs/setup.md)
+- [docs/testing.md](docs/testing.md)
+- [docs/publishing.md](docs/publishing.md)
 
 ## Como rodar
 
-1. Abra o projeto no Android Studio mais recente com suporte a AGP 9.1.
-2. Use JDK 17 ou superior compatível com AGP 9 no Gradle.
+1. Abra o projeto no Android Studio com suporte a AGP 9.1.
+2. Use JDK 17 ou superior compatível com AGP 9.
 3. Instale Android SDK Platform 36 e Build Tools 36.0.0.
-4. Rode `./gradlew assembleDebug` ou use o botão Run do Android Studio.
+4. Rode `./gradlew assembleDebug` ou execute o módulo `app`.
 
-Setup detalhado: [docs/setup.md](docs/setup.md)
+Package atual:
+- `applicationId`: `com.soturine.scanora`
+- namespace base: `com.soturine.scanora`
 
-## Privacidade
+## GitHub e CI
 
-- Processamento local por padrão.
-- OCR e filtros são executados no dispositivo sempre que possível.
-- O scanner guiado do ML Kit depende de componentes do Google Play services no aparelho.
-- O app não exige backend nem conta para funcionar no MVP.
+- O workflow [Android CI](https://github.com/Soturine/scanora/actions/workflows/android-ci.yml) builda o projeto, roda lint e testes unitários.
+- O site em GitHub Pages é publicado a partir de `site/`.
+- Para o Pages funcionar no repositório publicado, ative em `Settings > Pages > Source: GitHub Actions`.
 
-Leia a política em [PRIVACY_POLICY.md](PRIVACY_POLICY.md).
-
-## Limitações atuais
-
-- O pipeline local de detecção de documento ainda é heurístico para importações/capturas manuais.
-- O scanner guiado depende da disponibilidade do ML Kit no dispositivo.
-- Build, lint e testes unitários foram validados localmente em 2026-04-21 com Android SDK Platform 36.
-- A revisão visual desta rodada foi estática, via Compose/code review; ainda vale fechar QA em emulador e dispositivos reais.
-- Ainda não há sincronização em nuvem, criptografia em repouso ou edição colaborativa.
-
-## Contribuição
-
-Contribuições são bem-vindas. Consulte:
-
-- [CONTRIBUTING.md](CONTRIBUTING.md)
-- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
-- [SECURITY.md](SECURITY.md)
+## Privacidade
 
-## Roadmap
+- processamento local por padrão;
+- OCR e filtros executados no dispositivo sempre que possível;
+- sem backend obrigatório, login ou sync no MVP.
 
-Resumo curto:
+Política completa em [PRIVACY_POLICY.md](PRIVACY_POLICY.md).
 
-- Curto prazo: melhorar detecção de contornos, UX de crop e qualidade de exportação.
-- Médio prazo: lote multi-importação mais robusto, favoritos avançados e mais testes.
-- Longo prazo: preparação de release 1.0, hardening de storage e refinamento de OCR.
+## Status
 
-Versão completa em [ROADMAP.md](ROADMAP.md).
+`0.1.2` representa um MVP funcional com estrutura mais limpa de repositório, package real e CI ativo. Ainda faltam capturas reais, QA visual em dispositivos e refinamentos para uma release 1.0.
 
-## Status do projeto
+## Contribuir
 
-`0.1.1` representa um MVP funcional e escalável, já validado em build local e pronto para refinamento técnico e polimento de produção.
+Consulte [CONTRIBUTING.md](CONTRIBUTING.md), [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md), [SECURITY.md](SECURITY.md) e [ROADMAP.md](ROADMAP.md).

app/build.gradle.kts

@@ -4,11 +4,11 @@ plugins {
 }
 
 android {
-    namespace = "com.seunome.scanora"
+    namespace = "com.soturine.scanora"
     compileSdk = libs.versions.compileSdk.get().toInt()
 
     defaultConfig {
-        applicationId = "com.seunome.scanora"
+        applicationId = "com.soturine.scanora"
         minSdk = libs.versions.minSdk.get().toInt()
         targetSdk = libs.versions.targetSdk.get().toInt()
         versionCode = libs.versions.versionCode.get().toInt()

…/com/seunome/scanora/MainActivityTest.kt …com/soturine/scanora/MainActivityTest.ktapp/src/androidTest/java/com/seunome/scanora/MainActivityTest.kt renamed to app/src/androidTest/java/com/soturine/scanora/MainActivityTest.kt app/src/androidTest/java/com/seunome/scanora/MainActivityTest.kt renamed to app/src/androidTest/java/com/soturine/scanora/MainActivityTest.kt

@@ -1,4 +1,4 @@
-package com.seunome.scanora
+package com.soturine.scanora
 
 import androidx.compose.ui.test.assertExists
 import androidx.compose.ui.test.junit4.createAndroidComposeRule

…java/com/seunome/scanora/MainActivity.kt …ava/com/soturine/scanora/MainActivity.ktapp/src/main/java/com/seunome/scanora/MainActivity.kt renamed to app/src/main/java/com/soturine/scanora/MainActivity.kt app/src/main/java/com/seunome/scanora/MainActivity.kt renamed to app/src/main/java/com/soturine/scanora/MainActivity.kt

@@ -1,15 +1,15 @@
-package com.seunome.scanora
+package com.soturine.scanora
 
 import android.os.Bundle
 import androidx.activity.ComponentActivity
 import androidx.activity.compose.setContent
 import androidx.compose.runtime.getValue
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
-import com.seunome.scanora.app.RootViewModel
-import com.seunome.scanora.core.common.model.AppThemePreference
-import com.seunome.scanora.core.ui.theme.ScanoraTheme
-import com.seunome.scanora.navigation.ScanoraNavHost
-import com.seunome.scanora.splash.SplashScreen
+import com.soturine.scanora.app.RootViewModel
+import com.soturine.scanora.core.common.model.AppThemePreference
+import com.soturine.scanora.core.ui.theme.ScanoraTheme
+import com.soturine.scanora.navigation.ScanoraNavHost
+import com.soturine.scanora.splash.SplashScreen
 
 class MainActivity : ComponentActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {

…om/seunome/scanora/ScanoraApplication.kt …m/soturine/scanora/ScanoraApplication.ktapp/src/main/java/com/seunome/scanora/ScanoraApplication.kt renamed to app/src/main/java/com/soturine/scanora/ScanoraApplication.kt app/src/main/java/com/seunome/scanora/ScanoraApplication.kt renamed to app/src/main/java/com/soturine/scanora/ScanoraApplication.kt

@@ -1,11 +1,11 @@
-package com.seunome.scanora
+package com.soturine.scanora
 
 import android.app.Application
 import androidx.work.ExistingPeriodicWorkPolicy
 import androidx.work.PeriodicWorkRequestBuilder
 import androidx.work.WorkManager
-import com.seunome.scanora.app.AppContainer
-import com.seunome.scanora.core.data.work.CleanupExportsWorker
+import com.soturine.scanora.app.AppContainer
+import com.soturine.scanora.core.data.work.CleanupExportsWorker
 import java.util.concurrent.TimeUnit
 
 class ScanoraApplication : Application() {

…/com/seunome/scanora/app/AppContainer.kt …com/soturine/scanora/app/AppContainer.ktapp/src/main/java/com/seunome/scanora/app/AppContainer.kt renamed to app/src/main/java/com/soturine/scanora/app/AppContainer.kt app/src/main/java/com/seunome/scanora/app/AppContainer.kt renamed to app/src/main/java/com/soturine/scanora/app/AppContainer.kt

@@ -1,18 +1,18 @@
-package com.seunome.scanora.app
+package com.soturine.scanora.app
 
 import android.content.Context
 import androidx.room.Room
-import com.seunome.scanora.core.common.repository.DocumentProcessingRepository
-import com.seunome.scanora.core.common.repository.ExportRepository
-import com.seunome.scanora.core.common.repository.OcrRepository
-import com.seunome.scanora.core.common.repository.ScanRepository
-import com.seunome.scanora.core.common.repository.UserPreferencesRepository
-import com.seunome.scanora.core.data.datastore.DefaultUserPreferencesRepository
-import com.seunome.scanora.core.data.export.DefaultExportRepository
-import com.seunome.scanora.core.data.image.DefaultDocumentProcessingRepository
-import com.seunome.scanora.core.data.local.ScanoraDatabase
-import com.seunome.scanora.core.data.ocr.DefaultOcrRepository
-import com.seunome.scanora.core.data.repository.DefaultScanRepository
+import com.soturine.scanora.core.common.repository.DocumentProcessingRepository
+import com.soturine.scanora.core.common.repository.ExportRepository
+import com.soturine.scanora.core.common.repository.OcrRepository
+import com.soturine.scanora.core.common.repository.ScanRepository
+import com.soturine.scanora.core.common.repository.UserPreferencesRepository
+import com.soturine.scanora.core.data.datastore.DefaultUserPreferencesRepository
+import com.soturine.scanora.core.data.export.DefaultExportRepository
+import com.soturine.scanora.core.data.image.DefaultDocumentProcessingRepository
+import com.soturine.scanora.core.data.local.ScanoraDatabase
+import com.soturine.scanora.core.data.ocr.DefaultOcrRepository
+import com.soturine.scanora.core.data.repository.DefaultScanRepository
 
 class AppContainer(
     private val context: Context,