Initialize backendized SurClaw report system

- Add React/Vite frontend for login, dashboard, reports, templates, users, settings, AI, speech, and media workflows.

- Add NestJS/Prisma/PostgreSQL backend with auth, dashboard stats, reports, templates, users, departments, settings, files, AI, speech, audit logs, and HTML sanitization.

- Add Prisma schema, migrations, seed data, persistent app sessions, Docker/Nginx deployment files, and upload volume configuration.

- Add Vitest, Playwright, backend integration tests, and project documentation for requirements, design, permissions, API contracts, testing, deployment, security, and progress.

- Configure production local fallback switch and remove unused Gemini direct dependency/env wiring.

docs/README.md

@@ -0,0 +1,34 @@
+# 项目文档入口
+
+本文档目录基于当前仓库源码整理，目标是帮助新接手者快速理解系统边界、核心流程和后续维护重点。本文档只描述已经在代码中能看到的事实；规划项会明确标为待办。
+
+## 文档结构
+
+- [需求文档](./requirements.md)：业务目标、用户角色、功能需求和非功能约束。
+- [设计文档](./design.md)：前端架构、路由、状态、数据模型和关键设计取舍。
+- [权限设计](./permissions.md)：已确定的角色、部门、报告、模板和 AI 上下文权限规则。
+- [进度文档](./progress.md)：当前完成度、已知风险和下一步建议。
+- [功能盘点](./features.md)：逐项区分真实可用、外部真实集成、前端演示和预留功能。
+- [测试文档](./testing.md)：测试命令、覆盖范围和待补端到端测试。
+- [API 契约草案](./api-contract.md)：后端化前的接口语义、权限过滤和响应格式约定。
+- [后端化与用户化改造方案](./backendization-plan.md)：前后端拆分、数据模型、API、权限、安全和迁移阶段。
+- [数据与存储](./data-storage.md)：`localStorage` / `sessionStorage` 键、数据生命周期和迁移点。
+- [部署运行](./deployment.md)：本地开发、后端 API、构建、Docker Compose 和 Nginx 部署方式。
+- [安全说明](./security.md)：当前安全边界、敏感信息风险和生产化建议。
+
+## 模块文档
+
+- [认证与用户权限](./modules/auth-and-users.md)
+- [报告编辑器](./modules/report-editor.md)
+- [报告管理与查看](./modules/report-management.md)
+- [模板管理](./modules/template-management.md)
+- [系统设置](./modules/system-settings.md)
+
+## 快速事实
+
+- 技术栈：React 19、TypeScript、Vite 6、Tailwind CSS 4、React Router DOM 7、NestJS、Prisma、PostgreSQL。
+- 应用类型：前端 SPA + NestJS API。登录、报告、模板、用户管理、部门模板授权、系统设置和签名文件已接入后端，其余主业务页面仍处于迁移期。
+- 数据层：认证用户、报告、报告媒体关系、模板、字段库、模板图片资源、视频/关键帧文件、用户管理、部门模板授权、系统设置和签名文件来自 PostgreSQL/后端文件目录。
+- 本地开发端口：前端 `3001`，后端 API `3000`；Docker Compose 暴露 API 到宿主机 `3002`。
+- 默认账号：`admin / 123456`、`manager / 123456`、`0001 / 123456`。
+- 核心代码目录：`src/pages`、`src/components`、`src/utils`、`src/types.ts`。