cndb 0.1.6__tar.gz

cndb-0.1.6/.bumpversion.toml

@@ -0,0 +1,18 @@
+[tool.bumpversion]
+current_version = "0.1.6"
+commit = true
+exclude = ["template/*"]
+message = "chore: 更新版本 {current_version} → {new_version}"
+tag = true
+tag_name = "v{new_version}"
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+regex = true
+search = '(version\s+=\s+)"{current_version}"'
+replace = '\1"{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "src/cndb/__init__.py"
+search = '__version__ = "{current_version}"'
+replace = '__version__ = "{new_version}"'

cndb-0.1.6/.copier-answers.yml

@@ -0,0 +1,19 @@
+# Changes here will be overwritten by Copier
+_commit: v1.0.4
+_src_path: https://gitee.com/gooker_young/coopie.git
+author_email: gooker_young@qq.com
+author_name: gookeryoung
+coverage_fail_under: 95
+description: Template for python web apps.
+license: MIT
+max_python_version: '3.14'
+min_python_version: '3.13'
+package_name: cndb
+project_name: cndb
+project_type: web
+use_cicd: true
+use_docker: true
+use_docs: true
+use_domestic_mirrors: true
+use_tox: true
+

cndb-0.1.6/.coveragerc

@@ -0,0 +1,14 @@
+[run]
+branch = true
+concurrency = thread
+omit = tests/*,src/cndb/seed.py,src/cndb/backup.py,src/cndb/restore.py,src/cndb/plugins/tables/routers/files.py
+source = cndb
+
+[report]
+fail_under = 95
+exclude_lines =
+    if TYPE_CHECKING:
+    if __name__ == .__main__.:
+    pragma: no cover
+    raise NotImplementedError
+show_missing = true

cndb-0.1.6/.dockerignore

@@ -0,0 +1,46 @@
+# 版本控制
+.git
+.gitignore
+.github
+
+# Python 缓存与构建产物
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+*.egg-info
+*.egg
+dist/*.tar.gz   # 仅排除 sdist，保留 dist/*.whl 供 wheel 部署镜像使用
+build
+.eggs
+
+# 测试与覆盖率
+.pytest_cache
+.coverage
+htmlcov
+.tox
+coverage.xml
+
+# 虚拟环境
+.venv
+venv
+env
+
+# 工具缓存
+.uv-cache
+.ruff_cache
+.pyrefly_cache
+.mypy_cache
+
+# IDE 与编辑器
+.idea
+.vscode
+*.swp
+*.swo
+
+# 文档（按需保留）
+docs
+
+# 系统文件
+.DS_Store
+Thumbs.db

cndb-0.1.6/.gitattributes

@@ -0,0 +1,30 @@
+# Git 行尾规范化
+# 默认所有文本文件使用 LF 行尾（跨平台一致）
+* text=auto eol=lf
+
+# Windows 脚本使用 CRLF
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+
+# 二进制文件（不做行尾转换）
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.icns binary
+*.pdf binary
+*.zip binary
+*.gz binary
+*.tar binary
+*.tgz binary
+*.whl binary
+*.egg binary
+*.pyc binary
+*.pyo binary
+*.so binary
+*.dll binary
+*.dylib binary
+*.qrc binary
+*.qss binary

cndb-0.1.6/.github/workflows/ci.yml

@@ -0,0 +1,96 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint & Typecheck
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Sync dependencies
+        run: uv sync --frozen --extra lint
+
+      - name: Check .gitkeep sentinels
+        run: uv run python scripts/check_gitkeep.py
+
+      - name: Ruff check
+        run: uv run ruff check src tests
+
+      - name: Ruff format check
+        run: uv run ruff format --check src tests
+
+      - name: Pyrefly check
+        run: uv run pyrefly check
+
+  frontend-check:
+    name: Frontend Check
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "pnpm"
+          cache-dependency-path: frontend/pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: cd frontend && pnpm install --frozen-lockfile
+
+      - name: Typecheck
+        run: cd frontend && pnpm typecheck
+
+      - name: ESLint
+        run: cd frontend && pnpm lint
+
+  test:
+    name: Test (Python 3.13 & 3.14)
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+      
+      
+
+      - name: Sync dependencies
+        run: uv sync --frozen --extra test --python ${{ matrix.python-version }}
+
+      - name: Run tests
+        run: uv run pytest -m "not slow" --cov=cndb --cov-fail-under=95 --cov-report=term-missing -n auto

cndb-0.1.6/.github/workflows/release.yml

@@ -0,0 +1,65 @@
+name: Release
+
+on:
+  push:
+    tags: ['v*.*.*']
+
+permissions:
+  contents: write
+  id-token: write
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: Build & Publish
+    runs-on: ubuntu-latest
+    environment: pypi
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+          cache-dependency-path: frontend/pnpm-lock.yaml
+
+      - name: Build frontend
+        run: |
+          cd frontend
+          pnpm install --frozen-lockfile
+          pnpm build
+
+      - name: Check .gitkeep sentinels
+        run: python scripts/check_gitkeep.py
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Publish to PyPI (OIDC)
+        run: uv publish
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG_NAME: ${{ github.ref_name }}
+        run: |
+          gh release create "$TAG_NAME" \
+            --title "Release $TAG_NAME" \
+            --generate-notes \
+            dist/*

cndb-0.1.6/.gitignore

@@ -0,0 +1,54 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# 测试与覆盖率
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+.tox/
+
+# 工具缓存
+.ruff_cache/
+.pyrefly_cache/
+.mypy_cache/
+.uv-cache/
+
+# IDE
+.idea/
+*_profile.html
+
+# 环境变量与凭证（勿提交）
+.env
+.env.*
+
+# Sphinx 文档构建输出
+docs/_build/
+.trae/
+!.trae/ideas/*
+*.py.bak
+src/cndb/static/*
+!src/cndb/static/.gitkeep
+
+*.db
+
+# Playwright E2E
+frontend/.auth/
+frontend/playwright-report/
+frontend/test-results/
+
+# 前端冗余 lock 文件（已用 pnpm，不再用 npm）
+frontend/package-lock.json
+*.bak
+uploads
+.trae-html-share-packages/*
+backup-*.tar.gz
+.pnpm-store

cndb-0.1.6/.pre-commit-config.yaml

@@ -0,0 +1,32 @@
+# prek / pre-commit 配置
+# See https://pre-commit.com for more information
+repos:
+  # 本地钩子：保护关键 .gitkeep 文件（缺失会导致 hatchling force-include /
+  # Sphinx html_static_path 在 CI 上直接 FileNotFoundError）
+  - repo: local
+    hooks:
+      - id: gitkeep-check
+        name: 校验关键 .gitkeep 文件
+        entry: python scripts/check_gitkeep.py
+        language: python
+        pass_filenames: false
+        always_run: true
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    # Ruff 版本 - 与 pyproject.toml 保持同步
+    rev: v0.15.21
+    hooks:
+      # 运行 linter
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      # 运行格式化
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-merge-conflict
+      - id: debug-statements
+      - id: fix-byte-order-marker
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+      - id: end-of-file-fixer

cndb-0.1.6/.python-version

@@ -0,0 +1 @@
+3.12

cndb-0.1.6/.readthedocs.yaml

@@ -0,0 +1,23 @@
+# ReadTheDocs 配置
+# https://docs.readthedocs.io/en/stable/config-file/v2.html
+version: 2
+
+# 构建配置
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.13"
+
+# Python 依赖与构建命令
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs
+
+# Sphinx 构建
+sphinx:
+  configuration: docs/conf.py
+  builder: html
+  fail_on_warning: false

cndb-0.1.6/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [0.1.2] — 2026-09-11
+
+### 新增
+
+- **Playwright E2E 测试**：smoke（登录 → Grid → 退出）+ critical（行 CRUD 全链路），配置见 `frontend/playwright.config.ts`
+- **生产部署定型**：多阶段 `deploy/Dockerfile`（前端构建 + uvicorn）+ `deploy/nginx.conf` 反代 + `docker-compose.yml` 生产编排（SQLite/PostgreSQL 双形态）
+- **示例数据集**：`examples/datasets/` 5 个 CSV（学生成绩 / 电商销售 / 房价预测 / 客户流失 / 气温天气）
+- **`.env.example`**：部署环境变量模板
+
+### 变更
+
+- docker-compose.yml 从开发形态更新为生产形态（nginx 入口 + app 容器 + pg profile）
+- `.gitignore` 添加 Playwright 产物目录
+
+## [0.1.1] — 2026-09-11
+
+### 新增
+
+- 前端完成 F1–F9：登录注册 / 工作区 / Grid inline 编辑 / 视图 Tab / 导入导出 / 成员管理 / 主题切换 / 关系图 / 报表 / 公开分享页
+- SPA fallback：`app.py` 中间件自动处理前端路由回退
+- 前端构建产物挂载到 `src/cndb/static/`，uvicorn 统一提供
+
+### 变更
+
+- RowResponse 类型对齐后端扁平结构（移除嵌套 values 字段）
+
+## [0.1.0] — 2026-09-10
+
+### 新增
+
+- 后端 P0–P4 完成：框架基础 + 6 插件 + 95%+ 测试覆盖率
+- 插件架构：accounts / workspaces / tables / reports / health
+- 动态数据表：SQLAlchemy Core 运行时 DDL
+- link 字段多对多存储与查询
+- 审计日志 + 回收站闭环
+- 字段类型补齐至 11 种

cndb-0.1.6/Dockerfile

@@ -0,0 +1,50 @@
+# CI/容器化用 Dockerfile
+# 使用国内镜像源拉取基础镜像（如不需要可替换为官方镜像）
+# 备选镜像源前缀：docker.1ms.run / dockerpull.com / docker.xuanyuan.me
+FROM docker.m.daocloud.io/python:3.14-slim
+
+# ---- 国内镜像源 ----
+ENV PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
+ENV PIP_TRUSTED_HOST=pypi.tuna.tsinghua.edu.cn
+ENV UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
+ENV UV_TRUSTED_HOST=pypi.tuna.tsinghua.edu.cn
+
+# 环境变量：非交互 + 路径配置
+ENV DEBIAN_FRONTEND=noninteractive \
+    LANG=C.UTF-8 \
+    LC_ALL=C.UTF-8 \
+    UV_LINK_MODE=copy \
+    UV_CACHE_DIR=/uv-cache \
+    UV_PROJECT_ENVIRONMENT=/opt/venv \
+    PATH="/opt/venv/bin:${PATH}"
+
+# 配置 apt 国内镜像（阿里云）并安装系统依赖
+RUN sed -i 's|deb.debian.org|mirrors.aliyun.com|g' /etc/apt/sources.list.d/debian.sources \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends \
+        ca-certificates \
+        curl \
+        git \
+        build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+
+# 安装 uv（国内镜像）
+RUN pip install --no-cache-dir uv -i https://mirrors.aliyun.com/pypi/simple/
+
+# 预装项目所需 Python 版本
+RUN uv python install 3.13 3.14
+
+# 预装项目 dev 依赖（仅复制依赖描述文件，利用 Docker 层缓存）
+WORKDIR /workspace
+COPY pyproject.toml tox.ini README.md ./
+COPY src/ ./src/
+
+# 同步依赖到 /opt/venv（CI 时直接复用）
+RUN uv sync --frozen --no-install-project 2>/dev/null || uv sync --no-install-project
+
+# 持久化 uv 缓存目录（CI 可挂载到宿主机加速）
+VOLUME ["/uv-cache"]
+
+# 默认入口
+CMD ["/bin/bash"]

cndb-0.1.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gookeryoung
+
+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.

cndb-0.1.6/Makefile

@@ -0,0 +1,90 @@
+# Makefile - cndb 项目快捷命令
+# 运行 `make help` 查看所有可用命令
+
+PACKAGE := cndb
+COV_THRESHOLD := 95
+PYTEST_JOBS := 8  # pytest-xdist 并行进程数；Windows 默认 8 避免句柄耗尽
+
+# push / bump 默认依赖 check，可用 SKIP_CHECK=1 临时跳过（仅限紧急修复，发布场景禁止使用）
+CHECK_DEPS := $(if $(SKIP_CHECK),,check)
+
+.PHONY: help sync frontend-build frontend-sync frontend-lint frontend-typecheck frontend-check build b clean c test cov lint typecheck check-fast check doc tox pub bump patch minor major push e2e
+
+help: ## 显示帮助信息
+	@uv run python -c "import sys; sys.stdout.reconfigure(encoding='utf-8', errors='replace'); import re;ms=[(m.group(1),m.group(2).strip()) for f in sys.argv[1:] for l in open(f,encoding='utf-8') if (m:=re.match(r'^([a-zA-Z][\w -]*):.*?##\s*(.*)',l))];[print(f'  {n:<14} {d}') for n,d in ms]" $(MAKEFILE_LIST)
+
+sync: ## 安装开发依赖
+	uv sync --extra dev
+
+frontend-sync: ## 安装前端依赖（pnpm install，惰性：node_modules 已存在则跳过）
+	@uv run python -c "import sys; sys.stdout.reconfigure(encoding='utf-8', errors='replace'); import os,subprocess;\
+print('[frontend] node_modules 已存在，跳过 install') if os.path.isdir('frontend/node_modules') else (\
+print('[frontend] node_modules 不存在，开始 pnpm install...'),\
+subprocess.run(['pnpm','install','--frozen-lockfile'],cwd='frontend',check=True))"
+
+frontend-lint: frontend-sync ## 前端 ESLint 检查
+	cd frontend && pnpm lint
+
+frontend-typecheck: frontend-sync ## 前端 TypeScript 类型检查
+	cd frontend && pnpm typecheck
+
+frontend-check: frontend-typecheck frontend-lint ## 前端门禁（typecheck + lint）
+
+frontend-build: frontend-sync ## 构建前端（Vite，产物输出到 src/cndb/static/）
+	cd frontend && pnpm build
+
+build b: frontend-build ## 构建分发包 (前端 → wheel + sdist)
+	uv build
+
+clean c: ## 清理构建产物与缓存
+	@uv run python -c "import sys; sys.stdout.reconfigure(encoding='utf-8', errors='replace'); import shutil,pathlib,glob;\
+pts=['build','dist','wheels','*.egg-info','htmlcov','.coverage','.coverage.*','coverage.xml','docs/_build','.tox','.ruff_cache','.pyrefly_cache','.mypy_cache'];\
+[shutil.rmtree(m,ignore_errors=True) if pathlib.Path(m).is_dir() else pathlib.Path(m).unlink(missing_ok=True) for p in pts for m in glob.glob(p)];\
+[shutil.rmtree(d,ignore_errors=True) for base in ('src','tests') for d in pathlib.Path(base).rglob('__pycache__')];\
+[f.unlink(missing_ok=True) for base in ('src','tests') for f in pathlib.Path(base).rglob('*') if f.suffix in ('.pyc','.pyo')]"
+
+test: ## 运行测试（不含覆盖率）
+	uv run pytest -m "not slow" -n $(PYTEST_JOBS)
+
+cov: ## 运行测试并生成 HTML 覆盖率报告
+	uv run pytest --cov --cov-report=term --cov-fail-under=$(COV_THRESHOLD) --cov-report=html -n $(PYTEST_JOBS)
+	@uv run python -c "import sys; sys.stdout.reconfigure(encoding='utf-8', errors='replace'); print('Coverage report: htmlcov/index.html')"
+
+e2e: frontend-sync ## 前端 E2E 测试（Playwright；需后端已启动）
+	cd frontend && pnpm e2e
+
+gitkeep-check: ## 校验关键 .gitkeep 文件（缺失会导致 CI/打包失败）
+	uv run python scripts/check_gitkeep.py
+
+lint: ## 代码风格检查 (ruff, 与 CI 对齐仅扫 src + tests)
+	uv run ruff check src tests
+	uv run ruff format --check src tests
+
+typecheck: ## 类型检查 (pyrefly)
+	uv run pyrefly check
+
+check-fast: gitkeep-check lint typecheck frontend-check ## 轻量门禁（不含覆盖率，适合日常快速验证）
+
+check: check-fast cov ## 运行全套门禁 (gitkeep + lint + typecheck + frontend-check + cov)
+
+doc: ## 构建 Sphinx 文档
+	uv run sphinx-build -b html docs docs/_build/html
+
+
+tox: ## 多版本测试 (tox)
+	uvx tox -p auto
+
+BUMP_PART := $(filter-out bump,$(MAKECMDGOALS))
+
+bump: $(CHECK_DEPS) ## 版本号 bump (默认 patch，用法: make bump [minor|major])
+	@uvx bump-my-version bump $(if $(BUMP_PART),$(firstword $(BUMP_PART)),patch) --tag
+
+patch minor major:
+	@:
+
+pub:  ## 推送到pypi
+	uvx twine upload ./dist/**
+
+push: $(CHECK_DEPS) ## 推送代码到所有远程仓库
+	@uv run python -c "import sys; sys.stdout.reconfigure(encoding='utf-8', errors='replace'); import subprocess as sp; [print(f'\u63a8\u9001 {r}...',flush=True) or (sp.run(['git','push',r],check=True) and sp.run(['git','push',r,'--tags'],check=True)) for r in sp.check_output(['git','remote'],text=True).split()]"
+