Files
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 <[email protected]>
2025-10-11 23:43:18 +08:00

158 lines
8.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
我把可复用的开源项目/组件清单按「前端(Portal/管理台/大屏)→ 后端与平台服务 → 数据与AI → 集成与基建 → 可观测与运维 → 测试与质量 → 安全与合规」分桶给你,每个条目都标注用途 | 亮点 | 许可,并尽量贴合你们的技术选型(Vue3+TS、Spring Boot、RabbitMQ、Redis、MinIO、Keycloak、K8s、Istio、等保二级、国产替代优先)。
⸻
前端(Web/管理台/小程序/大屏)
Web/管理台脚手架 & 组件
• Vue Vben Admin|中后台框架(Vue3+Vite+TS)|内置权限、菜单、表单/表格、国际化、主题|MIT
• Naive Admin|基于 Naive UI 的管理台脚手架|风格现代、拓展性强|MIT
• Arco Design Vue / Ant Design Vue / Element Plus|UI 组件库|成熟生态、表单/表格/弹窗齐全|MIT
• vue-echarts + Apache ECharts|可视化图表|中国地图/关系图/大屏适配强|Apache-2.0
• **bpmn-js(bpmn.io)**|BPMN 2.0 可视化建模器|可集成流程设计/查看|MIT
• Monaco Editor / Tiptap(ProseMirror)/ Quill|富文本/代码编辑|在线模版、合同条款编辑|MIT
• ag-Grid(社区版)/ Handsontable(CE)/ DataGrid|复杂表格/数据透视|大数据量渲染强|MIT/多许可
• tus-js-client + tusd|大文件分片断点续传协议(前后端配套)|稳定可靠|MIT
• pdf.js|PDF 在线预览|合同/票据预览|Apache-2.0
• OnlyOffice Docs 社区版|在线文档编辑(可选)|合同协作/修订|AGPL-3.0
小程序/移动端
• Taro|多端统一(含微信小程序)|React/Vue 皆可|MIT
• NutUI / Vant|移动组件库|小程序样式友好|MIT
大屏/可视化模板
• **DataV-Vue3(开源实现)**|大屏组件库与模板|飞线图、排名条、指标卡|MIT
• AntV G2 / G6 / L7|统计图、关系图、地图|可做专家关系/项目关系/地理分布|MIT
• deck.gl|高性能 WebGL 可视化(轨迹/热力)|MIT
• Apache Superset / Metabase|即开即用 BI 大屏(拖拽)|快速搭 KPI 总览|Apache-2.0 / AGPL-3.0
⸻
后端与平台服务(Java & Gateway)
微服务 & 网关 & 配置
• Spring Boot / Spring Cloud|服务框架|事实标准|Apache-2.0
• Spring Cloud Gateway|API 网关|限流/路由/鉴权扩展方便|Apache-2.0
• **Spring Cloud Alibaba(Nacos/Sentinel/Seata 可选)**|注册配置/流控/分布式事务(信创常用)|Apache-2.0
• Resilience4j|熔断/限流/隔离/重试|轻量现代|Apache-2.0
• Bucket4j|基于令牌桶的精细化限流(租户/用户级)|Apache-2.0
• Springdoc-openapi|OpenAPI 生成与UI|与你现有 openapi.yaml 对齐|Apache-2.0
持久化 & DAO
• MyBatis-Plus|CRUD/分页/乐观锁/审计字段|国产团队使用广泛|Apache-2.0
• Spring Data JPA(如需)|规范化仓储|Apache-2.0
• Flyway / Liquibase|数据库版本管理/灰度变更|Apache-2.0
注:达梦 DM8 可通过 JDBC + MyBatis-Plus 自定义方言适配,配合 Flyway 维护 DDL;如引入检索/分析库可配 OpenSearch / ClickHouse 并解耦核心交易库。
消息/任务/调度
• RabbitMQ|领域事件与命令|稳定低延迟|MPL-2.0
• Kafka(用于 CDC/日志/分析链路)|高吞吐可回放|Apache-2.0
• xxl-job / Quartz|分布式任务与调度中心|中国团队常用/简单好管|Apache-2.0
文件/对象存储/预览
• MinIO|S3 兼容对象存储|K8s 友好|AGPL-3.0
• imgproxy / Thumbor|图片安全裁剪与缩放|MIT
• JodConverter + LibreOffice|Office → PDF 转换服务|Apache-2.0
身份认证/权限/策略
• Keycloak|OIDC/OAuth2、RBAC/多租户 realm|与网关/前端易集成|Apache-2.0
• **OPA(Open Policy Agent)**|策略即代码(ABAC/细粒度)|可做数据权限与审批边界|Apache-2.0
工作流/BPM
• Flowable / Activiti 7|BPMN 2.0 引擎|轻量可控,国产环境适配好|Apache-2.0
• bpmn-js(前文)|配套设计器前端可嵌入
⸻
数据与 AI(匹配/推荐/检索/向量)
向量与检索
• Milvus / Qdrant / pgvector|向量召回|相似度匹配、混合检索(BM25+向量)|Apache-2.0 / AGPL-3.0 / PostgreSQL
• **OpenSearch(Elasticsearch 开源分支)**|全文检索/聚合/同义词|Apache-2.0
• IK Analyzer / HanLP 分词|中文分词插件|MIT/Apache-2.0
特征与推荐
• Feast|Feature Store(离线/在线特征一致性)|Apache-2.0
• RecBole|学术级推荐框架(评测 MAP@K/AUC)|MIT
• LightGBM/XGBoost/CatBoost|经典树模型|Apache-2.0
AI 服务框架
• FastAPI(你们已选)|高性能 Python API|MIT
• Ray / Celery|分布式任务/特征计算/批推理|Apache-2.0 / BSD-3
• **ONNX Runtime / TensorRT(可选)**|推理加速|MIT/NVIDIA
⸻
集成与基建(CDC/搜索/网关/网盘/制品)
• Debezium|CDC(MySQL/PG/…)→ Kafka → 索引/ODS|Apache-2.0
• Apache APISIX / Kong(备选网关)|生态插件丰富/灰度流量|Apache-2.0
• Harbor|镜像仓库|RBAC/漏洞扫描/私有部署|Apache-2.0
• Nexus / Artifactory-CE|制品库(Maven/NPM/PyPI)|EPL-1.0/OSS
• HashiCorp Vault|密钥/证书/动态凭据(DBI)|MPL-2.0
• OPA Gatekeeper|K8s 准入策略(合规/资源配额)|Apache-2.0
⸻
可观测性与运维(等保落地友好)
监控/日志/追踪
• Prometheus + Alertmanager|指标与告警|Apache-2.0
• Grafana|可视化大盘(系统/业务/SLO)|AGPL-3.0
• **Loki / ELK(OpenSearch Dashboards)**|日志采集与分析|MIT/Apache-2.0
• **OpenTelemetry(Collector/Java Agent/Python SDK)**|统一埋点|Apache-2.0
• Jaeger / Tempo / Apache SkyWalking|分布式追踪(SkyWalking 在国内生态好)|Apache-2.0
部署/发布/灰度
• Helm / Kustomize|K8s 部署编排|Apache-2.0
• Argo CD|GitOps 持续交付|Apache-2.0
• Argo Rollouts / Flagger|金丝雀/蓝绿自动化发布|Apache-2.0
• Istio / Kuma|Service Mesh(mTLS/灰度/熔断/遥测)|Apache-2.0
配置/特性开关
• Nacos / Spring Cloud Config|集中配置|Apache-2.0
• Unleash / Flagsmith|特性开关(按租户/用户灰度)|Apache-2.0/MIT
⸻
测试与质量(契约/E2E/性能/安全)
• Pact / Spring Cloud Contract|消费者驱动契约测试|MIT/Apache-2.0
• Playwright / Cypress|E2E UI 自动化|Apache-2.0/MIT
• Rest Assured + WireMock|API 自动化/桩服务|Apache-2.0
• k6 / Gatling / JMeter|性能压测(k6 更现代 DevOps 友好)|AGPL-3.0/Apache-2.0
• OWASP ZAP|动态安全扫描(管道集成)|Apache-2.0
• SonarQube 社区版|代码质量与安全规则|LGPL-3.0
⸻
安全与合规(等保二级要点)
• Keycloak(再提)|统一身份/SSO/OIDC + MFA|Apache-2.0
• OPA / OpenFGA|细粒度授权(ABAC/RBAC 关系图)|Apache-2.0
• CNCF Notary / Cosign|镜像签名与供应链安全(SLSA)|Apache-2.0
• Trivy / Grype|镜像与依赖漏洞扫描|Apache-2.0
• Auditbeat/Filebeat|主机/文件/审计事件采集|Apache-2.0
⸻
可直接打包复用的“组合拳”建议
1. 管理台:Vue Vben Admin + Ant Design Vue + vue-echarts + bpmn-js + ag-Grid + pdf.js + tus(大文件)。
2. 门户/小程序:Taro + Vant(移动)或 Web 端同构组件集。
3. 大屏:DataV-Vue3 模板 + ECharts/AntV(关系/地理)+ deck.gl(高密/轨迹)。
4. 认证鉴权:Keycloak(Realm=租户) + Spring Security OIDC 适配 + OPA 做细粒度策略。
5. 工作流:Flowable(引擎) + bpmn-js(前端设计器) + 事件驱动外挂节点(经纪/签约回调)。
6. 搜索与向量:OpenSearch(全文) + Milvus/pgvector(相似度)+ Debezium 同步索引。
7. 对象存储:MinIO + imgproxy + OnlyOffice(可选在线编辑)。
8. 可观测:Prometheus + Grafana + Loki + Tempo/Jaeger + OTel Collector(Java/Python/Node 统一)。
9. 发布灰度:Argo CD + Argo Rollouts + Istio(金丝雀 10→30→50→100 自动回滚)。
10. 质量守门:Pact(契约)+ Playwright(E2E)+ k6(性能)+ ZAP(安全)流水线四件套。
⸻
与你们设计的“精准对位”
• 等保:Keycloak(统一身份)+ OPA(数据权限)+ Loki(审计落盘)+ Vault(密钥)+ Istio mTLS。
• 事件一致性:数据库 Outbox 表 + RabbitMQ(命令/领域事件)+ Kafka(CDC/BI)。
• 信创适配:核心交易仍走达梦 DM8;检索/向量/日志分析走 OpenSearch / ClickHouse / Kafka 并解耦。
• AI 匹配:FastAPI 服务 + Milvus/pgvector + Feast(特征)+ OpenAPI/AsyncAPI 契约对齐。
⸻