bias-core 0.1.0__tar.gz

bias_core-0.1.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: bias-core
+Version: 0.1.0
+Summary: Bias forum backend core platform
+Requires-Python: >=3.11
+Requires-Dist: Django<5.1,>=5.0
+Requires-Dist: django-ninja<1.3,>=1.2
+Requires-Dist: django-ninja-jwt<5.4,>=5.3
+Requires-Dist: django-ninja-extra<0.22,>=0.21
+Requires-Dist: channels<4.1,>=4.0
+Requires-Dist: channels-redis<4.3,>=4.2
+Requires-Dist: celery<5.4,>=5.3
+Requires-Dist: redis<5.1,>=5.0
+Requires-Dist: django-redis<5.5,>=5.4
+Requires-Dist: pydantic<2.7,>=2.6
+Requires-Dist: markdown<3.6,>=3.5
+Requires-Dist: bleach<6.2,>=6.1
+Requires-Dist: pymdown-extensions<10.8,>=10.7
+Requires-Dist: python-dateutil<3,>=2.9
+Requires-Dist: django-cors-headers<4.4,>=4.3
+Requires-Dist: django-extensions<3.3,>=3.2
+Requires-Dist: python-dotenv<1.1,>=1.0
+Requires-Dist: jieba<0.43,>=0.42
+Requires-Dist: httpx<0.28,>=0.27
+Requires-Dist: Pillow<11,>=10.2
+Provides-Extra: postgres
+Requires-Dist: psycopg2-binary<3,>=2.9; extra == "postgres"
+Provides-Extra: storage
+Requires-Dist: boto3<2,>=1.34; extra == "storage"
+Requires-Dist: oss2<3,>=2.18; extra == "storage"
+Provides-Extra: dev
+Requires-Dist: pytest<8.2,>=8.1; extra == "dev"
+Requires-Dist: pytest-django<4.9,>=4.8; extra == "dev"
+Requires-Dist: pytest-cov<4.2,>=4.1; extra == "dev"
+Requires-Dist: import-linter<3,>=2.11; extra == "dev"
+Requires-Dist: factory-boy<3.4,>=3.3; extra == "dev"
+Requires-Dist: daphne<4.2,>=4.1; extra == "dev"
+Requires-Dist: gunicorn<23,>=22.0; extra == "dev"
+Requires-Dist: uvicorn<0.31,>=0.30; extra == "dev"

bias_core-0.1.0/README.md

@@ -0,0 +1,69 @@
+# Bias Core
+
+Bias forum 后端核心平台包。
+
+`bias-core` 是独立于网站工程的 Python 包，提供 Django app、数据模型、扩展宿主、资源 API 运行时和平台服务。
+
+## 安装
+
+```bash
+pip install bias-core
+```
+
+## 开发
+
+```bash
+# 克隆后安装
+pip install -e ".[dev]"
+
+# 运行测试
+pytest
+
+# 构建
+python -m build
+```
+
+## 架构
+
+```
+bias_core
+├─ conf/           # 配置引导和扩展发现
+├─ extensions/     # 扩展宿主 + 公共 SDK（第三方扩展唯一依赖）
+├─ resources/      # 资源注册表和 JSON:API 运行时
+├─ services/       # 平台服务
+├─ api/            # API 应用构建器
+├─ realtime/       # WebSocket/实时通信支撑
+└─ management/     # 管理命令（doctor、sync_extensions 等）
+```
+
+## 扩展开发
+
+```python
+from bias_core.extensions import SettingsExtender, setting_field
+
+def extend():
+    return [
+        SettingsExtender(
+            fields=[
+                setting_field(
+                    key="my_ext.enabled",
+                    type="boolean",
+                    label="Enable feature",
+                    default=True,
+                )
+            ]
+        )
+    ]
+```
+
+## 依赖
+
+- Python >= 3.11
+- Django >= 5.0
+- django-ninja >= 1.2
+- Channels >= 4.0
+- Celery >= 5.3
+
+## 许可
+
+MIT

