Providentia Network
Python

Providentia Network

Providentia 网络:一个基于 Django 的后端,带有持久化数据库,同时运行 Discord 和 Telegram 机器人。与 Google 和大学学术系统等外部服务集成,用于高级推理和操作。

Providentia Network 是一个 Django + 前端项目,承载了“Providentia”推理/自动化系统。

该仓库包含一个 Django 后端(位于 providentia/manage.py 中)和一个使用 Vite + React 构建的前端(位于 src/package.json 中)。

快速开始

  1. 创建并激活 Python 虚拟环境:

    python -m venv .venv
    source .venv/bin/activate
    
  2. 安装 Python 依赖:

    pip install -r requirements.txt
    
  3. 安装前端依赖:

    npm install
    
  4. 运行 Django 开发服务器:

    python manage.py migrate
    python manage.py runserver
    
  5. (可选)运行前端开发服务器:

    npm run dev
    

仓库结构(概览)

  • providentia/ - Django 项目模块(设置、URL、WSGI/ASGI)
  • manage.py - Django 管理封装
  • outdated/ - 遗留脚本(已归档)。副本见 archive/
  • Data/Modules/Assets/ - 项目模块和静态资源
  • src/ - 前端源码(React + Vite)

注意事项

  • 部分遗留文件位于 outdated/ 下。副本已放置在 archive/ 中供参考。
  • 请勿将机密信息存入仓库。使用 .env 文件(已存在)并确保 .env.gitignore 中。

后续步骤

  • 添加项目特定的开发者文档(端点、环境变量)
  • 为核心模块添加测试及 CI 任务