Skip to content

Commit 0280c95

Browse files
FredFred
authored andcommitted
Strengthen project signals and homepage links
1 parent eceb973 commit 0280c95

6 files changed

Lines changed: 56 additions & 13 deletions

README.md

Lines changed: 46 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,51 @@
1-
# 美国地址生成器 MVP
1+
# Global Address Generator
22

3-
这是一个独立静态网站,直接打开 `index.html` 就能使用。
3+
[Global Address Generator](https://global-address.com/) is a free browser-based
4+
tool for generating synthetic address test data. It supports country-specific
5+
address formats, local sample names and phone numbers, copying, and CSV export.
46

5-
## 功能
7+
The generated records are intended for form testing, product prototypes,
8+
software demos, localization checks, and QA workflows. They are not guaranteed
9+
to be real or deliverable addresses.
610

7-
- 随机生成美国格式地址
8-
- 支持按州筛选
9-
- 支持生成 1 到 20 条
10-
- 支持复制单条、复制全部
11-
- 支持导出 CSV
12-
- 已上线基础静态页面,支持后续继续扩展内容页和站点设置
11+
## Supported generators
1312

14-
## 文件
13+
- United States addresses with state filtering and ZIP Code formats
14+
- Japanese addresses with prefectures, municipalities, chome, building names,
15+
and room numbers
16+
- United Kingdom addresses with post towns and postcodes
17+
- South Korean road-name addresses
18+
- Major European Union country formats
19+
- Major Southeast Asian country formats
1520

16-
- `index.html`:页面结构
17-
- `styles.css`:视觉样式
18-
- `app.js`:地址生成逻辑
21+
## QA and documentation
22+
23+
- [Address generator](https://global-address.com/)
24+
- [Address QA Lab](https://global-address.com/address-qa-lab)
25+
- [Address knowledge center](https://global-address.com/guides)
26+
- [English guides](https://global-address.com/en/guides)
27+
- [Data and testing methodology](https://global-address.com/data-methodology)
28+
29+
The QA Lab can generate reproducible test cases with inputs, execution steps,
30+
expected results, and failure risks. The knowledge center documents address
31+
fields, postal formats, international form design, and safe use of synthetic
32+
test data.
33+
34+
## Local development
35+
36+
This is a static site with Cloudflare Pages middleware. The main interface can
37+
be opened from `index.html`. Before publishing changes, run:
38+
39+
```bash
40+
node scripts/seo-regression.mjs
41+
```
42+
43+
The regression check protects canonical homepage redirects, indexability, and
44+
the canonical homepage entry in the sitemap.
45+
46+
## Responsible use
47+
48+
Do not use generated records for real deliveries, identity verification,
49+
financial applications, misleading registrations, or attempts to bypass
50+
platform rules. Use official provider sandbox data for payment, tax, fraud, and
51+
shipping validation.

form-testing-address-data.html

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,8 @@ <h2>不要只测试前端提交</h2>
104104

105105
<p class="notice">随机地址适合验证字段与界面,不适合测试真实投递、税费、支付风控或身份验证结果。这些流程应使用服务商官方沙盒数据。</p>
106106

107+
<p>开始测试前,可从<a href="./">多国地址生成器</a>选择目标国家并生成正常值,再把本页矩阵中的边界条件加入固定回归用例。</p>
108+
107109
<p><a href="./guides">返回地址知识中心</a></p>
108110
</article>
109111
</main>

japan-address-format.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,7 @@ <h2>日本地址表单测试清单</h2>
135135

136136
<h2>生成日本测试地址</h2>
137137
<p>可以使用<a href="./japan-address-generator">日本地址随机生成器</a>生成包含本地姓名、电话号码、邮政编码、都道府县、丁目番地号、建物名和房间号的测试样例。生成结果只适合表单、原型、演示和本地化 QA,不保证真实或可投递。</p>
138+
<p>还需要比较美国、英国、韩国或其他国家字段时,可返回<a href="./">多国地址生成器</a>选择对应格式。</p>
138139
</article>
139140
</main>
140141

random-address-use-cases.html

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,6 +91,8 @@ <h2>不适合的场景</h2>
9191
随机地址不适合用于真实收件、身份验证、绕过平台规则、误导性注册或任何需要真实地址证明的流程。如果系统涉及付款、税费、风控或物流履约,应使用对应平台的官方测试数据。
9292
</p>
9393

94+
<p>用于合规测试和产品演示时,可以从<a href="./">地址生成器</a>按国家准备样例,再把发现的失败场景保存为固定回归数据。</p>
95+
9496
<p><a href="./guides">返回地址知识中心</a></p>
9597
</article>
9698
</main>

us-address-format.html

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,9 @@ <h2>测试地址的边界</h2>
9898
<p>
9999
本网站生成的是测试数据。它适合检查页面布局、字段校验、复制导出和数据展示,不适合用于真实收件、身份验证或任何需要真实地址的场景。
100100
</p>
101+
<p>
102+
需要准备多组样例时,可以打开<a href="./">地址生成器</a>选择美国,并结合本页字段顺序检查州缩写、ZIP Code 和 Address Line 2。
103+
</p>
101104
</article>
102105
</main>
103106

us-zip-code-guide.html

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,8 @@ <h2>使用建议</h2>
9494
本站生成的 ZIP Code 适合界面展示、字段校验和测试数据占位,不适合判断真实配送范围、税费、风控或身份验证结果。
9595
</p>
9696

97+
<p>如需检查不同州和城市的五位邮编显示,可通过<a href="./">地址生成器首页</a>进入美国生成器准备测试样例。</p>
98+
9799
<p><a href="./guides">返回地址知识中心</a></p>
98100
</article>
99101
</main>

0 commit comments

Comments
 (0)