{"id":25495753,"url":"https://github.com/corcd/dynamic-code-system","last_synced_at":"2026-04-08T18:31:16.578Z","repository":{"id":40812674,"uuid":"281382239","full_name":"corcd/dynamic-code-system","owner":"corcd","description":"基于 Egg.js 的 RESTful 风格动态代码下发系统","archived":false,"fork":false,"pushed_at":"2022-12-13T08:33:35.000Z","size":3491,"stargazers_count":2,"open_issues_count":21,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-03T18:49:07.183Z","etag":null,"topics":["dynamic-code","eggjs","mysql","nodejs","redis","sequelize","vue"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/corcd.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}},"created_at":"2020-07-21T11:45:17.000Z","updated_at":"2021-12-02T08:42:08.000Z","dependencies_parsed_at":"2023-01-28T09:40:17.305Z","dependency_job_id":null,"html_url":"https://github.com/corcd/dynamic-code-system","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/corcd/dynamic-code-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/corcd%2Fdynamic-code-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/corcd%2Fdynamic-code-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/corcd%2Fdynamic-code-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/corcd%2Fdynamic-code-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/corcd","download_url":"https://codeload.github.com/corcd/dynamic-code-system/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/corcd%2Fdynamic-code-system/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31568578,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"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":["dynamic-code","eggjs","mysql","nodejs","redis","sequelize","vue"],"created_at":"2025-02-19T00:39:11.647Z","updated_at":"2026-04-08T18:31:16.535Z","avatar_url":"https://github.com/corcd.png","language":"JavaScript","readme":"# dynamic-code-system\n\n**基于 Egg.js 的 RESTful 风格动态代码下发系统**\n\n**动态代码下发系统**赋予某个脚本动态的特性，开发人员/产品人员通过控制台界面操作可以对该脚本的内容进行更改，而从可以在不重新发版的情况下，直接更新线上代码\n\n## 技术选型\n\n- Node.js 10+\n- Egg.js 2.x\n- Mysql 5.8+\n- Redis 5\n\n## 使用方式\n\n#### 区分\n\n- server 目录为服务端目录\n- client 目录为客户端目录\n\n#### 测试环境服务启动\n\n```bash\nsudo yarn\nsudo yarn dev\n```\n\n#### 生产环境服务启动/停止\n\n\u003e 生产环境请勿使用 `Ctrl + C` 终止服务\n\n```bash\nsudo yarn\nsudo yarn start\nsudo yarn stop\n```\n\n#### 浏览器端成品代码引入\n\n\u003e 此处 appid 即为配置应用的 appid\n\n```html\n\u003cscript src=\"http://***/api/v1/source/:appid\"\u003e\u003c/script\u003e\n```\n\n## API\n\nAPI 设计遵循标准化 RESTful 风格，响应头 `application/json`，规则如下\n\n- GET：读取（Read）\n- POST：新建（Create）\n- PUT：更新（Update）\n- PATCH：更新（Update），通常是部分更新\n- DELETE：删除（Delete）\n\n### 配置相关\n\n#### /api/v1/config\n\nDesc: 查询所有可用的 app\n\nMethod: `GET`\n\nQuery:\n\n```json\n{\n    \"page\": 1,\n    \"pageSize\": 10\n}\n```\n\n#### /api/v1/config\n\nDesc: 创建新的 app 配置\n\nMethod: `POST`\n\nBody:\n\n```json\n{\n    \"project\": \"Yours app name\"\n}\n```\n\n#### /api/v1/config/:appid\n\nDesc: 获取已有 app 配置\n\nMethod: `GET`\n\n#### /api/v1/config/:appid\n\nDesc: 更新已有 app 配置\n\nMethod: `PUT/PATCH`\n\nBody:\n\n```json\n{\n    \"project\": \"Yours app name\",\n    \"schema\": \"app's schema\"\n}\n```\n\n```json\nschema 必须为数组，其单项规则如下:\n[\n    {\n        \"type\": \"item type\",\n        \"params\": \"item's options\"\n    }\n]\n```\n\n#### /api/v1/config/:appid\n\nDesc: 软删除已有 app 配置\n\nMethod: `DELETE`\n\n### 资源相关\n\n#### /api/v1/source/:appid\n\nDesc: 获取已有 app 动态代码\n\nMethod: `GET`\n\n## 构建模块扩展\n\n自定义构建模块，需要在 `service/modules` 目录下新建构建模块目录（目录命名对应 `schema.type`），目录中模块应最终返回成品代码\n\n然后在 `service/modules/index.js` 中 require 该模块，在 `module.export` 的 `Map` 中建立 type 与模块函数的映射关系，映射关系中值的 options 参数即为 `schema.arguments`，至此即完成了模块扩展引入\n\n\u003e 具体可参考用作测试的 test 模块的引入方式\n\n## 稳定性方案\n\n为了不让服务直面客户端，可以在服务前面设立一道防线，常见的做法有：\n\n- API 接入 Gateway\n- 静态资源 CDN 化\n\n系统目前实现了脚本的 API 化，但是其本质还是服务器返回脚本，访问是不需要登录或者权限的，所以采取 CDN 更加适合生产模式\n\n由此带来的好处：\n\n- 根据缓存和回源特性，拦截了大部分流量，缓解了源站的压力\n- CDN 服务在全国各地都有节点，可以有效解决跨地域访问问题，降低访问延时\n- 利用 CDN 强大的计算能力，可以拦截恶意攻击、降低“广播风暴”的影响\n\n#### 建议\n\n由于客户端访问的脚本地址仍然是一个不变地址，所以返回脚本不能是永久缓存，需要设置一个较短的时间\n\n\u003e 目前，从结果来看，5 分钟是一个可接受的实践值\n\n## 授权协议\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcorcd%2Fdynamic-code-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcorcd%2Fdynamic-code-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcorcd%2Fdynamic-code-system/lists"}