{"id":49888396,"url":"https://github.com/dataelement/shougang-group-knowledge-portal","last_synced_at":"2026-05-15T19:34:06.788Z","repository":{"id":356759910,"uuid":"1232690304","full_name":"dataelement/shougang-group-knowledge-portal","owner":"dataelement","description":"Knowledge protal of bisheng knowledge space for shougang group","archived":false,"fork":false,"pushed_at":"2026-05-09T15:15:39.000Z","size":62412,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-09T17:29:26.999Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dataelement.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-08T07:09:11.000Z","updated_at":"2026-05-09T15:15:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dataelement/shougang-group-knowledge-portal","commit_stats":null,"previous_names":["dataelement/shougang-group-knowledge-portal"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/dataelement/shougang-group-knowledge-portal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dataelement%2Fshougang-group-knowledge-portal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dataelement%2Fshougang-group-knowledge-portal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dataelement%2Fshougang-group-knowledge-portal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dataelement%2Fshougang-group-knowledge-portal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dataelement","download_url":"https://codeload.github.com/dataelement/shougang-group-knowledge-portal/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dataelement%2Fshougang-group-knowledge-portal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33076230,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-15T19:34:05.979Z","updated_at":"2026-05-15T19:34:06.780Z","avatar_url":"https://github.com/dataelement.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 首钢集团知识门户\n\n首钢知识门户 monorepo，包含：\n\n- `frontend/`：React + Vite 前端站点，覆盖首页、搜索、业务域列表、详情页、问答页、应用页和后台配置页\n- `backend/`：FastAPI BFF，提供门户配置、知识检索、详情、预览、相关推荐和问答代理接口\n\n## 目录结构\n\n```text\n.\n├── backend/   # FastAPI BFF\n├── frontend/  # React + Vite 前端\n├── deploy/    # 前后端 Dockerfile 与 nginx 配置\n├── scripts/   # 辅助脚本\n└── README.md\n```\n\n## 本地运行\n\n### 1. 启动后端\n\n要求：\n\n- Python `\u003e=3.11`\n- 当前仓库后端已在 Python `3.13` 环境下验证通过\n\n安装并运行：\n\n```bash\ncd backend\npython3.13 -m venv .venv\n./.venv/bin/pip install -e \".[dev]\"\n./.venv/bin/uvicorn app.main:app --reload --host 0.0.0.0 --port 8010\n```\n\n后端默认读取 `backend/.env` 中的 `PORTAL_*` 配置，并把门户配置持久化到：\n\n- `backend/app/config/data/portal_config.json`\n- `backend/app/config/data/bisheng_runtime.json`\n\n### 2. 启动前端\n\n```bash\ncd frontend\nnpm install\nnpm run dev\n```\n\nVite 开发服务器默认将 `/api` 代理到 `http://localhost:8010`。如需改目标地址，可设置 `VITE_BACKEND_PROXY_TARGET`。\n\n## 常用验证命令\n\n前端：\n\n```bash\ncd frontend\nnpm test\nnpm run lint\nnpm run build\n```\n\n后端：\n\n```bash\ncd backend\n./.venv/bin/python -m pytest\n```\n\n如果直接使用系统 Python 3.9 运行后端测试，会因为项目已使用 3.11+ 语法和标准库特性而失败；以 `backend/.venv` 为准。\n\n## Docker 镜像构建\n\n仓库在 `deploy/` 提供前后端 Dockerfile：\n\n```text\ndeploy/\n├── Dockerfile.portal-frontend   # node:20 编译 SPA → nginx:1.27 运行\n├── Dockerfile.portal-backend    # python:3.11-slim，VOLUME 持久化数据目录\n└── nginx/default.conf           # 默认反代 backend:8010（SSE 兼容，可 -v 覆盖）\n```\n\n在仓库根构建并运行：\n\n```bash\ndocker build -f deploy/Dockerfile.portal-backend  -t shougang/portal-backend:0.1.0  .\ndocker build -f deploy/Dockerfile.portal-frontend -t shougang/portal-frontend:0.1.0 .\n\ndocker network create portal-net\ndocker run -d --name backend --network portal-net \\\n  -e PORTAL_BISHENG_BASE_URL=http://192.168.106.115:8098 \\\n  -v /opt/portal-data:/app/app/config/data \\\n  shougang/portal-backend:0.1.0\ndocker run -d --name frontend --network portal-net -p 3001:80 \\\n  shougang/portal-frontend:0.1.0\n```\n\n可外挂的关键配置：\n\n- 前端 nginx 配置：`-v /path/to/my-nginx.conf:/etc/nginx/conf.d/default.conf:ro` —— upstream 后端地址变化时改 conf 不重 build\n- 后端运行时数据：`-v /opt/portal-data:/app/app/config/data` —— 持久化 `portal_config.json` + `bisheng_runtime.json` + `uploads/`，容器重建不丢 admin 配置\n- 后端环境变量：通过 `-e PORTAL_*=...` 注入 BiSheng 接入参数（完整变量见 `backend/app/settings.py`）\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdataelement%2Fshougang-group-knowledge-portal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdataelement%2Fshougang-group-knowledge-portal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdataelement%2Fshougang-group-knowledge-portal/lists"}