bias_core-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "bias-core"
+version = "0.1.0"
+description = "Bias forum backend core platform"
+requires-python = ">=3.11"
+
+dependencies = [
+  "Django>=5.0,<5.1",
+  "django-ninja>=1.2,<1.3",
+  "django-ninja-jwt>=5.3,<5.4",
+  "django-ninja-extra>=0.21,<0.22",
+  "channels>=4.0,<4.1",
+  "channels-redis>=4.2,<4.3",
+  "celery>=5.3,<5.4",
+  "redis>=5.0,<5.1",
+  "django-redis>=5.4,<5.5",
+  "pydantic>=2.6,<2.7",
+  "markdown>=3.5,<3.6",
+  "bleach>=6.1,<6.2",
+  "pymdown-extensions>=10.7,<10.8",
+  "python-dateutil>=2.9,<3",
+  "django-cors-headers>=4.3,<4.4",
+  "django-extensions>=3.2,<3.3",
+  "python-dotenv>=1.0,<1.1",
+  "jieba>=0.42,<0.43",
+  "httpx>=0.27,<0.28",
+  "Pillow>=10.2,<11",
+]
+
+[project.optional-dependencies]
+postgres = ["psycopg2-binary>=2.9,<3"]
+storage = ["boto3>=1.34,<2", "oss2>=2.18,<3"]
+dev = [
+  "pytest>=8.1,<8.2",
+  "pytest-django>=4.8,<4.9",
+  "pytest-cov>=4.1,<4.2",
+  "import-linter>=2.11,<3",
+  "factory-boy>=3.3,<3.4",
+  "daphne>=4.1,<4.2",
+  "gunicorn>=22.0,<23",
+  "uvicorn>=0.30,<0.31",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+DJANGO_SETTINGS_MODULE = "tests.settings"
+python_files = "tests.py test_*.py *_tests.py"
+testpaths = ["tests"]
+addopts = "--tb=short -v"
+filterwarnings = [
+  "ignore::DeprecationWarning:pydantic",
+  "ignore::UserWarning:django.test.utils",
+]

bias_core-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

bias_core-0.1.0/src/bias_core/__init__.py

@@ -0,0 +1,6 @@
+from bias_core.version import APP_VERSION
+
+default_app_config = "bias_core.apps.CoreConfig"
+
+__version__ = APP_VERSION
+__all__ = ["__version__", "default_app_config"]

bias_core-0.1.0/src/bias_core/admin.py

@@ -0,0 +1,28 @@
+from django.contrib import admin
+
+from bias_core.models import AuditLog, Setting
+
+
+@admin.register(Setting)
+class SettingAdmin(admin.ModelAdmin):
+    list_display = ["key", "updated_at"]
+    search_fields = ["key", "value"]
+    readonly_fields = ["created_at", "updated_at"]
+
+
+@admin.register(AuditLog)
+class AuditLogAdmin(admin.ModelAdmin):
+    list_display = ["created_at", "user", "action", "target_type", "target_id", "ip_address"]
+    list_filter = ["action", "target_type", "created_at"]
+    search_fields = ["action", "target_type", "target_id", "user__username"]
+    readonly_fields = [
+        "user",
+        "action",
+        "target_type",
+        "target_id",
+        "ip_address",
+        "user_agent",
+        "data",
+        "created_at",
+    ]
+

bias_core-0.1.0/src/bias_core/admin_api.py

@@ -0,0 +1,18 @@
+"""管理后台 API 路由聚合。"""
+from ninja import Router
+
+from bias_core.admin_audit_api import router as audit_router
+from bias_core.admin_content_api import router as content_router
+from bias_core.admin_extension_recovery_api import router as extension_recovery_router
+from bias_core.admin_settings_api import router as settings_router
+from bias_core.admin_stats_api import router as stats_router
+
+
+router = Router()
+router.add_router("", audit_router)
+router.add_router("", content_router)
+router.add_router("", extension_recovery_router)
+router.add_router("", settings_router)
+router.add_router("", stats_router)
+
+

bias_core-0.1.0/src/bias_core/admin_audit_api.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+from ninja import Router
+
+from bias_core.admin_audit_serialization import serialize_audit_log
+from bias_core.admin_auth import require_staff
+from bias_core.jwt_auth import AccessTokenAuth
+from bias_core.models import AuditLog
+from bias_core.services import PaginationService
+
+
+router = Router()
+
+
+@router.get("/audit-logs", auth=AccessTokenAuth(), tags=["Admin"])
+def list_audit_logs(
+    request,
+    page: int = 1,
+    limit: int = 20,
+    action: str = "",
+    target_type: str = "",
+    user_id: int = None,
+):
+    denied = require_staff(request)
+    if denied:
+        return denied
+
+    page, limit = PaginationService.normalize(page, limit)
+    queryset = (
+        AuditLog.objects.select_related("user")
+        .filter(action__startswith="admin.")
+        .order_by("-created_at", "-id")
+    )
+
+    if action:
+        queryset = queryset.filter(action=action)
+    if target_type:
+        queryset = queryset.filter(target_type=target_type)
+    if user_id:
+        queryset = queryset.filter(user_id=user_id)
+
+    total = queryset.count()
+    offset = (page - 1) * limit
+    logs = queryset[offset:offset + limit]
+
+    return {
+        "total": total,
+        "page": page,
+        "limit": limit,
+        "data": [serialize_audit_log(log) for log in logs],
+    }
+
+

bias_core-0.1.0/src/bias_core/admin_audit_serialization.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+from bias_core.models import AuditLog
+
+
+def serialize_audit_log(log: AuditLog) -> dict:
+    return {
+        "id": log.id,
+        "action": log.action,
+        "target_type": log.target_type,
+        "target_id": log.target_id,
+        "ip_address": log.ip_address,
+        "user_agent": log.user_agent,
+        "data": log.data,
+        "created_at": log.created_at,
+        "user": {
+            "id": log.user.id,
+            "username": log.user.username,
+            "display_name": log.user.username,
+        } if log.user else None,
+    }
+

bias_core-0.1.0/src/bias_core/admin_auth.py

@@ -0,0 +1,7 @@
+from bias_core.api_errors import api_error
+
+
+def require_staff(request):
+    if not getattr(request, "auth", None) or not request.auth.is_staff:
+        return api_error("需要管理员权限", status=403)
+    return None

bias_core-0.1.0/src/bias_core/admin_content_api.py

@@ -0,0 +1,270 @@
+import logging
+
+from ninja import Body, Router
+
+from bias_core.api_errors import api_error
+from bias_core.admin_auth import require_staff
+from bias_core.extensions.exceptions import ExtensionNotFoundError, ExtensionStateError
+from bias_core.extensions.registry import get_extension_registry
+from bias_core.extension_service import ExtensionService
+from bias_core.extension_settings_service import get_extension_settings, serialize_extension_settings_schema, save_extension_settings
+from bias_core.extensions.frontend_compiler import inspect_extension_frontend_output_manifest
+from bias_core.audit import log_admin_action
+from bias_core.jwt_auth import AccessTokenAuth
+from bias_core.admin_extension_detail import (
+    _serialize_admin_extension,
+    _serialize_admin_extension_action_payload,
+    _serialize_admin_extensions_payload,
+    serialize_admin_extension,
+    serialize_admin_extensions_payload,
+)
+
+
+router = Router()
+logger = logging.getLogger(__name__)
+
+
+_require_staff = require_staff
+
+
+@router.get("/extensions", auth=AccessTokenAuth(), tags=["Admin"])
+def list_admin_extensions(request):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    summary = str(request.GET.get("summary") or "").strip().lower() in {"1", "true", "yes", "on"}
+    return _serialize_admin_extensions_payload(get_extension_registry().get_extensions(), summary=summary)
+
+
+@router.post("/extensions/sync", auth=AccessTokenAuth(), tags=["Admin"])
+def sync_admin_extensions(request, payload: dict = Body(default={})):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    prune_missing = bool(dict(payload or {}).get("prune_missing", True))
+    ExtensionService.sync_extension_packages(
+        prune_missing=prune_missing,
+        actor=request.auth,
+        request=request,
+    )
+    return _serialize_admin_extensions_payload(get_extension_registry().get_extensions())
+
+
+@router.post("/extensions/sync-order", auth=AccessTokenAuth(), tags=["Admin"])
+def sync_admin_extension_order(request):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    try:
+        ExtensionService.sync_enabled_extension_order(
+            actor=request.auth,
+            request=request,
+        )
+    except ExtensionStateError as exc:
+        return api_error(str(exc), status=409, code=exc.code, field_errors=exc.details)
+    return _serialize_admin_extensions_payload(get_extension_registry().get_extensions())
+
+
+@router.post("/extensions/rebuild-frontend", auth=AccessTokenAuth(), tags=["Admin"])
+def rebuild_admin_extension_frontend(request, payload: dict = Body(default={})):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    options = dict(payload or {})
+    result = ExtensionService.rebuild_extension_frontend_assets(
+        run_build=bool(options.get("run_build", True)),
+        include_disabled=bool(options.get("include_disabled", False)),
+        publish=bool(options.get("publish", False)),
+        actor=request.auth,
+        request=request,
+    )
+    status = str(result.get("status") or "")
+    if status and status != "ok":
+        return api_error(
+            str(result.get("message") or "扩展前端资产重建失败"),
+            status=409,
+            code="extension_frontend_rebuild_failed",
+            field_errors=result,
+        )
+    return {
+        **_serialize_admin_extensions_payload(get_extension_registry().get_extensions()),
+        "frontend_rebuild": result,
+    }
+
+
+@router.get("/extensions/{extension_id}", auth=AccessTokenAuth(), tags=["Admin"])
+def get_admin_extension(request, extension_id: str):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    try:
+        extension = get_extension_registry().get_extension(extension_id)
+    except ExtensionNotFoundError:
+        return api_error("扩展不存在", status=404, code="extension_not_found")
+    frontend_output_manifest = inspect_extension_frontend_output_manifest()
+    return {
+        "extension": _serialize_admin_extension(
+            extension,
+            include_permission_details=True,
+            frontend_output_manifest=frontend_output_manifest,
+        ),
+    }
+
+
+@router.get("/extensions/{extension_id}/settings", auth=AccessTokenAuth(), tags=["Admin"])
+def get_admin_extension_settings(request, extension_id: str):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    try:
+        extension = get_extension_registry().get_extension(extension_id)
+        return {
+            "extension_id": extension.id,
+            "schema": serialize_extension_settings_schema(extension.id),
+            "settings": get_extension_settings(extension.id),
+        }
+    except ExtensionNotFoundError:
+        return api_error("扩展不存在", status=404, code="extension_not_found")
+
+
+@router.post("/extensions/{extension_id}/settings", auth=AccessTokenAuth(), tags=["Admin"])
+def save_admin_extension_settings(request, extension_id: str, payload: dict = Body(...)):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    try:
+        extension = get_extension_registry().get_extension(extension_id)
+        settings_data = save_extension_settings(extension.id, payload)
+        log_admin_action(
+            request,
+            "admin.extension.settings.update",
+            target_type="extension",
+            data={
+                "extension_id": extension.id,
+                "keys": sorted(payload.keys()),
+            },
+        )
+        return {
+            "message": "扩展设置保存成功",
+            "extension_id": extension.id,
+            "settings": settings_data,
+        }
+    except ExtensionNotFoundError:
+        return api_error("扩展不存在", status=404, code="extension_not_found")
+    except ExtensionStateError as exc:
+        return api_error(str(exc), status=409, code=exc.code, field_errors=exc.details)
+
+
+@router.post("/extensions/{extension_id}/enable", auth=AccessTokenAuth(), tags=["Admin"])
+def enable_admin_extension(request, extension_id: str):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    try:
+        extension = ExtensionService.set_extension_enabled(
+            extension_id,
+            True,
+            actor=request.auth,
+            request=request,
+        )
+    except ExtensionStateError as exc:
+        return api_error(str(exc), status=409, code=exc.code, field_errors=exc.details)
+    return _serialize_admin_extension_action_payload(extension)
+
+
+@router.post("/extensions/{extension_id}/install", auth=AccessTokenAuth(), tags=["Admin"])
+def install_admin_extension(request, extension_id: str):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    try:
+        extension = ExtensionService.install_extension(
+            extension_id,
+            actor=request.auth,
+            request=request,
+        )
+    except ExtensionStateError as exc:
+        return api_error(str(exc), status=409, code=exc.code, field_errors=exc.details)
+    return _serialize_admin_extension_action_payload(extension)
+
+
+@router.post("/extensions/{extension_id}/runtime-hooks/{hook_name}", auth=AccessTokenAuth(), tags=["Admin"])
+def run_admin_extension_runtime_hook(request, extension_id: str, hook_name: str):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    try:
+        extension = ExtensionService.run_extension_runtime_hook(
+            extension_id,
+            hook_name,
+            actor=request.auth,
+            request=request,
+        )
+    except ExtensionStateError as exc:
+        return api_error(str(exc), status=409, code=exc.code, field_errors=exc.details)
+    return _serialize_admin_extension_action_payload(extension)
+
+
+@router.post("/extensions/{extension_id}/migrations", auth=AccessTokenAuth(), tags=["Admin"])
+def run_admin_extension_migrations(request, extension_id: str):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    try:
+        extension = ExtensionService.run_extension_migrations(
+            extension_id,
+            actor=request.auth,
+            request=request,
+        )
+    except ExtensionStateError as exc:
+        return api_error(str(exc), status=409, code=exc.code, field_errors=exc.details)
+    return _serialize_admin_extension_action_payload(extension)
+
+
+@router.post("/extensions/{extension_id}/disable", auth=AccessTokenAuth(), tags=["Admin"])
+def disable_admin_extension(request, extension_id: str):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    try:
+        extension = ExtensionService.set_extension_enabled(
+            extension_id,
+            False,
+            actor=request.auth,
+            request=request,
+        )
+    except ExtensionStateError as exc:
+        return api_error(str(exc), status=409, code=exc.code, field_errors=exc.details)
+    return _serialize_admin_extension_action_payload(extension)
+
+
+@router.post("/extensions/{extension_id}/uninstall", auth=AccessTokenAuth(), tags=["Admin"])
+def uninstall_admin_extension(request, extension_id: str):
+    denied = _require_staff(request)
+    if denied:
+        return denied
+
+    try:
+        extension = ExtensionService.uninstall_extension(
+            extension_id,
+            actor=request.auth,
+            request=request,
+        )
+    except ExtensionStateError as exc:
+        return api_error(str(exc), status=409, code=exc.code, field_errors=exc.details)
+    return _serialize_admin_extension_action_payload(extension)
+
+
+

bias_core-0.1.0/src/bias_core/admin_extension_detail.py

@@ -0,0 +1,112 @@
+"""
+Extension detail serialization.
+
+This file is a re-export shim migrated to apps/core/extension_detail/.
+Import from bias_core.extension_detail directly.
+"""
+from __future__ import annotations
+
+from bias_core.extension_detail.orchestrator import (
+    serialize_admin_extension,
+    serialize_admin_extensions_payload,
+)
+from bias_core.extension_detail.orchestrator import (  # noqa: F401
+    _serialize_admin_extension,
+    _serialize_admin_extension_summary,
+    _serialize_admin_extensions_payload,
+    _serialize_admin_extension_action_payload,
+    _build_default_extension_admin_actions,
+    _serialize_extension_admin_actions,
+    _resolve_extension_runtime_record,
+    _serialize_extension_recovery_status,
+    _resolve_api_stability_label,
+    _resolve_distribution_channel_label,
+    _build_extension_capability_summary,
+    _serialize_extension_backend_hooks,
+)
+
+from bias_core.extension_detail.models import (  # noqa: F401
+    _build_extension_model_definitions,
+    _build_extension_owned_models,
+    _build_extension_model_ownership_audit,
+    _build_extension_model_relations,
+    _build_extension_model_visibility,
+    _resolve_display_model,
+    _model_name,
+    _model_label,
+    _model_module,
+    _model_app_label,
+    _extension_app_label,
+    _extension_app_label_source,
+    _model_db_table,
+    _model_storage_origin,
+    _model_package_migration_required,
+    _model_app_label_migration_required,
+    _model_migration_risk,
+    _model_migration_recommended_steps,
+    _build_model_app_label_migration_item,
+    _serialize_extension_migration_execution,
+    _serialize_extension_migration_plan,
+)
+
+from bias_core.extension_detail.resources import (  # noqa: F401
+    _build_extension_resource_definitions,
+    _build_extension_resource_relationships,
+    _build_extension_resource_endpoints,
+    _build_extension_resource_sorts,
+    _build_extension_resource_filters,
+    _build_extension_resource_fields,
+    _build_extension_search_drivers,
+    _build_extension_search_filters,
+)
+
+from bias_core.extension_detail.forum_domain import (  # noqa: F401
+    _build_extension_discussion_list_filters,
+    _build_extension_discussion_sorts,
+    _build_extension_post_types,
+    _build_extension_post_lifecycle,
+    _build_extension_notification_types,
+    _build_extension_user_preferences,
+    _build_extension_event_listeners,
+    _build_extension_realtime_broadcasts,
+    _build_extension_language_packs,
+    _build_extension_delivery_assets,
+)
+
+from bias_core.extension_detail.permissions import (  # noqa: F401
+    _build_extension_permission_sections,
+    _build_extension_permission_summary,
+    _flatten_extension_permissions,
+    _build_extension_permission_modules,
+    _build_extension_admin_page_details,
+)
+
+from bias_core.extension_detail.frontend import (  # noqa: F401
+    _build_extension_frontend_routes,
+    _build_extension_frontend_document,
+    _resolve_extension_frontend_admin_entry,
+    _resolve_extension_frontend_forum_entry,
+    _resolve_extension_frontend_outputs,
+    _resolve_extension_settings_pages,
+    _resolve_extension_permissions_pages,
+    _resolve_extension_operations_pages,
+    _build_runtime_surface_view,
+    _serialize_extension_runtime_rebuild_state,
+    _serialize_extension_frontend_asset_state_for_extension,
+)
+
+from bias_core.extension_detail.settings_theme import (  # noqa: F401
+    _build_extension_settings_runtime,
+    _build_extension_theme_runtime,
+    _build_extension_system_hooks,
+)
+
+from bias_core.extension_detail.debug import (  # noqa: F401
+    _build_extension_debug_info,
+    _serialize_debug_value,
+)
+
+from bias_core.extension_detail._shared import (  # noqa: F401
+    _serialize_callable_or_value,
+)
+