# scenario-lab-portal

**Repository Path**: wangboa/scenario-lab-portal

## Basic Information

- **Project Name**: scenario-lab-portal
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-09
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 公共数据融合应用创新实验室

> 公共数据融合应用创新实验室是数据局数据资源处、数字经济处面向企业的在线服务窗口，为企业提供场景申报、企业入库、融合创新的一站式线上服务。

## 项目概述

本项目是四川省数据局指导下建设的公共数据融合应用创新实验室在线服务门户，目标实现：

- **场景申报**：企业在线提交场景方案，追踪审批进度
- **企业入库**：数创企业 / 数据企业双通道在线入库登记
- **数据集申报**：高质量数据集认定在线申报与 TC609 检测
- **融合开发**：数据融合验证支撑（"数据不出域，算法跑进来"）

## 技术栈

| 层级 | 技术选型 |
|------|----------|
| 后端框架 | Ruby on Rails 8.1（API + ERB 壳，单体应用） |
| 前端框架 | React 18 + TypeScript（SPA） |
| 构建工具 | Vite + vite_rails |
| 数据库 | MySQL 8.0 |
| 认证 | BCrypt + Cookie Session + CSRF Token |
| 授权 | Pundit（RBAC + 数据范围策略） |
| 异步队列 | Solid Queue |
| 容器化 | Docker（单容器）+ MySQL 独立部署 |

## 前端架构

### 组件层级

```
AppLayout (layout/)
├── Header          — 全局导航（sticky, 响应式）
│   ├── .skip-link  — 无障碍跳转
│   ├── .site-logo  — Logo + "场景融创实验室"
│   ├── .site-nav   — 7 个主导航 + 工作台下拉菜单
│   ├── .header-actions — 登录态：用户名+退出 | 未登录：入库登记+登录
│   └── .nav-toggle — 768px 以下汉堡菜单
├── <Outlet />      — 页面内容（id="main-content"）
└── Footer          — 指导/运营单位 + 版权/ICP + 技术支持
```

### 路由结构

| 路由 | 页面 | 认证 |
|------|------|------|
| `/` | 首页 | 公开 |
| `/login` `/register` | 登录/注册 | 公开 |
| `/guide-lab` `/guide-enterprise` `/guide-dataset` `/fusion-scenarios` `/announcement` `/policies` `/about` `/assessment` | 指南与公开信息（PlaceholderPage 占位） | 公开 |
| `/health-check` | 数据质量预检 | 公开 |
| `/my/applications` | 我的申报 | 需登录 |
| `/ops/dashboard` `/ops/applications` `/ops/catalog` | 运营工作台 | 需登录 |
| `/review/workbench` | 评审工作台 | 需登录 |
| `/report-tc609` | TC609 检测报告 | 需登录 |
| `/dashboard` | 数据看板 | 需登录 |

### 样式约定

- 全局样式：`app/javascript/styles/global.css` — Design Tokens（CSS 变量）、Header、Footer、按钮、表单、卡片等共享组件
- 页面独有样式：各页面组件内使用 `<style>` 块或 CSS Module
- 禁止硬编码色值，统一使用 `var(--blue-600)` 等 CSS 变量
- 对比度底线：正文/辅助文字最浅 `var(--slate-500)`（4.64:1），`--slate-400` 仅用于装饰图标

## 用户角色

| 角色 | 说明 |
|------|------|
| 公众访客 | 浏览政策、条件自查、免费预检 |
| 企业用户 | 在线入库登记、申报、进度追踪 |
| 运营人员 | 受理申报、资源目录管理 |
| 专家评审 | 分屏评审、在线打分 |
| 管理决策 | 全局态势、数据看板 |

## 当前开发阶段

**Phase 1: SPA 骨架** — 已完成

- [x] Rails 工程初始化，Vite + React 脚手架
- [x] SPA 壳（Header / Footer / 路由）— 完整导航 + 下拉菜单 + 移动端响应式
- [x] 全局 CSS 设计系统（`app/javascript/styles/global.css`）
- [x] 认证闭环 — 登录/注册/登出 API + BCrypt + Token 认证 + AuthContext
- [x] 9 个占位页面组件 + AuthContext 框架
- [x] 共享类型定义、API 调用层框架

**Phase 2A: 公开内容** — 已完成

- [x] 种子数据补充（ResearchInsights 4 条）
- [x] 9 个共享 React 组件（Badge / ProgressBar / Timeline / CheckList / PageHero / PillFilter / SceneCard / PolicyCard / KPICard）
- [x] 公示公告页（分类 Pill 筛选，API 对接）
- [x] 政策文件页（API 对接）
- [x] 关于实验室页（五层框架 + 三方协同 + 联系方式）
- [x] 社采数据成效评估页（评估维度 + 流程 + 结果分档）
- [x] 融合开发页（方向卡片 + 流程 + 沙箱功能）
- [x] 场景广场页（分类筛选 + SceneCard 网格，API 对接）
- [x] 场景申报指南页（自查清单 + 时间线 + 往期公示）
- [x] 企业入库指南页（双通道切换 + 6 方向多选 + 动态自查）
- [x] 数据集认定指南页（TC609 三维度 + 自查提示）
- [x] 首页重写（5 路 API 并行请求 + KPI 计数动画 + 场景筛选 + 激励政策 + 双栏信息面板）

**实施计划** → [docs/implementation-plan.md](docs/implementation-plan.md)

| 阶段 | 内容 | 工期 | 人力 | 状态 |
|------|------|------|------|------|
| Phase 0 | 后端地基：全部 Model + Migration + API 路由骨架 | 2-3 天 | 1 人 | ✅ |
| Phase 1 | 认证闭环：登录/注册 API + Pundit + 前后端打通 | 2-3 天 | 1 人 | ✅ |
| 🔀 并行起点 | — | — | — | — |
| Phase 2A | 公开内容：10 个前端页面 + 只读 API | 4-5 天 | 1 人 | ✅ |
| Phase 2B | 企业功能：入库登记、申报、预检、TC609 报告 | 4-5 天 | 1 人 | ⏳ |
| Phase 3 | 后台工作台：运营 + 评审 + 数据看板 | 4-5 天 | 2 人 | ⏳ |
| Phase 4 | 生产就绪：TC609 对接、消息中心、部署 | 2-3 天 | 2 人 | ⏳ |

**已完成工期：8-11 天 · 总工期：18-24 天**

## 本地开发

```bash
# 安装依赖
bundle install
npm install

# 启动 Rails 服务器
bin/rails server

# 启动 Vite 开发服务器（HMR）
bin/vite dev

# 启动 Solid Queue Worker
bundle exec rake solid_queue:start
```

访问 `http://localhost:3000` 即可开始开发。

## 文档体系

```
docs/
├── product-overview-design.md         # 产品定位、架构全景、文档索引
├── product-detailed-design.md         # 功能详细设计
├── prototype-module-design.md         # 18 个原型页面拆解
├── ui-design-spec.md                  # 设计规范、组件库
├── technical-architecture-design.md   # 后端架构、API、部署
├── implementation-plan.md             # 实施计划：阶段划分与依赖关系
├── phase2a-implementation-plan.md     # Phase 2A 详细实施计划
└── report_v2.3.md                     # 业务背景汇报材料
```

## 三方分工

| 角色 | 单位 | 职责 |
|------|------|------|
| 政策与资金 | 数据资源处 / 数字经济处 | 定标准、抓项目、管资金、做审批 |
| 研究与运营 | 数字经济研究中心 | 组织评审、场景管理、门户运营 |
| 技术与平台 | 四川数据集团 | 平台建设运维、TC609 检测、沙箱环境 |