wenlanai/README.md

SentAI 阶段1工程骨架

当前仓库已切换为面向服务端数据库的实现，不再使用 SQLite。

当前技术基线

• apps/web: Next.js 前端控制台
• apps/api: NestJS API + TypeORM
• packages/shared: 共享类型
• docs/phase1-implementation-plan.md: 阶段 1 落地方案

数据库支持

当前代码按两类数据库接入：

• MariaDB 10.4.34
• 人大金仓 V8R6

配置方式：

• DB_CLIENT=mariadb 时，TypeORM 使用 mariadb 驱动
• DB_CLIENT=kingbase 时，TypeORM 使用 postgres 兼容模式

已实现

• 演示登录接口 POST /api/auth/login
• 首页汇总接口 GET /api/dashboard/summary
• 巡检任务列表/创建接口 GET/POST /api/tasks
• 手动执行接口 POST /api/runs/execute/:taskId
• 执行记录列表接口 GET /api/runs
• 执行详情接口 GET /api/runs/:runId
• Playwright 真实巡检执行
• 截图证据与步骤日志
• 预置案例站点
  • http://www.huhhot.gov.cn/
  • http://www.tmtyq.gov.cn/

环境变量

MariaDB 示例

DB_CLIENT="mariadb"
DB_HOST="127.0.0.1"
DB_PORT="3306"
DB_USERNAME="sentai"
DB_PASSWORD="sentai123"
DB_DATABASE="sentai"
DB_SYNCHRONIZE="true"

人大金仓示例

DB_CLIENT="kingbase"
DB_HOST="127.0.0.1"
DB_PORT="54321"
DB_USERNAME="system"
DB_PASSWORD="123456"
DB_DATABASE="sentai"
DB_SYNCHRONIZE="true"

本地启动

1. 安装依赖

npm.cmd install

1. 初始化数据库结构

npm.cmd run db:init

1. 导入种子任务

npm.cmd run db:seed

1. 安装 Playwright 浏览器

npm.cmd run install:browsers

1. 启动后端

npm.cmd run dev:api

1. 启动前端

npm.cmd run dev:web

默认账号

• 用户名：admin
• 密码：admin123

当前边界

当前已完成：

• S1 基础骨架
• S2 任务与执行
• S3 异常证据基础版

尚未完成：

• 定时调度器
• 内网上下文补证据
• 安全推送
• AI 归因
• 日报页