gao/template
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
master
template/requirements
T
History
Claude AIandClaude 9f9cbfbc80 feat: Complete MVP Sprint 01 project setup with comprehensive architecture 
## 🏗️ Architecture & Design
- Add ADR collection (15 Architecture Decision Records)
- Comprehensive system design documentation
- Implementation roadmap and project planning

## 📋 Requirements & Documentation
- Detailed functional requirements
- API specifications (OpenAPI & AsyncAPI)
- Postman collections and optimization reports

## 🗄️ Database & Configuration
- Database migration scripts (CDC, core schema)
- Resilience4j configuration for resilience patterns
- Alert manager and Prometheus monitoring rules

## 🎯 Project Templates
- Admin frontend template (Arco Pro + Vue 3)
- Big screen data visualization template (ECharts)
- Enterprise backend template (Jeecg Boot + Spring Boot)

## 🧪 Testing & Quality
- K6 performance testing scenarios
- Load testing benchmark scripts
- Quality assurance framework setup

## 📦 Infrastructure & Deployment
- Complete infrastructure configurations
- Deployment strategies and CI/CD pipelines
- Monitoring and observability setup

This commit establishes the complete foundation for the MVP Sprint 01
development cycle with all necessary architectural decisions, templates,
and documentation ready for team collaboration.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-11 23:43:18 +08:00
..
functional-requirements.md
feat: Complete MVP Sprint 01 project setup with comprehensive architecture
2025-10-11 23:43:18 +08:00
README.md
feat: Complete MVP Sprint 01 project setup with comprehensive architecture
2025-10-11 23:43:18 +08:00

README.md

需求分析与规格说明

概述

基于《详细设计文档》、《交付蓝图》和《开源技术栈》的综合分析，制定光明科学城科技成果转化平台的可落地需求规格。

核心业务需求

1. 用户与权限管理

  • 多租户隔离: 支持高校、科研院所、企业等不同机构独立管理
  • 统一身份认证: 集成 Keycloak 实现 SSO 单点登录
  • 细粒度权限: 基于 RBAC + ABAC 的数据权限控制
  • 审计合规: 符合等保二级要求的操作日志与审计

2. 科技成果管理

  • 多元成果类型: 专利、论文、软件著作权、技术秘密等
  • 智能分类: 基于向量语义的自动分类与标签
  • 全文检索: 支持中文分词和同义词扩展
  • 版本管理: 成果信息的历史版本追踪

3. 需求匹配引擎

  • AI智能匹配: 基于向量相似度 + 规则引擎的混合匹配
  • 推荐算法: 协同过滤 + 内容过滤的个性化推荐
  • 匹配度评分: 可解释的匹配原因和置信度
  • 实时更新: 新成果/需求的实时索引与推送

4. 经纪业务流程

  • 工作流引擎: 基于 BPMN 2.0 的可视化流程设计
  • 任务分配: 智能分配经纪人与自动任务提醒
  • 进度跟踪: 全流程可视化与里程碑管理
  • 绩效统计: 经纪人工作量与成功率分析

5. 活动与资讯

  • 活动管理: 线上线下活动的发布与报名
  • 内容管理: 富文本编辑与多媒体支持
  • 消息推送: 多渠道消息通知（站内、短信、邮件）
  • 数据分析: 活动效果与用户行为分析

技术需求

1. 性能要求

  • 并发支持: 2000+ 在线用户，500 TPS
  • 响应时间: API 响应 < 200ms，页面加载 < 2s
  • 可用性: 99.5% SLA，RTO < 4h，RPO < 1h
  • 扩展性: 支持水平扩展，弹性伸缩

2. 安全要求

  • 等保二级: 符合信息安全等级保护二级要求
  • 数据加密: 传输加密 TLS 1.3，存储加密 AES-256
  • 访问控制: 基于角色的访问控制与最小权限原则
  • 安全审计: 完整的操作日志与异常检测

3. 兼容性要求

  • 信创适配: 优先选择国产软件与技术栈
  • 浏览器兼容: Chrome 90+, Firefox 88+, Safari 14+
  • 移动端: 响应式设计，支持微信小程序
  • 标准化: 符合 OpenAPI 3.0 与 AsyncAPI 2.6 规范

业务用例规格

UC001: 用户注册与认证

主场景:

  1. 用户选择注册类型（个人/机构）
  2. 填写基本信息并上传认证材料
  3. 系统发送邮箱/手机验证码
  4. 管理员审核认证材料
  5. 审核通过后激活账户

前置条件: 用户提供有效联系方式 后置条件: 用户获得平台访问权限 异常处理: 认证失败时提供申诉机制

