notion-workspace-app 0.3.0__tar.gz

notion_workspace_app-0.3.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+.env
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+*.sqlite3
+dist/
+build/
+*.egg-info/
+node_modules/
+staticfiles/
+server/static/frontend/

notion_workspace_app-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Felipe Alcantara
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

notion_workspace_app-0.3.0/PKG-INFO

@@ -0,0 +1,268 @@
+Metadata-Version: 2.5
+Name: notion-workspace-app
+Version: 0.3.0
+Summary: Aplicação local para operar o Notion: API Django, SPA React, servidor MCP e launcher TUI (start_app.py).
+Project-URL: Homepage, https://github.com/Felipe-Alcantara/notion-workspace-app
+Project-URL: Repository, https://github.com/Felipe-Alcantara/notion-workspace-app
+Author: Felipe Alcantara
+License: MIT License
+        
+        Copyright (c) 2026 Felipe Alcantara
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: django>=5.0
+Requires-Dist: mcp<2,>=1.28
+Requires-Dist: notion-starter<0.4.0,>=0.3.0
+Requires-Dist: questionary>=2.0
+Requires-Dist: requests>=2.25
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: responses>=0.23; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp<2,>=1.28; extra == 'mcp'
+Provides-Extra: server
+Requires-Dist: django>=5.0; extra == 'server'
+Description-Content-Type: text/markdown
+
+# 🧭 notion-workspace-app
+
+<div align="center">
+
+![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-3776AB?style=for-the-badge&logo=python&logoColor=white)
+![Django 5+](https://img.shields.io/badge/Django-5%2B-092E20?style=for-the-badge&logo=django&logoColor=white)
+![React 18](https://img.shields.io/badge/React-18-61DAFB?style=for-the-badge&logo=react&logoColor=black)
+![Vite 8](https://img.shields.io/badge/Vite-8-646CFF?style=for-the-badge&logo=vite&logoColor=white)
+![Licença MIT](https://img.shields.io/badge/Licen%C3%A7a-MIT-green?style=for-the-badge)
+
+**Aplicação local completa para operar o Notion com API Django, SPA React, servidor MCP e launcher TUI.**
+
+[📖 Sobre](#-sobre-o-projeto) • [🚀 Componentes](#-componentes) • [🎯 Como usar](#-como-usar) • [✅ Qualidade](#-qualidade)
+
+</div>
+
+---
+
+## 📋 Índice
+
+- [📖 Sobre o Projeto](#-sobre-o-projeto)
+- [📁 Estrutura do Projeto](#-estrutura-do-projeto)
+- [🚀 Componentes](#-componentes)
+- [✨ Funcionalidades](#-funcionalidades)
+- [🎯 Como Usar](#-como-usar)
+- [🔐 Configuração e Segurança](#-configuração-e-segurança)
+- [✅ Qualidade](#-qualidade)
+- [📄 Licença](#-licença)
+- [👤 Autor](#-autor)
+- [🤝 Contribuições](#-contribuições)
+
+---
+
+## 📖 Sobre o Projeto
+
+O `notion-workspace-app` reúne quatro interfaces sobre o mesmo núcleo de dados:
+uma **API REST Django**, uma **SPA React**, um **servidor MCP** para clientes de IA
+e um **launcher TUI** que prepara e inicia o ambiente. A aplicação permite
+gerenciar tarefas em kanban, grade ou lista, explorar o workspace e sincronizar
+repositórios do GitHub com databases do Notion.
+
+A regra de negócio compartilhada vem da biblioteca
+[notion-starter](https://github.com/Felipe-Alcantara/notion-starter). Este
+repositório mantém as bordas Django, React e MCP, além da configuração específica
+do produto. A porta de entrada recomendada é `python start_app.py`.
+
+O projeto integra o ecossistema
+[Automações do Notion](https://github.com/Felipe-Alcantara/Automa-es-do-Notion).
+
+---
+
+## 📁 Estrutura do Projeto
+
+```text
+notion-workspace-app/
+│
+├── 📁 server/                   # Backend Django e servidor MCP
+│   ├── 📁 api/                  # Views, serializers e rotas REST
+│   ├── 📁 config/               # Configuração do projeto Django
+│   ├── 📁 integrations/         # Notion local e shims de adaptadores
+│   ├── 📁 operations/           # Estado operacional em SQLite
+│   ├── 📁 services/             # Shims dos casos de uso compartilhados
+│   └── mcp_server.py            # Ferramentas notion.*
+│
+├── 📁 front/                    # SPA React com Vite
+│   ├── 📁 src/components/       # Interface, tarefas e exploração
+│   ├── 📁 src/hooks/            # Estado e acesso à API
+│   └── package-lock.json        # Resolução reproduzível do frontend
+│
+├── 📁 tests/                    # Suíte Python automatizada
+├── .github/workflows/ci.yml     # Gates Python e frontend
+├── start_app.py                 # Menu interativo de entrada
+├── requirements.txt             # Dependências Python
+├── QUALIDADE.md                 # Contrato de qualidade do módulo
+├── README.md                    # Este arquivo
+└── LICENSE                      # Licença MIT
+```
+
+Na distribuição `0.3.0`, `front/` é usado apenas no desenvolvimento: o workflow
+de release compila a SPA para `server/static/frontend/` e o wheel leva esse
+bundle. Assim, a instalação de usuário não precisa de Node/npm.
+
+---
+
+## 🚀 Componentes
+
+| Camada | Pasta | Descrição |
+| --- | --- | --- |
+| Launcher | `start_app.py` | TUI que instala dependências, configura e sobe servidor e front |
+| API | `server/api/` | REST Django para tarefas, exploração e opções |
+| Services | `server/services/` | Shims para tarefas, clonagem, ingestão, IA e GitHub |
+| Integrações | `server/integrations/` | Notion local e shims para GitHub/OpenRouter |
+| MCP | `server/mcp_server.py` | Servidor que expõe operações `notion.*` para IAs |
+| Front | `front/` | SPA React com kanban, filtros e exploração do workspace |
+
+---
+
+## ✨ Funcionalidades
+
+- visualizar tarefas em kanban, grade e lista;
+- buscar e filtrar tarefas por status, duração e área;
+- criar e editar tarefas pela interface;
+- explorar páginas e databases compartilhados;
+- sincronizar repositórios GitHub com databases do Notion;
+- expor operações para clientes de IA via MCP;
+- iniciar Django e Vite em conjunto pelo launcher interativo.
+
+Exemplo de fluxo: ação na SPA → API Django → serviço compartilhado → API do
+Notion.
+
+---
+
+## 🎯 Como Usar
+
+### Instalação distribuída
+
+Para usar o ecossistema completo, instale a fachada única:
+
+```bash
+pipx install "notion-automacoes[app]"
+# ou: uv tool install "notion-automacoes[app]"
+notion-automacoes doctor
+notion-automacoes app start
+notion-automacoes mcp start
+```
+
+O release técnico candidato é `0.3.0`; a publicação no PyPI aguarda confirmação
+de nome/ownership/metadados legais. Consulte o guia do hub para a sequência de
+release e o smoke em Windows, macOS e Linux.
+
+### Início rápido
+
+O fluxo abaixo é o de desenvolvimento pelo checkout:
+
+```bash
+# Clone o repositório
+git clone https://github.com/Felipe-Alcantara/notion-workspace-app.git
+cd notion-workspace-app
+
+# Instale as dependências Python de desenvolvimento
+python -m pip install -e ".[dev]"
+
+# Crie a configuração local e preencha os valores necessários
+cp .env.example .env
+
+# Abra o menu que instala, configura e inicia o produto
+python start_app.py
+```
+
+No checkout, o launcher aplica as migrações, sobe Django e Vite e abre o navegador. Pelo menu
+também é possível instalar dependências, configurar o ambiente e conferir o
+status dos componentes.
+
+Quando executado a partir do wheel, o mesmo launcher sobe apenas o Django e
+serve a SPA empacotada; Node/npm não são consultados.
+
+---
+
+## 🔐 Configuração e Segurança
+
+Use `.env.example` como modelo e mantenha o `.env` apenas na máquina local. Para
+operar o workspace, configure `NOTION_TOKEN` e, quando aplicável,
+`NOTION_DATABASE_ID`.
+
+Nunca versione tokens, IDs reais ou bancos SQLite. Os testes usam mocks e não
+dependem de credenciais reais.
+
+---
+
+## ✅ Qualidade
+
+Gate Python, executado na raiz:
+
+```bash
+python -m ruff check .
+python -m pytest
+```
+
+Gate da SPA:
+
+```bash
+cd front
+npm run lint
+npm run build
+```
+
+A CI executa Python 3.10–3.13 e um job Node 22 com `npm ci`. Consulte
+[`QUALIDADE.md`](QUALIDADE.md) para o critério de pronto e a política de
+dependências.
+
+---
+
+## 📄 Licença
+
+Este projeto está sob a licença MIT — veja [`LICENSE`](LICENSE).
+
+---
+
+## 👤 Autor
+
+**Felipe Martin**
+
+- GitHub: [@Felipe-Alcantara](https://github.com/Felipe-Alcantara)
+- Repositório: [notion-workspace-app](https://github.com/Felipe-Alcantara/notion-workspace-app)
+
+---
+
+## 🤝 Contribuições
+
+Contribuições são bem-vindas. Algumas ideias para quem quiser colaborar:
+
+- ampliar a escrita genérica na aba Explorar;
+- criar novas visualizações e interações no kanban;
+- melhorar o empacotamento do launcher;
+- expandir acessibilidade, testes e documentação.
+
+Leia [`CONTRIBUTING.md`](CONTRIBUTING.md) antes de enviar uma mudança.
+
+---
+
+⭐ Se o app foi útil, considere dar uma estrela no
+[GitHub](https://github.com/Felipe-Alcantara/notion-workspace-app).

notion_workspace_app-0.3.0/README.md

@@ -0,0 +1,222 @@
+# 🧭 notion-workspace-app
+
+<div align="center">
+
+![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-3776AB?style=for-the-badge&logo=python&logoColor=white)
+![Django 5+](https://img.shields.io/badge/Django-5%2B-092E20?style=for-the-badge&logo=django&logoColor=white)
+![React 18](https://img.shields.io/badge/React-18-61DAFB?style=for-the-badge&logo=react&logoColor=black)
+![Vite 8](https://img.shields.io/badge/Vite-8-646CFF?style=for-the-badge&logo=vite&logoColor=white)
+![Licença MIT](https://img.shields.io/badge/Licen%C3%A7a-MIT-green?style=for-the-badge)
+
+**Aplicação local completa para operar o Notion com API Django, SPA React, servidor MCP e launcher TUI.**
+
+[📖 Sobre](#-sobre-o-projeto) • [🚀 Componentes](#-componentes) • [🎯 Como usar](#-como-usar) • [✅ Qualidade](#-qualidade)
+
+</div>
+
+---
+
+## 📋 Índice
+
+- [📖 Sobre o Projeto](#-sobre-o-projeto)
+- [📁 Estrutura do Projeto](#-estrutura-do-projeto)
+- [🚀 Componentes](#-componentes)
+- [✨ Funcionalidades](#-funcionalidades)
+- [🎯 Como Usar](#-como-usar)
+- [🔐 Configuração e Segurança](#-configuração-e-segurança)
+- [✅ Qualidade](#-qualidade)
+- [📄 Licença](#-licença)
+- [👤 Autor](#-autor)
+- [🤝 Contribuições](#-contribuições)
+
+---
+
+## 📖 Sobre o Projeto
+
+O `notion-workspace-app` reúne quatro interfaces sobre o mesmo núcleo de dados:
+uma **API REST Django**, uma **SPA React**, um **servidor MCP** para clientes de IA
+e um **launcher TUI** que prepara e inicia o ambiente. A aplicação permite
+gerenciar tarefas em kanban, grade ou lista, explorar o workspace e sincronizar
+repositórios do GitHub com databases do Notion.
+
+A regra de negócio compartilhada vem da biblioteca
+[notion-starter](https://github.com/Felipe-Alcantara/notion-starter). Este
+repositório mantém as bordas Django, React e MCP, além da configuração específica
+do produto. A porta de entrada recomendada é `python start_app.py`.
+
+O projeto integra o ecossistema
+[Automações do Notion](https://github.com/Felipe-Alcantara/Automa-es-do-Notion).
+
+---
+
+## 📁 Estrutura do Projeto
+
+```text
+notion-workspace-app/
+│
+├── 📁 server/                   # Backend Django e servidor MCP
+│   ├── 📁 api/                  # Views, serializers e rotas REST
+│   ├── 📁 config/               # Configuração do projeto Django
+│   ├── 📁 integrations/         # Notion local e shims de adaptadores
+│   ├── 📁 operations/           # Estado operacional em SQLite
+│   ├── 📁 services/             # Shims dos casos de uso compartilhados
+│   └── mcp_server.py            # Ferramentas notion.*
+│
+├── 📁 front/                    # SPA React com Vite
+│   ├── 📁 src/components/       # Interface, tarefas e exploração
+│   ├── 📁 src/hooks/            # Estado e acesso à API
+│   └── package-lock.json        # Resolução reproduzível do frontend
+│
+├── 📁 tests/                    # Suíte Python automatizada
+├── .github/workflows/ci.yml     # Gates Python e frontend
+├── start_app.py                 # Menu interativo de entrada
+├── requirements.txt             # Dependências Python
+├── QUALIDADE.md                 # Contrato de qualidade do módulo
+├── README.md                    # Este arquivo
+└── LICENSE                      # Licença MIT
+```
+
+Na distribuição `0.3.0`, `front/` é usado apenas no desenvolvimento: o workflow
+de release compila a SPA para `server/static/frontend/` e o wheel leva esse
+bundle. Assim, a instalação de usuário não precisa de Node/npm.
+
+---
+
+## 🚀 Componentes
+
+| Camada | Pasta | Descrição |
+| --- | --- | --- |
+| Launcher | `start_app.py` | TUI que instala dependências, configura e sobe servidor e front |
+| API | `server/api/` | REST Django para tarefas, exploração e opções |
+| Services | `server/services/` | Shims para tarefas, clonagem, ingestão, IA e GitHub |
+| Integrações | `server/integrations/` | Notion local e shims para GitHub/OpenRouter |
+| MCP | `server/mcp_server.py` | Servidor que expõe operações `notion.*` para IAs |
+| Front | `front/` | SPA React com kanban, filtros e exploração do workspace |
+
+---
+
+## ✨ Funcionalidades
+
+- visualizar tarefas em kanban, grade e lista;
+- buscar e filtrar tarefas por status, duração e área;
+- criar e editar tarefas pela interface;
+- explorar páginas e databases compartilhados;
+- sincronizar repositórios GitHub com databases do Notion;
+- expor operações para clientes de IA via MCP;
+- iniciar Django e Vite em conjunto pelo launcher interativo.
+
+Exemplo de fluxo: ação na SPA → API Django → serviço compartilhado → API do
+Notion.
+
+---
+
+## 🎯 Como Usar
+
+### Instalação distribuída
+
+Para usar o ecossistema completo, instale a fachada única:
+
+```bash
+pipx install "notion-automacoes[app]"
+# ou: uv tool install "notion-automacoes[app]"
+notion-automacoes doctor
+notion-automacoes app start
+notion-automacoes mcp start
+```
+
+O release técnico candidato é `0.3.0`; a publicação no PyPI aguarda confirmação
+de nome/ownership/metadados legais. Consulte o guia do hub para a sequência de
+release e o smoke em Windows, macOS e Linux.
+
+### Início rápido
+
+O fluxo abaixo é o de desenvolvimento pelo checkout:
+
+```bash
+# Clone o repositório
+git clone https://github.com/Felipe-Alcantara/notion-workspace-app.git
+cd notion-workspace-app
+
+# Instale as dependências Python de desenvolvimento
+python -m pip install -e ".[dev]"
+
+# Crie a configuração local e preencha os valores necessários
+cp .env.example .env
+
+# Abra o menu que instala, configura e inicia o produto
+python start_app.py
+```
+
+No checkout, o launcher aplica as migrações, sobe Django e Vite e abre o navegador. Pelo menu
+também é possível instalar dependências, configurar o ambiente e conferir o
+status dos componentes.
+
+Quando executado a partir do wheel, o mesmo launcher sobe apenas o Django e
+serve a SPA empacotada; Node/npm não são consultados.
+
+---
+
+## 🔐 Configuração e Segurança
+
+Use `.env.example` como modelo e mantenha o `.env` apenas na máquina local. Para
+operar o workspace, configure `NOTION_TOKEN` e, quando aplicável,
+`NOTION_DATABASE_ID`.
+
+Nunca versione tokens, IDs reais ou bancos SQLite. Os testes usam mocks e não
+dependem de credenciais reais.
+
+---
+
+## ✅ Qualidade
+
+Gate Python, executado na raiz:
+
+```bash
+python -m ruff check .
+python -m pytest
+```
+
+Gate da SPA:
+
+```bash
+cd front
+npm run lint
+npm run build
+```
+
+A CI executa Python 3.10–3.13 e um job Node 22 com `npm ci`. Consulte
+[`QUALIDADE.md`](QUALIDADE.md) para o critério de pronto e a política de
+dependências.
+
+---
+
+## 📄 Licença
+
+Este projeto está sob a licença MIT — veja [`LICENSE`](LICENSE).
+
+---
+
+## 👤 Autor
+
+**Felipe Martin**
+
+- GitHub: [@Felipe-Alcantara](https://github.com/Felipe-Alcantara)
+- Repositório: [notion-workspace-app](https://github.com/Felipe-Alcantara/notion-workspace-app)
+
+---
+
+## 🤝 Contribuições
+
+Contribuições são bem-vindas. Algumas ideias para quem quiser colaborar:
+
+- ampliar a escrita genérica na aba Explorar;
+- criar novas visualizações e interações no kanban;
+- melhorar o empacotamento do launcher;
+- expandir acessibilidade, testes e documentação.
+
+Leia [`CONTRIBUTING.md`](CONTRIBUTING.md) antes de enviar uma mudança.
+
+---
+
+⭐ Se o app foi útil, considere dar uma estrela no
+[GitHub](https://github.com/Felipe-Alcantara/notion-workspace-app).

notion_workspace_app-0.3.0/front/README.md

@@ -0,0 +1,52 @@
+# Front React
+
+SPA do Ciclo 2 para operar tarefas do Notion pelo contrato REST em `docs/CONTRATOS.md`.
+
+## Rodar localmente
+
+```bash
+cd front
+npm install
+npm run dev
+```
+
+O Vite exige Node 20.19+ ou 22.12+. Ele sobe em `http://localhost:5173` e proxia
+`/api` para `http://127.0.0.1:8000`.
+
+O app usa o Notion como fonte de verdade por meio da API Django. Se a API falhar,
+o front mostra erro; mock só roda quando você ativar explicitamente:
+
+```bash
+VITE_MOCK_API=true npm run dev
+```
+
+## Qualidade
+
+```bash
+npm run lint
+npm run build
+```
+
+O gate completo do repositório roda a partir da raiz:
+
+```bash
+python3 scripts/quality_check.py
+```
+
+## Funcionalidades
+
+- Duas abas: **Tarefas** (a todolist, com escrita) e **Explorar** (read-only).
+- **Explorar** lista os databases visíveis à integração e mostra qualquer um
+  numa tabela genérica que se adapta ao schema — não só a todolist. Usa
+  `GET /api/databases` e `GET /api/databases/{id}`. Só leitura por enquanto.
+- Visualizações em grade, lista e kanban.
+- Indicação explícita da **database ativa** e da **data source** do Notion, com link
+  para abrir a tabela atual e conferir se a interface está apontando para a fonte certa.
+- Busca, filtros persistentes por etapa/esforço/área e ordenação. Os valores
+  de etapa/esforço/área vêm do Notion e são enviados de volta sem tradução
+  local.
+- **Clicar numa tarefa abre a página dela no Notion** (a nota, em nova aba), usando
+  a `url` do contrato. A edição fica no **botão de lápis** de cada tarefa.
+- Modal de criação/edição usando `POST /api/tarefas`, `PATCH /api/tarefas/{id}` e
+  `GET /api/opcoes`.
+- Estados de carregamento, vazio e erro com feedback acessível.

notion_workspace_app-0.3.0/pyproject.toml

@@ -0,0 +1,70 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "notion-workspace-app"
+version = "0.3.0"
+description = "Aplicação local para operar o Notion: API Django, SPA React, servidor MCP e launcher TUI (start_app.py)."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { file = "LICENSE" }
+authors = [{ name = "Felipe Alcantara" }]
+dependencies = [
+    "notion-starter>=0.3.0,<0.4.0",
+    "Django>=5.0",
+    "requests>=2.25",
+    "questionary>=2.0",
+    "rich>=13.0",
+    "mcp>=1.28,<2",
+]
+
+[project.optional-dependencies]
+server = [
+    "Django>=5.0",
+]
+mcp = [
+    "mcp>=1.28,<2",
+]
+dev = [
+    "pytest>=7.0",
+    "responses>=0.23",
+    "ruff>=0.4",
+]
+
+[project.scripts]
+notion-automacoes-app = "start_app:main"
+notion-automacoes-mcp = "server.mcp_server:main"
+
+[project.urls]
+Homepage = "https://github.com/Felipe-Alcantara/notion-workspace-app"
+Repository = "https://github.com/Felipe-Alcantara/notion-workspace-app"
+
+[tool.hatch.build.targets.wheel]
+packages = ["server"]
+include = ["start_app.py"]
+artifacts = ["server/static/frontend/**"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"start_app.py" = "start_app.py"
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "server",
+    "start_app.py",
+    "README.md",
+    "LICENSE",
+    "pyproject.toml",
+]
+artifacts = ["server/static/frontend/**"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+extend-exclude = ["server/**/migrations/*.py"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

notion_workspace_app-0.3.0/server/__init__.py

@@ -0,0 +1 @@
+"""Pacote empacotável do servidor Django e MCP."""

notion_workspace_app-0.3.0/server/api/apps.py

@@ -0,0 +1,10 @@
+"""Registro do app ``api`` (borda HTTP do servidor)."""
+
+from __future__ import annotations
+
+from django.apps import AppConfig
+
+
+class ApiConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "api"

notion_workspace_app-0.3.0/server/api/serializers.py

@@ -0,0 +1,26 @@
+"""Serialização da borda HTTP: objetos de domínio → dicts prontos para JSON.
+
+Mantém as views finas e o contrato de saída num lugar só. Não expõe o JSON cru
+do Notion (o campo ``bruto`` da :class:`Tarefa` fica fora da resposta pública).
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from notion_starter import Tarefa
+
+
+def tarefa_para_dict(tarefa: Tarefa) -> dict[str, Any]:
+    """Converte uma :class:`Tarefa` no objeto JSON público da API (sem ``bruto``)."""
+
+    return {
+        "id": tarefa.id,
+        "nome": tarefa.nome,
+        "status": tarefa.status,
+        "prazo": tarefa.prazo,
+        "duracao": tarefa.duracao,
+        "areas": tarefa.areas,
+        "areas_nomes": tarefa.areas_nomes,
+        "url": tarefa.url,
+    }