feat(mall): address book wave 7 frontend, contract, and archive

Live addresses domain for the mall: shared contract (AddressBookEntry +
five client methods), mock adapter state v3, live domain pick, addresses
page CRUD, checkout saved-address picker with manual fallback, demo seed,
and the archived change plus address-book capability spec.
This commit is contained in:
Chengdong Zhang
2026-09-18 16:00:05 +08:00
parent 5e866d08f4
commit c51e96ae41
17 changed files with 467 additions and 88 deletions
+71 -25
View File
@@ -1,8 +1,6 @@
<script setup lang="ts">
import { t as pick } from "@vmall/shared";
import type { Address, CartItem, LocalizedText } from "@vmall/shared";
import { MOCK_ADDRESSES } from "~/mock/data";
import type { MockAddress } from "~/mock/data";
import type { Address, AddressBookEntry, CartItem, LocalizedText } from "@vmall/shared";
type CheckoutGroup = {
shopId: string;
@@ -20,12 +18,24 @@ const router = useRouter();
const pendingOrderIds = useState<string[]>("checkout-orders", () => []);
const items = ref<CartItem[]>([]);
const selectedAddressId = ref(MOCK_ADDRESSES.find((address) => address.isDefault)?.id ?? MOCK_ADDRESSES[0]?.id ?? "");
const addresses = ref<AddressBookEntry[]>([]);
const selectedAddressId = ref("");
const remark = ref("");
const loading = ref(true);
const submitting = ref(false);
const error = ref("");
// Inline manual form, used only when the customer has no saved address.
const manual = reactive<Address>({
recipient: "",
phone: "",
country: "US",
region: "",
city: "",
line1: "",
postal_code: "",
});
const stepLabels = computed(() => [
t("checkout.steps.cart"),
t("checkout.steps.order"),
@@ -33,10 +43,6 @@ const stepLabels = computed(() => [
t("checkout.steps.complete"),
]);
const selectedAddress = computed<MockAddress | null>(
() => MOCK_ADDRESSES.find((address) => address.id === selectedAddressId.value) ?? null,
);
// Grouped by the cart line's own shop, which the cart API returns.
const groups = computed<CheckoutGroup[]>(() => {
const grouped = new Map<string, CheckoutGroup>();
@@ -61,24 +67,36 @@ function imageFor(item: CartItem): string {
return item.image ?? "/mock/product-1.svg";
}
function toAddress(address: MockAddress): Address {
return {
recipient: address.recipient,
phone: address.phone,
country: "US",
region: address.region,
city: address.city,
line1: address.line1,
postal_code: address.postalCode,
};
function selectedAddress(): Address | null {
const saved = addresses.value.find((a) => a.id === selectedAddressId.value);
if (saved) {
return {
recipient: saved.recipient,
phone: saved.phone,
country: saved.country,
region: saved.region,
city: saved.city,
line1: saved.line1,
postal_code: saved.postal_code,
};
}
if (addresses.value.length > 0) return null;
// Manual fallback: every required field must be filled.
if (!manual.recipient || !manual.phone || !manual.country || !manual.city || !manual.line1) {
return null;
}
return { ...manual };
}
async function loadCart(): Promise<void> {
loading.value = true;
error.value = "";
try {
const snapshot = await $api.getCart();
const [snapshot, list] = await Promise.all([$api.getCart(), $api.listMyAddresses()]);
items.value = snapshot.items;
addresses.value = list;
selectedAddressId.value =
list.find((address) => address.is_default)?.id ?? list[0]?.id ?? "";
if (items.value.length === 0) {
await router.replace("/cart");
}
@@ -90,11 +108,15 @@ async function loadCart(): Promise<void> {
}
async function submitOrder(): Promise<void> {
if (!selectedAddress.value || items.value.length === 0) return;
const address = selectedAddress();
if (!address || items.value.length === 0) {
error.value = t("checkout.addressRequired");
return;
}
submitting.value = true;
error.value = "";
try {
const orders = await $api.checkout(toAddress(selectedAddress.value), currency.value);
const orders = await $api.checkout(address, currency.value);
pendingOrderIds.value = orders.map((order) => order.id);
const snapshot = await $api.getCart();
items.value = snapshot.items;
@@ -122,9 +144,9 @@ onMounted(() => void loadCart());
<template v-if="!loading && items.length > 0">
<section class="mpanel address-panel">
<h2 class="section-title">{{ t("checkout.address") }}</h2>
<div class="address-list">
<div v-if="addresses.length > 0" class="address-list">
<label
v-for="address in MOCK_ADDRESSES"
v-for="address in addresses"
:key="address.id"
class="address-option"
:class="{ selected: address.id === selectedAddressId }"
@@ -133,11 +155,23 @@ onMounted(() => void loadCart());
<span class="address-main">
<strong>{{ address.recipient }}</strong>
<span>{{ address.phone }}</span>
<span>{{ address.region }} {{ address.city }} {{ address.line1 }} {{ address.postalCode }}</span>
<span>{{ address.region }} {{ address.city }} {{ address.line1 }} {{ address.postal_code }}</span>
</span>
<span v-if="address.isDefault" class="default-tag">{{ t("checkout.defaultAddress") }}</span>
<span v-if="address.is_default" class="default-tag">{{ t("checkout.defaultAddress") }}</span>
</label>
</div>
<div v-else class="manual-form">
<p class="muted">{{ t("checkout.noSavedAddress") }}</p>
<div class="manual-grid">
<input v-model.trim="manual.recipient" class="minput" type="text" :placeholder="t('user.recipient')" />
<input v-model.trim="manual.phone" class="minput" type="text" :placeholder="t('user.phone')" />
<input v-model.trim="manual.country" class="minput" type="text" :placeholder="t('user.country')" />
<input v-model.trim="manual.region" class="minput" type="text" :placeholder="t('user.region')" />
<input v-model.trim="manual.city" class="minput" type="text" :placeholder="t('user.city')" />
<input v-model.trim="manual.postal_code" class="minput" type="text" :placeholder="t('user.postalCode')" />
<input v-model.trim="manual.line1" class="minput span-2" type="text" :placeholder="t('user.line1')" />
</div>
</div>
</section>
<section class="mpanel order-panel">
@@ -243,6 +277,18 @@ onMounted(() => void loadCart());
.address-main span:last-child {
color: var(--mall-muted);
}
.manual-form {
padding: 8px 18px 16px;
}
.manual-grid {
display: grid;
grid-template-columns: repeat(3, minmax(0, 1fr));
gap: 10px;
margin-top: 10px;
}
.manual-grid .span-2 {
grid-column: span 2;
}
.default-tag {
color: var(--mall-red);
font-size: 12px;
+95 -55
View File
@@ -1,39 +1,66 @@
<script setup lang="ts">
import type { MockAddress } from "~/mock/data";
import { MOCK_ADDRESSES } from "~/mock/data";
import type { AddressBookEntry, AddressInput } from "@vmall/shared";
definePageMeta({ middleware: "auth" });
const { t } = useI18n();
const { $api } = useNuxtApp();
const rows = ref<MockAddress[]>(MOCK_ADDRESSES.map((address) => ({ ...address })));
const rows = ref<AddressBookEntry[]>([]);
const loading = ref(true);
const open = ref(false);
const saving = ref(false);
const editingId = ref<string | null>(null);
const form = reactive<MockAddress>({
id: "",
interface AddressForm {
recipient: string;
phone: string;
country: string;
region: string;
city: string;
line1: string;
postal_code: string;
is_default: boolean;
}
const form = reactive<AddressForm>({
recipient: "",
phone: "",
country: "US",
region: "",
city: "",
line1: "",
postalCode: "",
isDefault: false,
postal_code: "",
is_default: false,
});
const errorKey = ref("");
const modalTitle = computed(() => (editingId.value ? t("user.editAddress") : t("user.addAddress")));
async function load(): Promise<void> {
loading.value = true;
errorKey.value = "";
try {
rows.value = await $api.listMyAddresses();
} catch {
errorKey.value = "user.loadFailed";
} finally {
loading.value = false;
}
}
onMounted(() => void load());
function resetForm(): void {
form.id = "";
form.recipient = "";
form.phone = "";
form.country = "US";
form.region = "";
form.city = "";
form.line1 = "";
form.postalCode = "";
form.isDefault = false;
form.postal_code = "";
form.is_default = false;
errorKey.value = "";
}
@@ -43,61 +70,67 @@ function openAdd(): void {
open.value = true;
}
function openEdit(row: MockAddress): void {
function openEdit(row: AddressBookEntry): void {
editingId.value = row.id;
form.id = row.id;
form.recipient = row.recipient;
form.phone = row.phone;
form.country = row.country;
form.region = row.region;
form.city = row.city;
form.line1 = row.line1;
form.postalCode = row.postalCode;
form.isDefault = row.isDefault;
form.postal_code = row.postal_code;
form.is_default = row.is_default;
errorKey.value = "";
open.value = true;
}
function setDefault(id: string): void {
rows.value = rows.value.map((row) => ({ ...row, isDefault: row.id === id }));
async function setDefault(id: string): Promise<void> {
try {
await $api.setDefaultAddress(id);
await load();
} catch {
errorKey.value = "user.saveFailed";
}
}
function save(): void {
if (!form.recipient || !form.phone || !form.region || !form.city || !form.line1 || !form.postalCode) {
async function remove(row: AddressBookEntry): Promise<void> {
try {
rows.value = await $api.deleteAddress(row.id);
} catch {
errorKey.value = "user.saveFailed";
}
}
async function save(): Promise<void> {
if (!form.recipient || !form.phone || !form.country || !form.region || !form.city || !form.line1 || !form.postal_code) {
errorKey.value = "user.validationRequired";
return;
}
if (editingId.value) {
rows.value = rows.value.map((row) =>
row.id === editingId.value
? {
...row,
recipient: form.recipient,
phone: form.phone,
region: form.region,
city: form.city,
line1: form.line1,
postalCode: form.postalCode,
isDefault: form.isDefault,
}
: form.isDefault
? { ...row, isDefault: false }
: row,
);
} else {
const nextId = `a-local-${Date.now()}`;
const next: MockAddress = {
id: nextId,
recipient: form.recipient,
phone: form.phone,
region: form.region,
city: form.city,
line1: form.line1,
postalCode: form.postalCode,
isDefault: form.isDefault,
};
rows.value = [next, ...rows.value.map((row) => ({ ...row, isDefault: form.isDefault ? false : row.isDefault }))];
const input: AddressInput = {
recipient: form.recipient,
phone: form.phone,
country: form.country,
region: form.region,
city: form.city,
line1: form.line1,
postal_code: form.postal_code,
is_default: form.is_default,
};
saving.value = true;
errorKey.value = "";
try {
if (editingId.value) {
await $api.updateAddress(editingId.value, input);
} else {
await $api.createAddress(input);
}
open.value = false;
await load();
} catch {
errorKey.value = "user.saveFailed";
} finally {
saving.value = false;
}
open.value = false;
}
</script>
@@ -107,12 +140,13 @@ function save(): void {
{{ t("user.addresses") }}
<button class="mbtn red" type="button" @click="openAdd">{{ t("user.addAddress") }}</button>
</h1>
<UiEmptyState v-if="rows.length === 0" :text="t('user.noAddresses')" />
<UiEmptyState v-if="!loading && rows.length === 0" :text="t('user.noAddresses')" />
<table v-else class="mtable">
<thead>
<tr>
<th>{{ t("user.recipient") }}</th>
<th>{{ t("user.phone") }}</th>
<th>{{ t("user.country") }}</th>
<th>{{ t("user.region") }}</th>
<th>{{ t("user.city") }}</th>
<th>{{ t("user.line1") }}</th>
@@ -125,16 +159,18 @@ function save(): void {
<tr v-for="row in rows" :key="row.id">
<td>{{ row.recipient }}</td>
<td>{{ row.phone }}</td>
<td>{{ row.country }}</td>
<td>{{ row.region }}</td>
<td>{{ row.city }}</td>
<td>{{ row.line1 }}</td>
<td>{{ row.postalCode }}</td>
<td>{{ row.postal_code }}</td>
<td>
<span v-if="row.isDefault" class="default-tag">{{ t("user.defaultAddress") }}</span>
<span v-if="row.is_default" class="default-tag">{{ t("user.defaultAddress") }}</span>
<button v-else class="mbtn" type="button" @click="setDefault(row.id)">{{ t("user.setDefault") }}</button>
</td>
<td>
<button class="mbtn" type="button" @click="openEdit(row)">{{ t("common.edit") }}</button>
<button class="mbtn" type="button" @click="remove(row)">{{ t("common.delete") }}</button>
</td>
</tr>
</tbody>
@@ -150,6 +186,10 @@ function save(): void {
<span>{{ t("user.phone") }}</span>
<input v-model.trim="form.phone" class="minput" type="text" />
</label>
<label>
<span>{{ t("user.country") }}</span>
<input v-model.trim="form.country" class="minput" type="text" />
</label>
<label>
<span>{{ t("user.region") }}</span>
<input v-model.trim="form.region" class="minput" type="text" />
@@ -164,17 +204,17 @@ function save(): void {
</label>
<label>
<span>{{ t("user.postalCode") }}</span>
<input v-model.trim="form.postalCode" class="minput" type="text" />
<input v-model.trim="form.postal_code" class="minput" type="text" />
</label>
<label class="checkbox">
<input v-model="form.isDefault" type="checkbox" />
<input v-model="form.is_default" type="checkbox" />
<span>{{ t("user.defaultAddress") }}</span>
</label>
</div>
<p v-if="errorKey" class="error">{{ t(errorKey) }}</p>
<template #footer>
<button class="mbtn" type="button" @click="open = false">{{ t("common.cancel") }}</button>
<button class="mbtn red" type="button" @click="save">{{ t("user.saveAddress") }}</button>
<button class="mbtn red" type="button" :disabled="saving" @click="save">{{ t("user.saveAddress") }}</button>
</template>
</UiModal>
</section>