{"id":21418953,"url":"https://github.com/hal-wang/wedding-card","last_synced_at":"2026-03-14T01:32:26.937Z","repository":{"id":39332966,"uuid":"304195145","full_name":"hal-wang/wedding-card","owner":"hal-wang","description":"电子喜帖，无服务器，管理员可生成邀请二维码。使用CloudBase 的云函数、静态网站托管、数据库","archived":false,"fork":false,"pushed_at":"2022-12-07T16:12:07.000Z","size":1774,"stargazers_count":27,"open_issues_count":0,"forks_count":13,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-04-28T03:15:11.774Z","etag":null,"topics":["cloudbase","ipare","qr-code","serverless","static-site","vue","wedding"],"latest_commit_sha":null,"homepage":"https://wedding.hal.wang","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hal-wang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-10-15T03:04:54.000Z","updated_at":"2024-04-11T05:53:26.000Z","dependencies_parsed_at":"2023-01-24T18:04:36.561Z","dependency_job_id":null,"html_url":"https://github.com/hal-wang/wedding-card","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal-wang%2Fwedding-card","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal-wang%2Fwedding-card/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal-wang%2Fwedding-card/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal-wang%2Fwedding-card/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hal-wang","download_url":"https://codeload.github.com/hal-wang/wedding-card/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225953829,"owners_count":17550768,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cloudbase","ipare","qr-code","serverless","static-site","vue","wedding"],"created_at":"2024-11-22T19:30:50.606Z","updated_at":"2026-03-14T01:32:26.869Z","avatar_url":"https://github.com/hal-wang.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 电子喜帖\n\n无需服务器，使用腾讯云 CloudBase 的云函数、静态网站托管、数据库，费用极低（普通浏览量免费或一天一分钱）\n\n管理员可生成邀请二维码\n\n结婚时自用，现在用来纪念和记录\n\n线上地址： \u003chttps://wedding.hal.wang\u003e\n\n网页地址为 `/admin` 则进入管理页，可以添加邀请，并生成邀请二维码。\n\n生成的二维码内容是个网址如 \u003chttps://wedding.hal.wang/#/?name=%E6%B1%AA%E6%96%87%E8%B1%AA\u003e\n\n\u003e 首页 `已相守 ... 天` 是动态的，如果当前日期在结婚之前，会显示为婚礼倒计时\n\n## 改为自己用，你需要做：\n\n1. 一键部署 [![](https://main.qcloudimg.com/raw/67f5a389f1ac6f3b4d04c7256438e44f.svg)](https://console.cloud.tencent.com/tcb/env/index?action=CreateAndDeployCloudBaseProject\u0026appUrl=https%3A%2F%2Fgithub.com%2Fhal-wang%2Fwedding-card\u0026branch=main)\n\n2. 添加环境变量\n   - ADMIN:管理员密码\n   - GROOM:新郎姓名\n   - BRIDE:新娘姓名\n   - DATE:结婚时间，格式 yyyy-MM-dd HH:mm:ss\n   - ADDR:详细地址\n   - PHONE:电话\n   - COVER:封面文件名，对应文件上传至云存储根目录\n   - ALBUM:相册文件名，可多个，使用逗号分隔，如 `1.jpg`,`2.png`,... 对应文件上传至云存储 album 目录中\n   - MUSIC:背景音乐文件名，对应文件上传至云存储根目录\n   - FAVICON:网页图标文件名，对应文件上传至云存储根目录\n   - MHID:草料二维码模板 ID，用于生成喜帖二维码\n\n### 关于草料二维码模板 ID\n\n访问 \u003chttps://cli.im/api\u003e\n\n调整美化模板，会自动生成连接，其中 `mhid` 参数即为模板 ID\n\n## 二次开发\n\n如果现有功能不能满足，你可以进行二次开发\n\n### API\n\n在 `wedding-card-api` 下创建文件 `.env.local`，内容如下\n\n```\nSCF_NAMESPACE=cloudbase环境id\nSECRET_KEY=腾讯云 secret key\nSECRET_ID=腾讯云 secret id\nADMIN=管理员密码\nCOVER=封面文件名，对应文件上传至云存储根目录\nALBUM=相册文件名，可多个，使用逗号分隔，如 1.jpg,2.png,...。对应文件上传至云 album 目录中\nMUSIC=背景音乐文件名，对应文件上传至云存储根目录\nFAVICON=网页图标文件名，对应文件上传至云存储根目录\n```\n\n#### 运行 API\n\n先安装依赖，在 `wedding-card-api` 下执行\n\n```bash\nnpm install\n```\n\n再使用 vscode 打开 `wedding-card-api`，直接 F5 开始调试\n\n或在 `wedding-card-api` 目录下执行\n\n```bash\nnpm start\n```\n\n### Web\n\n先安装依赖，在 `wedding-card-web` 下执行\n\n```bash\nnpm install\n```\n\n再执行下面命令运行\n\n```bash\nnpm run dev:test\n```\n\n或使用已发布的接口，需要修改 `wedding-card-web/.env.development` 文件中的 `VITE_GLOB_PROXY_API_URL`\n\n然后运行\n\n```bash\nnpm run dev\n```\n\n### 发布\n\n可以本地使用 `@cloudbase/cli` 发布，也可以使用 GitHub Actions 持续集成\n\n#### cli 发布\n\n在项目根目录下创建 `.env.local` （注意是项目根目录，不是 API 或 Web 下）\n\n内容如下\n\n```\nENV_ID=cloudbase环境id\nADMIN=管理员密码\nGROOM=新郎姓名\nBRIDE=新娘姓名\nDATE=结婚时间，格式 yyyy-MM-dd HH:mm:ss\nADDR=详细地址\nPHONE=电话\nCOVER=封面文件名，对应文件上传至云存储根目录\nALBUM=相册文件名，可多个，使用逗号分隔，如 1.jpg,2.png,...。对应文件上传至云 album 目录中\nMUSIC=背景音乐文件名，对应文件上传至云存储根目录\nFAVICON=网页图标文件名，对应文件上传至云存储根目录\nMHID=草料二维码 ID，用于生成喜帖二维码\n```\n\n在项目根目录下运行以下命令发布\n\n```bash\nnpm run deploy\n```\n\n#### GitHub Actions\n\n仓库增加 Secrets，在 `Settings -\u003e Secrets -\u003e Actions`，点击 `New repository secret` 按钮\n\n- TENCENT_SECRET_ID: 腾讯云 secret id\n- TENCENT_SECRET_KEY: 腾讯云 secret key\n- ENV: 与 `cli 发布` 的 `.env.local` 文件内容相同\n\n配置完成后，每次 main 分支提交代码就会自动发布到 CloudBase\n\n发布进度可在仓库 `Actions` 中看到\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhal-wang%2Fwedding-card","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhal-wang%2Fwedding-card","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhal-wang%2Fwedding-card/lists"}