UC002: 科技成果发布

主场景:

  1. 用户选择成果类型并填写详细信息
  2. 上传相关文档和图片
  3. 系统进行内容审核和安全扫描
  4. AI 自动提取关键词和分类标签
  5. 成果发布并同步到检索引擎

业务规则:

  • 专利成果需上传专利证书
  • 技术秘密需设置保密级别
  • 图片文件限制 10MB，文档限制 50MB

UC003: 智能需求匹配

主场景:

  1. 用户发布技术需求
  2. AI 引擎分析需求特征向量
  3. 系统检索相似成果并计算匹配度
  4. 生成匹配报告并推送给相关用户
  5. 用户查看匹配结果并发起洽谈

性能指标:

  • 匹配算法响应时间 < 5s
  • 推荐精度 MAP@10 > 0.3
  • 覆盖率 > 80%

UC004: 经纪业务流程

主场景:

  1. 经纪人接收匹配任务
  2. 联系需求方和供给方了解详情
  3. 组织洽谈会议并记录沟通进展
  4. 协助双方制定合作方案
  5. 跟踪合同签署和项目实施

KPI 指标:

  • 任务响应时间 < 2h
  • 匹配成功率 > 15%
  • 客户满意度 > 4.0/5.0

数据需求

1. 核心实体模型

-- 用户实体
User: id, username, email, phone, type, status, tenant_id
-- 成果实体  
Achievement: id, title, description, type, owner_id, status
-- 需求实体
Demand: id, title, description, field, requester_id, status
-- 匹配结果
Match: id, demand_id, achievement_id, score, reasons

2. 数据量估算

  • 用户数据: 10万用户，年增长 20%
  • 成果数据: 50万条成果，年增长 30%
  • 需求数据: 10万条需求，年增长 50%
  • 匹配数据: 100万条匹配记录，日增长 1000条

3. 数据质量要求

  • 完整性: 核心字段非空率 > 95%
  • 准确性: 数据校验规则覆盖率 100%
  • 一致性: 跨服务数据最终一致性 < 30s
  • 时效性: 实时数据延迟 < 5s

集成需求

1. 外部系统集成

  • SSO 系统: 支持 OIDC/SAML 2.0 协议
  • BPM 系统: 与现有工作流引擎集成
  • 电子签约: 集成第三方电子签约平台
  • 支付系统: 支持在线支付和发票开具

2. API 接口要求

  • RESTful API: 符合 REST 成熟度模型 Level 3
  • GraphQL: 支持复杂查询和实时订阅
  • WebSocket: 实时消息推送和状态同步
  • 批量 API: 支持批量操作和数据导入导出

质量属性需求

1. 可维护性

  • 代码质量: SonarQube 评分 > A 级
  • 文档覆盖: API 文档 100%，代码注释 > 80%
  • 测试覆盖: 单元测试 > 80%，集成测试 > 60%

2. 可监控性

  • 指标监控: 业务指标和技术指标实时监控
  • 日志管理: 结构化日志和分布式链路追踪
  • 告警机制: 基于 SLO 的智能告警和降级

3. 可扩展性

  • 微服务架构: 服务间松耦合，支持独立部署
  • 数据库分片: 支持读写分离和分库分表
  • 缓存策略: 多级缓存和缓存雪崩防护

约束条件

1. 技术约束

  • 开发语言: Java 17+, Vue 3 + TypeScript
  • 数据库: 达梦 DM8 (信创要求)
  • 消息队列: RabbitMQ + Kafka
  • 容器化: Docker + Kubernetes

2. 法规约束

  • 数据保护: 符合《个人信息保护法》要求
  • 网络安全: 符合《网络安全法》和等保二级
  • 知识产权: 遵守《专利法》和《著作权法》

3. 业务约束

  • 项目周期: 一期开发 6 个月，二期迭代 3 个月
  • 预算限制: 硬件成本控制在 100 万以内
  • 团队规模: 开发团队 15-20 人，运维团队 3-5 人

验收标准

1. 功能验收

  • 用例覆盖: 100% 主流程用例通过
  • 边界测试: 异常场景处理正确
  • 兼容性测试: 主流浏览器和设备支持

2. 性能验收

  • 负载测试: 峰值负载下系统稳定运行
  • 压力测试: 极限压力下优雅降级
  • 稳定性测试: 7×24 小时稳定运行

3. 安全验收

  • 渗透测试: 通过第三方安全评估
  • 合规审计: 通过等保二级测评
  • 代码审计: 无严重安全漏洞
Reference in New Issue View Git Blame Copy Permalink