From 90f75d41ae63d4bcddd13ac182444e022ad7fad4 Mon Sep 17 00:00:00 2001
From: 3452078359-xuexue <3452078359@qq.com>
Date: Wed, 26 Aug 2026 02:26:24 -0700
Subject: [PATCH] fix: bind knowledge maps to explicit regions

---
 admin-web/src/ProjectLanding.tsx              |  52 +++-
 admin-web/src/api.ts                          |   4 +
 admin-web/src/panels/plaza/PlazaOverview.tsx  |  58 +++-
 .../src/panels/plaza/SuperAgentPanel.tsx      | 256 +++++++---------
 admin-web/src/spatialMapRegions.ts            |  43 +++
 admin-web/src/styles.css                      |  15 +-
 admin-web/tests/knowledgeMapTemplate.test.ts  |  42 +++
 app/api/plaza.py                              | 161 +++++++---
 app/project_lifecycle.py                      | 110 ++++++-
 design-qa.md                                  |  21 ++
 scripts/export_city_map_bundle.py             | 285 ++++++++++++++++++
 scripts/export_graph_snapshot_bundle.py       |   8 +
 .../export_yunyou_libo_full_graph_bundle.py   | 226 ++++++++++----
 tests/test_plaza_graph_fallback.py            |  37 +++
 tests/test_project_lifecycle.py               |  83 ++++-
 15 files changed, 1126 insertions(+), 275 deletions(-)
 create mode 100644 admin-web/src/spatialMapRegions.ts
 create mode 100644 admin-web/tests/knowledgeMapTemplate.test.ts
 create mode 100644 scripts/export_city_map_bundle.py
 create mode 100644 scripts/export_graph_snapshot_bundle.py

diff --git a/admin-web/src/ProjectLanding.tsx b/admin-web/src/ProjectLanding.tsx
index 2359c58..f24bb97 100644
--- a/admin-web/src/ProjectLanding.tsx
+++ b/admin-web/src/ProjectLanding.tsx
@@ -10,6 +10,7 @@ import {
   Input,
   List,
   Modal,
+  Select,
   Space,
   Spin,
   Steps,
@@ -47,6 +48,11 @@ import {
   type ProjectSummary,
   type GraphReleaseSummary,
 } from "./api";
+import {
+  SPATIAL_MAP_REGIONS,
+  spatialMapConfigForRegion,
+  spatialMapRegionByAdcode,
+} from "./spatialMapRegions";
 import {
   mergeProjectCatalogItem,
   notifyProjectCatalogChanged,
@@ -59,6 +65,7 @@ type BasicProjectValues = {
   project_id: string;
   display_name: string;
   map_enabled: boolean;
+  map_region_adcode?: string;
 };
 
 type GraphImportData = {
@@ -659,6 +666,7 @@ export default function ProjectLanding() {
   const [deleting, setDeleting] = useState(false);
 
   const [basicForm] = Form.useForm<BasicProjectValues>();
+  const mapEnabled = Form.useWatch("map_enabled", basicForm);
   const [renameForm] = Form.useForm<{ display_name: string }>();
   const impactRequest = useRef(0);
   const navigate = useNavigate();
@@ -747,6 +755,9 @@ export default function ProjectLanding() {
       project_id: values.project_id.trim(),
       display_name: values.display_name.trim(),
       map_enabled: Boolean(values.map_enabled),
+      map_region_adcode: values.map_enabled
+        ? String(values.map_region_adcode || "").trim()
+        : undefined,
     };
     setCheckingBasics(true);
     try {
@@ -855,10 +866,10 @@ export default function ProjectLanding() {
       const { data } = await provisionGraphProject({
         project_id: basicValues.project_id,
         display_name: basicValues.display_name,
-        spatial_map: {
-          enabled: basicValues.map_enabled,
-          scope: "libo",
-        },
+        spatial_map: spatialMapConfigForRegion(
+          basicValues.map_enabled,
+          basicValues.map_region_adcode,
+        ),
         schema: schemaResult.value,
         graph_data: graphResult.value,
       });
@@ -1116,10 +1127,30 @@ export default function ProjectLanding() {
             </Form.Item>
           </div>
           <div className="project-map-option">
-            <Text strong>知识地图</Text>
-            <Form.Item name="map_enabled" valuePropName="checked" noStyle>
-              <Switch checkedChildren="显示" unCheckedChildren="不显示" />
-            </Form.Item>
+            <div className="project-map-option-header">
+              <Text strong>知识地图</Text>
+              <Form.Item name="map_enabled" valuePropName="checked" noStyle>
+                <Switch checkedChildren="显示" unCheckedChildren="不显示" />
+              </Form.Item>
+            </div>
+            {mapEnabled && (
+              <Form.Item
+                label="地图区域"
+                name="map_region_adcode"
+                rules={[{ required: true, message: "请选择地图区域" }]}
+                className="project-map-region"
+              >
+                <Select
+                  showSearch
+                  optionFilterProp="label"
+                  placeholder="请选择省、市或区县"
+                  options={SPATIAL_MAP_REGIONS.map((region) => ({
+                    value: region.adcode,
+                    label: region.label,
+                  }))}
+                />
+              </Form.Item>
+            )}
           </div>
           <Alert
             type="info"
@@ -1234,6 +1265,11 @@ export default function ProjectLanding() {
           <Descriptions.Item label="知识地图" span={2}>
             {basicValues?.map_enabled ? "显示" : "不显示"}
           </Descriptions.Item>
+          {basicValues?.map_enabled && (
+            <Descriptions.Item label="地图区域" span={2}>
+              {spatialMapRegionByAdcode(basicValues.map_region_adcode)?.name || "-"}
+            </Descriptions.Item>
+          )}
         </Descriptions>
         <Alert
           type="warning"
diff --git a/admin-web/src/api.ts b/admin-web/src/api.ts
index 4a5e35c..d8afabd 100644
--- a/admin-web/src/api.ts
+++ b/admin-web/src/api.ts
@@ -143,10 +143,14 @@ export type ProjectSummary = {
 };
 
 export type SpatialMapScope = "libo" | "guizhou";
+export type SpatialMapRegionLevel = "province" | "city" | "district";
 
 export type SpatialMapConfig = {
   enabled: boolean;
   scope: SpatialMapScope;
+  region_name: string;
+  region_adcode: string;
+  region_level: SpatialMapRegionLevel;
 };
 
 export type GraphReleaseSummary = {
diff --git a/admin-web/src/panels/plaza/PlazaOverview.tsx b/admin-web/src/panels/plaza/PlazaOverview.tsx
index 8b7f530..ce9ca22 100644
--- a/admin-web/src/panels/plaza/PlazaOverview.tsx
+++ b/admin-web/src/panels/plaza/PlazaOverview.tsx
@@ -16,7 +16,7 @@ import {
   type ProjectSummary,
   type SpatialMapConfig,
 } from "../../api";
-import SuperAgentPanel, { KnowledgeMap, type CoverageSnapshot } from "./SuperAgentPanel";
+import { KnowledgeMap, type CoverageSnapshot } from "./SuperAgentPanel";
 import {
   buildGenericGraphCategories,
   resolveOverviewCategoryView,
@@ -81,19 +81,49 @@ const resolveSpatialMap = (
   context: KgProjectContext,
 ): SpatialMapConfig => {
   const configured = project?.metadata_jsonb?.spatial_map;
+  const legacyLiboProject = isLiboContext(context);
+  const legacyCityProject = context.graphName === DEFAULT_PROJECT_CONTEXT.graphName
+    || context.projectId === DEFAULT_PROJECT_CONTEXT.projectId;
+  const fallback = legacyLiboProject
+    ? {
+        scope: "libo" as const,
+        region_name: "荔波县",
+        region_adcode: "522722",
+        region_level: "district" as const,
+      }
+    : legacyCityProject
+      ? {
+          scope: "guizhou" as const,
+          region_name: "贵阳市",
+          region_adcode: "520100",
+          region_level: "city" as const,
+        }
+      : {
+          scope: "guizhou" as const,
+          region_name: "贵州省",
+          region_adcode: "520000",
+          region_level: "province" as const,
+        };
   if (configured && typeof configured.enabled === "boolean") {
+    const regionAdcode = String(configured.region_adcode || fallback.region_adcode);
     return {
       enabled: configured.enabled,
-      scope: configured.scope === "guizhou" ? "guizhou" : "libo",
+      scope: regionAdcode === "522722" ? "libo" : "guizhou",
+      region_name: String(configured.region_name || fallback.region_name),
+      region_adcode: regionAdcode,
+      region_level: configured.region_level === "province"
+        || configured.region_level === "city"
+        || configured.region_level === "district"
+        ? configured.region_level
+        : fallback.region_level,
     };
   }
 
   // Compatibility only: projects created before the explicit map option did
   // not persist this capability.  New projects never depend on their id/name.
-  const legacyLiboProject = isLiboContext(context);
   return {
-    enabled: legacyLiboProject,
-    scope: legacyLiboProject ? "libo" : "guizhou",
+    enabled: legacyLiboProject || legacyCityProject,
+    ...fallback,
   };
 };
 
@@ -129,12 +159,11 @@ export default function PlazaOverview() {
         : [];
       const currentProject = projects.find((project) => project.project_id === currentContext.projectId) || null;
       const currentSpatialMap = resolveSpatialMap(currentProject, currentContext);
-      const isCityProject = currentContext.graphName === DEFAULT_PROJECT_CONTEXT.graphName;
-      const isKnowledgeMapProject = isCityProject || currentSpatialMap.enabled;
+      const isKnowledgeMapProject = currentSpatialMap.enabled;
       const placeTypeRows = isKnowledgeMapProject && currentGraphData.connected === true
         ? await graphQuery(GRAPH_CATEGORY_CYPHER).then((res) => res.data.rows || []).catch(() => [])
         : [];
-      const coverage = currentSpatialMap.enabled
+      const coverage = currentContext.graphName === DEFAULT_PROJECT_CONTEXT.graphName
         ? await superAgentCoverage().then((res) => res.data).catch(() => null)
         : null;
       setProjectContextState(currentContext);
@@ -189,8 +218,17 @@ export default function PlazaOverview() {
     <div>
       <h2>{pageTitle}</h2>
 
-      {isCityProject && <SuperAgentPanel />}
-      {isKnowledgeMapProject && <KnowledgeMap cov={mapCoverage} scope={spatialMap.scope} />}
+      {isKnowledgeMapProject && (
+        <KnowledgeMap
+          cov={mapCoverage}
+          projectId={projectContext.projectId}
+          projectName={projectSummary?.display_name || projectSummary?.name || projectContext.projectId}
+          scope={spatialMap.scope}
+          regionName={spatialMap.region_name}
+          regionAdcode={spatialMap.region_adcode}
+          regionLevel={spatialMap.region_level}
+        />
+      )}
 
       {/* Stat cards */}
       <Row gutter={16} style={{ marginBottom: 24 }}>
diff --git a/admin-web/src/panels/plaza/SuperAgentPanel.tsx b/admin-web/src/panels/plaza/SuperAgentPanel.tsx
index 5119fdc..8cd8988 100644
--- a/admin-web/src/panels/plaza/SuperAgentPanel.tsx
+++ b/admin-web/src/panels/plaza/SuperAgentPanel.tsx
@@ -52,8 +52,10 @@ type MapPoi = {
   lng: number;
   lat: number;
   address: string;
+  province?: string;
   district: string;
   city: string;
+  adcode?: string;
   towncode?: string;
   town_name?: string;
   zone_id?: string;
@@ -215,18 +217,8 @@ const DIANPING_APP_ICON_URL =
 const poiCategoryColor = (category?: string) =>
   POI_CATEGORY_COLORS[category || ""] || "#597ef7";
 
-// 高德式搜索面板的分类快捷入口图标（按用户提供的 logo：披萨/酒店/城堡/出租车）。
-const POI_CATEGORY_EMOJI: Record<string, string> = {
-  美食: "🍕",
-  酒店: "🏨",
-  交通设施: "🚕",
-  景点: "🎡",
-};
-const poiCategoryEmoji = (category?: string) =>
-  POI_CATEGORY_EMOJI[category || ""] || "📍";
-
-// 分类快捷入口的自定义 logo 图片（放 admin-web/public/category-icons/ 即生效）。
-// 已预接路径：图片存在→<img> 显示插画；不存在→onError 自动回退到上面的 emoji。
+// 分类快捷入口的自定义图片；未配置的动态业态使用现有 Ant 图标库，
+// 保证所有地图项目共用同一套模板时不会出现缺图或表情符号占位。
 // ?v=N 作为缓存刷新戳：换了图标就把 N +1，强制浏览器重新拉取（否则同名文件走旧缓存）。
 const CATEGORY_ICON_VER = "3";
 const POI_CATEGORY_ICON: Record<string, string> = {
@@ -237,8 +229,7 @@ const POI_CATEGORY_ICON: Record<string, string> = {
 };
 const poiCategoryIcon = (category?: string) =>
   POI_CATEGORY_ICON[category || ""] || "";
-
-const LIBO_RECENT_SEARCH_KEY = "znkg:libo-poi-recent";
+const MAP_SHORTCUT_CATEGORIES = ["美食", "酒店", "景点", "交通设施"] as const;
 
 /** 荔波县实时天气（高德 AMap.Weather 插件返回，getLive + getForecast 合成）。 */
 type LiboWeather = {
@@ -2010,24 +2001,22 @@ const loadAmapSdk = (jsKey: string, securityJsCode?: string) => {
   return amapSdkPromise;
 };
 
-const GUIZHOU_CITIES = [
-  { name: "贵阳", coord: [106.6302, 26.6470], active: true },
-  { name: "遵义", coord: [106.9373, 27.7066] },
-  { name: "六盘水", coord: [104.8304, 26.5934] },
-  { name: "安顺", coord: [105.9476, 26.2531] },
-  { name: "毕节", coord: [105.2916, 27.2836] },
-  { name: "铜仁", coord: [109.1916, 27.7183] },
-  { name: "黔东南", coord: [107.9829, 26.5834] },
-  { name: "黔南", coord: [107.5170, 26.2582] },
-  { name: "黔西南", coord: [104.9064, 25.0878] },
-];
-
 export function KnowledgeMap({
-  cov,
+  cov = null,
   scope = "guizhou",
+  projectId = "default",
+  projectName = "当前项目",
+  regionName = "贵州省",
+  regionAdcode = "520000",
+  regionLevel = "province",
 }: {
-  cov: CoverageSnapshot | null;
+  cov?: CoverageSnapshot | null;
   scope?: "guizhou" | "libo";
+  projectId?: string;
+  projectName?: string;
+  regionName?: string;
+  regionAdcode?: string;
+  regionLevel?: "province" | "city" | "district";
 }) {
   const mapRef = useRef<HTMLDivElement | null>(null);
   const mapShellRef = useRef<HTMLDivElement | null>(null);
@@ -2060,11 +2049,12 @@ export function KnowledgeMap({
   // 底图图层：标准 / 卫星影像 + 可叠加实时路况
   const [satelliteOn, setSatelliteOn] = useState(false);
   const [trafficOn, setTrafficOn] = useState(false);
-  // 自定义分类 logo 加载失败（文件未放）时回退 emoji 的记录。
+  // 自定义分类图片加载失败时，回退到项目现有的 Ant 图标库。
   const [catIconErr, setCatIconErr] = useState<Record<string, boolean>>({});
+  const recentSearchKey = `znkg:map-poi-recent:${projectId || "default"}`;
   const [recentSearches, setRecentSearches] = useState<MapPoi[]>(() => {
     try {
-      const raw = localStorage.getItem(LIBO_RECENT_SEARCH_KEY);
+      const raw = localStorage.getItem(recentSearchKey);
       return raw ? (JSON.parse(raw) as MapPoi[]) : [];
     } catch {
       return [];
@@ -2091,8 +2081,19 @@ export function KnowledgeMap({
   const [zonePickerOpen, setZonePickerOpen] = useState(false);
   const [selectedTowncode, setSelectedTowncode] = useState("");
   const [selectedZoneId, setSelectedZoneId] = useState("");
-  const isLibo = scope === "libo";
+  const isLibo = scope === "libo" || regionAdcode === LIBO_ADCODE;
   const isFullscreen = fullscreenMode !== "none";
+  const activeRegionName = isLibo ? "荔波县" : regionName;
+  const mapTitle = isLibo ? "贵州省荔波县知识地图" : `${activeRegionName}知识地图`;
+
+  useEffect(() => {
+    try {
+      const raw = localStorage.getItem(recentSearchKey);
+      setRecentSearches(raw ? (JSON.parse(raw) as MapPoi[]) : []);
+    } catch {
+      setRecentSearches([]);
+    }
+  }, [recentSearchKey]);
 
   const selectedTown = useMemo(
     () => zoneTowns.find((town) => town.towncode === selectedTowncode) || null,
@@ -2108,12 +2109,28 @@ export function KnowledgeMap({
     [townZones, selectedZoneId],
   );
   /** 按行政区（法定）→ 片区（业务）逐层收窄，两套口径互不推导。 */
+  const configuredRegionPois = useMemo(() => {
+    const expected = String(regionAdcode || "").trim();
+    if (!expected) return mapPois;
+    const prefixLength = regionLevel === "province" ? 2 : regionLevel === "city" ? 4 : 6;
+    return mapPois.filter((poi) => {
+      const adcode = String(poi.adcode || "").trim();
+      if (adcode) return adcode.slice(0, prefixLength) === expected.slice(0, prefixLength);
+      const regionField = regionLevel === "province"
+        ? poi.province
+        : regionLevel === "city"
+          ? poi.city
+          : poi.district;
+      const candidate = String(regionField || "").trim();
+      return Boolean(candidate && (candidate.includes(regionName) || regionName.includes(candidate)));
+    });
+  }, [mapPois, regionAdcode, regionLevel, regionName]);
   const regionPois = useMemo(() => {
-    if (!selectedTowncode) return mapPois;
-    const inTown = mapPois.filter((poi) => poi.towncode === selectedTowncode);
+    if (!selectedTowncode) return configuredRegionPois;
+    const inTown = configuredRegionPois.filter((poi) => poi.towncode === selectedTowncode);
     if (!selectedZoneId) return inTown;
     return inTown.filter((poi) => poi.zone_id === selectedZoneId);
-  }, [mapPois, selectedTowncode, selectedZoneId]);
+  }, [configuredRegionPois, selectedTowncode, selectedZoneId]);
   const poiCategories = useMemo(() => {
     const counts = new Map<string, number>();
     regionPois.forEach((poi) => {
@@ -2126,10 +2143,8 @@ export function KnowledgeMap({
       .sort((a, b) => b.count - a.count || a.category.localeCompare(b.category, "zh-CN"));
   }, [regionPois]);
   const topCats = useMemo(
-    () => isLibo
-      ? poiCategories.slice(0, 4).map((item) => ({ cat: item.category, current: item.count }))
-      : (cov?.items || []).slice(0, 4),
-    [cov, isLibo, poiCategories],
+    () => poiCategories.slice(0, 4).map((item) => ({ cat: item.category, current: item.count })),
+    [poiCategories],
   );
   const visiblePois = useMemo(
     () => regionPois.filter((poi) => (
@@ -2282,11 +2297,6 @@ export function KnowledgeMap({
   }, [fullscreenMode]);
 
   useEffect(() => {
-    if (!isLibo) {
-      setMapPois([]);
-      setSelectedCategories([]);
-      return;
-    }
     let disposed = false;
     setPoiLoading(true);
     setPoiError("");
@@ -2311,7 +2321,7 @@ export function KnowledgeMap({
     return () => {
       disposed = true;
     };
-  }, [isLibo]);
+  }, [projectId, scope]);
 
   useEffect(() => {
     if (!isLibo) {
@@ -2479,22 +2489,22 @@ export function KnowledgeMap({
     setRecentSearches((current) => {
       const next = [poi, ...current.filter((item) => item.id !== poi.id)].slice(0, 6);
       try {
-        localStorage.setItem(LIBO_RECENT_SEARCH_KEY, JSON.stringify(next));
+        localStorage.setItem(recentSearchKey, JSON.stringify(next));
       } catch {
         // localStorage 不可用时忽略，仅内存态。
       }
       return next;
     });
-  }, [openPoi]);
+  }, [openPoi, recentSearchKey]);
 
   const clearRecentSearches = useCallback(() => {
     setRecentSearches([]);
     try {
-      localStorage.removeItem(LIBO_RECENT_SEARCH_KEY);
+      localStorage.removeItem(recentSearchKey);
     } catch {
       // 忽略。
     }
-  }, []);
+  }, [recentSearchKey]);
 
   // 点击搜索框外部关闭下拉。
   useEffect(() => {
@@ -2588,7 +2598,7 @@ export function KnowledgeMap({
         const { data } = await plazaAmapConfig();
         if (!data?.configured || !data?.js_key) {
           setMapStatus("error");
-          setMapMessage(`高德 JS API Key 未配置，无法加载${isLibo ? "荔波县" : "贵州省"}地图。`);
+          setMapMessage(`高德 JS API Key 未配置，无法加载${activeRegionName}地图。`);
           return;
         }
         const AMap = await loadAmapSdk(data.js_key, data.security_jscode);
@@ -2609,64 +2619,25 @@ export function KnowledgeMap({
         map.addControl(new AMap.Scale());
         map.addControl(new AMap.ToolBar({ position: { right: "12px", top: "56px" } }));
 
-        const cityOverlays: any[] = [];
-        if (!isLibo) {
-          GUIZHOU_CITIES.forEach((city) => {
-            const active = city.active;
-            const countText = active && cov ? `${cov.total.toLocaleString()} 条` : "待接入";
-            const marker = new AMap.CircleMarker({
-              center: city.coord,
-              radius: active ? 12 : 7,
-              strokeColor: active ? "#1677ff" : "#7aa7c7",
-              strokeWeight: active ? 3 : 1,
-              strokeOpacity: active ? 0.9 : 0.55,
-              fillColor: active ? "#16a085" : "#d8ecfb",
-              fillOpacity: active ? 0.9 : 0.65,
-              zIndex: active ? 20 : 10,
-            });
-            const label = new AMap.Text({
-              text: `${city.name} · ${countText}`,
-              position: city.coord,
-              anchor: "bottom-center",
-              offset: new AMap.Pixel(0, -12),
-              style: {
-                padding: "4px 8px",
-                borderRadius: "999px",
-                border: active ? "1px solid #1677ff" : "1px solid #d6e4ff",
-                background: active ? "rgba(255,255,255,0.96)" : "rgba(255,255,255,0.82)",
-                color: active ? "#1f2329" : "#6b7a90",
-                fontSize: "12px",
-                boxShadow: active ? "0 6px 16px rgba(22,119,255,0.16)" : "none",
-              },
-            });
-            cityOverlays.push(marker, label);
-          });
-          map.add(cityOverlays);
-        }
-
         AMap.plugin("AMap.DistrictSearch", () => {
           if (disposed || !mapInstance.current) return;
           const district = new AMap.DistrictSearch({
-            level: isLibo ? "district" : "province",
+            level: regionLevel,
             subdistrict: 0,
             extensions: "all",
           });
-          district.search(isLibo ? "522722" : "贵州省", (status: string, result: any) => {
+          district.search(regionAdcode || activeRegionName, (status: string, result: any) => {
             if (disposed) return;
             if (status !== "complete") {
-              if (isLibo) {
-                setMapStatus("error");
-                setMapMessage("荔波县行政边界查询失败，请稍后刷新重试。");
-              }
+              setMapStatus("error");
+              setMapMessage(`${activeRegionName}行政边界查询失败，请稍后刷新重试。`);
               return;
             }
             const districtItem = result?.districtList?.[0];
             const boundaries = districtItem?.boundaries || [];
             if (!boundaries.length) {
-              if (isLibo) {
-                setMapStatus("error");
-                setMapMessage("高德未返回荔波县行政边界数据。");
-              }
+              setMapStatus("error");
+              setMapMessage(`高德未返回${activeRegionName}行政边界数据。`);
               return;
             }
             const polygons = boundaries.map((path: any) => new AMap.Polygon({
@@ -2683,7 +2654,7 @@ export function KnowledgeMap({
               if (isLibo && districtItem?.center) {
                 map.setZoomAndCenter(9.5, districtItem.center);
               } else {
-                map.setFitView([...polygons, ...cityOverlays], false, [36, 28, 36, 28]);
+                map.setFitView(polygons, false, [36, 28, 36, 28]);
               }
               if (isLibo && districtItem?.center) {
                 const center = districtItem.center;
@@ -2718,7 +2689,6 @@ export function KnowledgeMap({
           });
         });
 
-        if (!isLibo) setMapStatus("ready");
       } catch (e: any) {
         setMapStatus("error");
         setMapMessage(e?.message || "高德地图加载失败");
@@ -2740,7 +2710,7 @@ export function KnowledgeMap({
       mapInstance.current = null;
       amapRef.current = null;
     };
-  }, [cov, isLibo, mapPois.length]);
+  }, [activeRegionName, isLibo, mapPois.length, projectId, regionAdcode, regionLevel]);
 
   // 荔波县实时天气：复用已加载的高德 JS SDK（AMap.Weather 插件），
   // getLive 取实时天气现象+温度，getForecast 取今日最低/最高温，合成成一张天气卡。
@@ -2854,7 +2824,7 @@ export function KnowledgeMap({
   useEffect(() => {
     const AMap = amapRef.current;
     const map = mapInstance.current;
-    if (!isLibo || mapStatus !== "ready" || !AMap || !map) return;
+    if (mapStatus !== "ready" || !AMap || !map) return;
 
     let disposed = false;
     const lookup = new Map<string, MapPoi>();
@@ -2958,7 +2928,7 @@ export function KnowledgeMap({
       clusterRef.current?.setMap?.(null);
       clusterRef.current = null;
     };
-  }, [isLibo, mapStatus, mapRenderPois]);
+  }, [mapStatus, mapRenderPois]);
 
   useEffect(() => {
     const AMap = amapRef.current;
@@ -3546,13 +3516,13 @@ export function KnowledgeMap({
       <div style={{ display: "flex", alignItems: "center", justifyContent: "space-between", gap: 12, marginBottom: 10 }}>
         <Space size={8}>
           <EnvironmentOutlined style={{ color: "#1677ff" }} />
-          <b>{isLibo ? "贵州省荔波县知识地图" : "贵州省知识地图"}</b>
+          <b>{mapTitle}</b>
           <Tag color="blue">高德 JS API</Tag>
         </Space>
         <span style={{ fontSize: 12, color: "#888" }}>
           {isLibo
             ? "当前图谱：荔波县已接入 · 突出显示荔波县行政区域"
-            : "当前图谱：贵阳已接入 · 省域底图为后续扩展预留"}
+            : `当前图谱：${projectName} · 展示当前项目空间数据`}
         </span>
       </div>
 
@@ -3574,23 +3544,16 @@ export function KnowledgeMap({
           }}
         >
           <div style={{ color: "#888", fontSize: 12, marginBottom: 4 }}>
-            {isLibo ? "荔波县馆藏汇总" : "省域馆藏汇总"}
+            {isLibo ? `${activeRegionName}馆藏汇总` : "省域馆藏汇总"}
           </div>
           <div style={{ fontSize: 28, fontWeight: 700, lineHeight: 1.15 }}>
-            {(isLibo ? regionPois.length : (cov?.total ?? 0)).toLocaleString()}
+            {(isLibo ? regionPois.length : (cov?.total ?? regionPois.length)).toLocaleString()}
           </div>
           <div style={{ color: "#888", fontSize: 12, marginTop: 4 }}>
             {isLibo && selectedTowncode
               ? `${selectedZone?.zone_name || selectedTown?.name} / 共 ${mapPois.length.toLocaleString()} 条`
               : "当前已入藏知识 / POI 条目"}
           </div>
-          {!isLibo && <div style={{ marginTop: 14 }}>
-            <Progress
-              percent={cov?.grid_overall_pct ?? 0}
-              size="small"
-              status={(cov?.grid_overall_pct ?? 0) >= 100 ? "success" : "active"}
-            />
-          </div>}
           {isLibo && (
             <div style={{ marginTop: 14 }}>
               <Tag color="green">82 个细网格采集已完成</Tag>
@@ -3609,8 +3572,8 @@ export function KnowledgeMap({
           </div>
           <div style={{ marginTop: 14, color: "#888", fontSize: 12, lineHeight: 1.7 }}>
             {isLibo
-              ? "地图正常展示荔波县及周边区域，并用蓝色边界与浅蓝填充突出荔波县主体；所有 POI 均按荔波县行政区划代码 522722 过滤。"
-              : "地图先展示贵州省边界与九市州锚点；贵阳为当前知识图谱主库，后续扩展遵义、黔东南等城市时可直接挂接同一省域画布。"}
+              ? "地图展示荔波县及周边区域，并用蓝色边界突出荔波县主体；POI 来自当前项目图谱。"
+              : "地图统一读取当前项目中包含经纬度的节点，并按真实业态分类、搜索和聚合展示。"}
           </div>
         </div>}
 
@@ -3631,8 +3594,7 @@ export function KnowledgeMap({
           }}
         >
           <div ref={mapRef} style={{ width: "100%", height: isFullscreen ? "100%" : 320 }} />
-          {isLibo && (
-            <div
+          <div
               style={{
                 position: "absolute",
                 left: 12,
@@ -3745,12 +3707,9 @@ export function KnowledgeMap({
                       )
                     ) : (
                       <>
-                        {/* 高德式快捷分类：无标题，一排大图标 + 文字，占满宽度。
-                            固定顺序与占位文字一致：美食 → 酒店 → 景点 → 交通设施。 */}
+                        {/* 用户确认的四个快捷入口及其图片属于固定模板，不随项目业态排序替换。 */}
                         <div style={{ display: "grid", gridTemplateColumns: "repeat(4, 1fr)", gap: 2 }}>
-                          {(["美食", "酒店", "景点", "交通设施"] as string[])
-                            .filter((category) => poiCategories.some((item) => item.category === category))
-                            .map((category) => {
+                          {MAP_SHORTCUT_CATEGORIES.map((category) => {
                             const iconUrl = poiCategoryIcon(category);
                             const showImg = iconUrl && !catIconErr[category];
                             return (
@@ -3776,7 +3735,21 @@ export function KnowledgeMap({
                                     style={{ display: "block", objectFit: "contain" }}
                                   />
                                 ) : (
-                                  <span style={{ fontSize: 40, lineHeight: 1, height: 46, display: "grid", placeItems: "center" }}>{poiCategoryEmoji(category)}</span>
+                                  <span
+                                    aria-hidden="true"
+                                    style={{
+                                      width: 46,
+                                      height: 46,
+                                      display: "grid",
+                                      placeItems: "center",
+                                      borderRadius: 12,
+                                      background: "#f0f5ff",
+                                      color: poiCategoryColor(category),
+                                      fontSize: 26,
+                                    }}
+                                  >
+                                    <EnvironmentOutlined />
+                                  </span>
                                 )}
                                 <span style={{ fontSize: 13, color: "#1f2329", whiteSpace: "nowrap" }}>{category}</span>
                               </div>
@@ -3859,7 +3832,7 @@ export function KnowledgeMap({
                   <div style={{ display: "flex", alignItems: "center", justifyContent: "space-between", gap: 10, marginTop: 10 }}>
                     <Space size={6}>
                       <AimOutlined style={{ color: "#1677ff" }} />
-                      <b style={{ fontSize: 13 }}>荔波POI图层</b>
+                      <b style={{ fontSize: 13 }}>{activeRegionName} POI 图层</b>
                       <Tag color="blue" style={{ marginInlineEnd: 0 }}>
                         {mapRenderPois.length.toLocaleString()} / {regionPois.length.toLocaleString()}
                       </Tag>
@@ -3901,6 +3874,8 @@ export function KnowledgeMap({
               <Divider style={{ margin: "10px 0 8px" }} />
               <div style={{ display: "flex", alignItems: "center", justifyContent: "space-between", gap: 8 }}>
                 <Space size={6} wrap>
+                  {isLibo && (
+                    <>
                   <Tag.CheckableTag
                     checked={zonePickerOpen || Boolean(selectedTowncode)}
                     onChange={(checked) => setZonePickerOpen(checked)}
@@ -3934,6 +3909,8 @@ export function KnowledgeMap({
                     <CarOutlined /> 公交图层
                   </Tag.CheckableTag>
                   {busLoading && <Spin size="small" />}
+                    </>
+                  )}
                   {/* 底图图层选择：标准 / 卫星影像 + 实时路况叠加。
                       用 span 作触发器（CheckableTag 会吞掉点击导致菜单打不开）。 */}
                   <Dropdown
@@ -3976,20 +3953,22 @@ export function KnowledgeMap({
                     </span>
                   </Dropdown>
                 </Space>
-                <Button
-                  size="small"
-                  icon={<UnorderedListOutlined />}
-                  disabled={!busRoutes.length}
-                  onClick={() => {
-                    closePoiDetail();
-                    setFocusedBusRouteId("");
-                    setBusPanel({ mode: "list" });
-                  }}
-                >
-                  线路列表
-                </Button>
+                {isLibo && (
+                  <Button
+                    size="small"
+                    icon={<UnorderedListOutlined />}
+                    disabled={!busRoutes.length}
+                    onClick={() => {
+                      closePoiDetail();
+                      setFocusedBusRouteId("");
+                      setBusPanel({ mode: "list" });
+                    }}
+                  >
+                    线路列表
+                  </Button>
+                )}
               </div>
-              {zonePickerOpen && (
+              {isLibo && zonePickerOpen && (
                 <div
                   style={{
                     marginTop: 8,
@@ -4080,7 +4059,7 @@ export function KnowledgeMap({
                   )}
                 </div>
               )}
-              <div style={{ display: "flex", flexWrap: "wrap", gap: 6, marginTop: 8 }}>
+              {isLibo && <div style={{ display: "flex", flexWrap: "wrap", gap: 6, marginTop: 8 }}>
                 {busLines.map((lineName) => {
                   const color = busLineColor(lineName);
                   const checked = focusedBusLineName === lineName;
@@ -4105,14 +4084,13 @@ export function KnowledgeMap({
                     </Tooltip>
                   );
                 })}
-              </div>
-              {busError && (
+              </div>}
+              {isLibo && busError && (
                 <div style={{ color: "#cf1322", fontSize: 12, marginTop: 6 }}>{busError}</div>
               )}
                 </>
               )}
             </div>
-          )}
           {isLibo && weather && (
             /* 高德式天气卡：紧贴搜索卡右侧；点击展开未来多日预报（数据来自高德 AMap.Weather）。 */
             <div
@@ -5021,7 +4999,7 @@ export default function SuperAgentPanel() {
         </div>
       )}
 
-      <KnowledgeMap cov={cov} />
+      <KnowledgeMap />
 
       {escalatedCats.length > 0 && (
         <Alert
diff --git a/admin-web/src/spatialMapRegions.ts b/admin-web/src/spatialMapRegions.ts
new file mode 100644
index 0000000..922e8eb
--- /dev/null
+++ b/admin-web/src/spatialMapRegions.ts
@@ -0,0 +1,43 @@
+import type { SpatialMapConfig, SpatialMapRegionLevel, SpatialMapScope } from "./api";
+
+export type SpatialMapRegionOption = {
+  adcode: string;
+  label: string;
+  level: SpatialMapRegionLevel;
+  name: string;
+  scope: SpatialMapScope;
+};
+
+// 当前平台的生产数据范围。新增城市只需要在这里补一项，项目、地图边界
+// 和导入校验都会共同读取同一份行政区配置。
+export const SPATIAL_MAP_REGIONS: SpatialMapRegionOption[] = [
+  { adcode: "520000", name: "贵州省", label: "贵州省", level: "province", scope: "guizhou" },
+  { adcode: "520100", name: "贵阳市", label: "贵阳市", level: "city", scope: "guizhou" },
+  { adcode: "520200", name: "六盘水市", label: "六盘水市", level: "city", scope: "guizhou" },
+  { adcode: "520300", name: "遵义市", label: "遵义市", level: "city", scope: "guizhou" },
+  { adcode: "520400", name: "安顺市", label: "安顺市", level: "city", scope: "guizhou" },
+  { adcode: "520500", name: "毕节市", label: "毕节市", level: "city", scope: "guizhou" },
+  { adcode: "520600", name: "铜仁市", label: "铜仁市", level: "city", scope: "guizhou" },
+  { adcode: "522300", name: "黔西南布依族苗族自治州", label: "黔西南州", level: "city", scope: "guizhou" },
+  { adcode: "522600", name: "黔东南苗族侗族自治州", label: "黔东南州", level: "city", scope: "guizhou" },
+  { adcode: "522700", name: "黔南布依族苗族自治州", label: "黔南州", level: "city", scope: "guizhou" },
+  { adcode: "522722", name: "荔波县", label: "荔波县", level: "district", scope: "libo" },
+];
+
+export const spatialMapRegionByAdcode = (adcode?: string | null) => (
+  SPATIAL_MAP_REGIONS.find((item) => item.adcode === String(adcode || "").trim()) || null
+);
+
+export const spatialMapConfigForRegion = (
+  enabled: boolean,
+  adcode?: string | null,
+): SpatialMapConfig => {
+  const region = enabled ? spatialMapRegionByAdcode(adcode) : null;
+  return {
+    enabled,
+    scope: region?.scope || "guizhou",
+    region_name: region?.name || "",
+    region_adcode: region?.adcode || "",
+    region_level: region?.level || "province",
+  };
+};
diff --git a/admin-web/src/styles.css b/admin-web/src/styles.css
index 1569a3c..9521a17 100644
--- a/admin-web/src/styles.css
+++ b/admin-web/src/styles.css
@@ -2529,10 +2529,6 @@ body { margin: 0; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Ro
 }
 
 .project-map-option {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 20px;
   margin: 2px 0 18px;
   padding: 16px 18px;
   border: 1px solid #d9e6f8;
@@ -2540,6 +2536,17 @@ body { margin: 0; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Ro
   background: #f7faff;
 }
 
+.project-map-option-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 20px;
+}
+
+.project-map-region.ant-form-item {
+  margin: 14px 0 0;
+}
+
 .project-json-step {
   display: flex;
   flex-direction: column;
diff --git a/admin-web/tests/knowledgeMapTemplate.test.ts b/admin-web/tests/knowledgeMapTemplate.test.ts
new file mode 100644
index 0000000..efe6767
--- /dev/null
+++ b/admin-web/tests/knowledgeMapTemplate.test.ts
@@ -0,0 +1,42 @@
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import test from "node:test";
+
+const overviewSource = readFileSync(
+  new URL("../src/panels/plaza/PlazaOverview.tsx", import.meta.url),
+  "utf8",
+);
+const mapSource = readFileSync(
+  new URL("../src/panels/plaza/SuperAgentPanel.tsx", import.meta.url),
+  "utf8",
+);
+const projectLandingSource = readFileSync(
+  new URL("../src/ProjectLanding.tsx", import.meta.url),
+  "utf8",
+);
+const regionsSource = readFileSync(
+  new URL("../src/spatialMapRegions.ts", import.meta.url),
+  "utf8",
+);
+
+test("every map-enabled project uses the single KnowledgeMap template", () => {
+  assert.match(overviewSource, /isKnowledgeMapProject && \(/);
+  assert.match(overviewSource, /<KnowledgeMap/);
+  assert.doesNotMatch(overviewSource, /<SuperAgentPanel/);
+});
+
+test("the shared map preserves the four approved shortcut logos and province summary", () => {
+  assert.match(mapSource, /MAP_SHORTCUT_CATEGORIES = \["美食", "酒店", "景点", "交通设施"\]/);
+  assert.match(mapSource, /MAP_SHORTCUT_CATEGORIES\.map/);
+  assert.match(mapSource, /省域馆藏汇总/);
+  assert.match(mapSource, /cov\?\.total \?\? regionPois\.length/);
+  assert.match(mapSource, /当前已入藏知识 \/ POI 条目/);
+});
+
+test("map-enabled project creation requires an explicit administrative region", () => {
+  assert.match(projectLandingSource, /name="map_region_adcode"/);
+  assert.match(projectLandingSource, /请选择地图区域/);
+  assert.match(projectLandingSource, /spatialMapConfigForRegion/);
+  assert.match(regionsSource, /adcode: "520100", name: "贵阳市"/);
+  assert.match(regionsSource, /adcode: "522722", name: "荔波县"/);
+});
diff --git a/app/api/plaza.py b/app/api/plaza.py
index 6c73ac7..407cc18 100644
--- a/app/api/plaza.py
+++ b/app/api/plaza.py
@@ -35,6 +35,29 @@ GRAPH_POI_LABELS = {
     "BusStop": "公交站",
 }
 
+# Projects imported from JSON do not have to use the historical Libo labels.
+# The city graph, for example, models every spatial business as ``Place`` and
+# stores its business type in ``place_type``. Keep this mapping in the map
+# adapter so every map-enabled project can use the same UI template.
+GRAPH_PLACE_TYPE_CATEGORIES = {
+    "eat": "美食",
+    "drink": "饮品",
+    "hotel": "酒店",
+    "mall": "商场",
+    "sight": "景点",
+    "transit": "交通设施",
+    "transit_stop": "交通设施",
+    "recreation": "体育休闲",
+    "education": "科教文化",
+    "medical": "医疗保健",
+    "government": "政府机构",
+    "enterprise": "公司企业",
+    "life": "生活服务",
+    "residential": "商务住宅",
+    "facility": "公共设施",
+    "poi": "其他地点",
+}
+
 FOOD_ENRICHMENT_KEYS = (
     "food_fusion_status",
     "food_match_confidence",
@@ -443,10 +466,12 @@ def _is_enterprise_travel_graph(graph_name: str) -> bool:
 
 
 def _resolve_spatial_graph_name(graph_name: str) -> str:
-    """Map the city project graph name to the materialized spatial POI graph."""
-    lower = graph_name.lower()
-    if graph_name == SPATIAL_GRAPH_NAME or lower.endswith("_spatial_v1"):
-        return graph_name
+    """Resolve the explicitly paired city map store used by the legacy project.
+
+    ``guiyang_new2`` is the semantic city graph while ``guiyang_spatial_v1`` is
+    its map/POI store. Other map-enabled projects keep using their own graph,
+    so imported bundles do not depend on a project-name convention.
+    """
     if graph_name == "guiyang_new2":
         return SPATIAL_GRAPH_NAME
     return graph_name
@@ -670,6 +695,24 @@ def _graph_poi_enrichment(
     return labels, pick(FOOD_ENRICHMENT_KEYS), pick(HOTEL_ENRICHMENT_KEYS)
 
 
+def _graph_poi_business_categories(
+    labels: list[str] | tuple[str, ...] | None,
+    properties: dict[str, Any],
+) -> list[str]:
+    categories = [
+        GRAPH_POI_LABELS[label]
+        for label in (labels or [])
+        if label in GRAPH_POI_LABELS
+    ]
+    type_label = str(properties.get("type_label") or "").strip()
+    place_type = str(properties.get("place_type") or "").strip().lower()
+    if type_label:
+        categories.insert(0, type_label)
+    elif place_type:
+        categories.insert(0, GRAPH_PLACE_TYPE_CATEGORIES.get(place_type, place_type))
+    return list(dict.fromkeys(category for category in categories if category))
+
+
 def _graph_poi_categories(graph_name: str) -> dict[str, list[str]]:
     db = FalkorDB(
         host=settings.falkordb_host,
@@ -677,22 +720,26 @@ def _graph_poi_categories(graph_name: str) -> dict[str, list[str]]:
     )
     try:
         graph = db.select_graph(graph_name)
-        rows = graph.query(
-            "MATCH (n) "
-            "WHERE n.element_id IS NOT NULL "
-            "AND any(label IN labels(n) WHERE label IN "
-            "['FoodPlace','Hotel','ScenicSpot','TransitFacility','BusStop']) "
-            "RETURN n.element_id, labels(n)"
-        ).result_set
         result: dict[str, list[str]] = {}
-        for element_id, labels in rows:
-            categories = [
-                GRAPH_POI_LABELS[label]
-                for label in (labels or [])
-                if label in GRAPH_POI_LABELS
-            ]
-            if element_id and categories:
-                result[str(element_id)] = categories
+        page_size = 5000
+        offset = 0
+        while True:
+            rows = graph.query(
+                "MATCH (n) "
+                "WHERE n.element_id IS NOT NULL "
+                "AND coalesce(n.lng,n.longitude) IS NOT NULL "
+                "AND coalesce(n.lat,n.latitude) IS NOT NULL "
+                "RETURN n.element_id, labels(n), properties(n) "
+                f"ORDER BY n.element_id SKIP {offset} LIMIT {page_size}"
+            ).result_set
+            for element_id, labels, raw_properties in rows:
+                properties = raw_properties if isinstance(raw_properties, dict) else {}
+                categories = _graph_poi_business_categories(labels, properties)
+                if element_id and categories:
+                    result[str(element_id)] = categories
+            if len(rows) < page_size:
+                break
+            offset += page_size
         return result
     finally:
         db.close()
@@ -715,16 +762,14 @@ def _graph_map_poi_items(rows: list[list[Any]]) -> list[dict[str, Any]]:
     items: list[dict[str, Any]] = []
     for node_id, labels, raw_properties in rows:
         properties = raw_properties if isinstance(raw_properties, dict) else {}
-        lng = properties.get("lng")
-        lat = properties.get("lat")
+        lng = properties.get("lng", properties.get("longitude"))
+        lat = properties.get("lat", properties.get("latitude"))
         if lng is None or lat is None:
             continue
-        categories = [
-            GRAPH_POI_LABELS[label]
-            for label in (labels or [])
-            if label in GRAPH_POI_LABELS
-        ]
-        category = str(properties.get("type_label") or (categories[0] if categories else "其他地点"))
+        categories = _graph_poi_business_categories(labels, properties)
+        if not categories:
+            continue
+        category = categories[0]
         element_id = str(
             properties.get("element_id")
             or node_id
@@ -744,6 +789,8 @@ def _graph_map_poi_items(rows: list[list[Any]]) -> list[dict[str, Any]]:
                 "address": str(properties.get("address") or ""),
                 "district": str(properties.get("district") or ""),
                 "city": str(properties.get("city") or ""),
+                "province": str(properties.get("province") or ""),
+                "adcode": str(properties.get("adcode") or ""),
                 "towncode": str(properties.get("towncode") or ""),
                 "town_name": str(properties.get("town_name") or ""),
                 "zone_id": str(properties.get("zone_id") or ""),
@@ -756,15 +803,23 @@ def _graph_map_poi_items(rows: list[list[Any]]) -> list[dict[str, Any]]:
 def _read_graph_map_pois(graph_name: str) -> list[dict[str, Any]]:
     db = FalkorDB(host=settings.falkordb_host, port=settings.falkordb_port)
     try:
-        rows = db.select_graph(graph_name).query(
-            "MATCH (n) "
-            "WHERE n.lng IS NOT NULL AND n.lat IS NOT NULL "
-            "AND any(label IN labels(n) WHERE label IN "
-            "['FoodPlace','Hotel','ScenicSpot','TransitFacility','BusStop']) "
-            "RETURN n.__kg_node_id,labels(n),properties(n) "
-            "ORDER BY n.name LIMIT 15000"
-        ).result_set
-        return _graph_map_poi_items(rows)
+        graph = db.select_graph(graph_name)
+        items: list[dict[str, Any]] = []
+        page_size = 5000
+        offset = 0
+        while True:
+            rows = graph.query(
+                "MATCH (n) "
+                "WHERE coalesce(n.lng,n.longitude) IS NOT NULL "
+                "AND coalesce(n.lat,n.latitude) IS NOT NULL "
+                "RETURN n.__kg_node_id,labels(n),properties(n) "
+                f"ORDER BY n.name,n.element_id SKIP {offset} LIMIT {page_size}"
+            ).result_set
+            items.extend(_graph_map_poi_items(rows))
+            if len(rows) < page_size:
+                break
+            offset += page_size
+        return items
     finally:
         db.close()
 
@@ -899,12 +954,16 @@ def _graph_poi_detail_payload(
         or properties.get("gaode_poi_id")
         or ""
     )
+    categories = _graph_poi_business_categories(labels, properties)
+    lng = properties.get("lng", properties.get("longitude"))
+    lat = properties.get("lat", properties.get("latitude"))
     return {
         "graph_name": graph_name,
         "id": element_id,
         "gaode_poi_id": str(properties.get("gaode_poi_id") or ""),
         "name": str(properties.get("name") or "未命名POI"),
-        "category": str(properties.get("type_label") or "其他地点"),
+        "category": categories[0] if categories else "其他地点",
+        "categories": categories or ["其他地点"],
         "place_type": str(properties.get("place_type") or "poi"),
         "business_subcategory": raw.get("business_subcategory") or "",
         "scenic_type": raw.get("scenic_type") or properties.get("scenic_type") or "",
@@ -920,8 +979,8 @@ def _graph_poi_detail_payload(
         "typecode": str(properties.get("typecode") or ""),
         "scan_hit_count": raw.get("scan_hit_count") or 0,
         "matched_scan_types": raw.get("matched_scan_types") or [],
-        "lng": float(properties.get("lng") or 0),
-        "lat": float(properties.get("lat") or 0),
+        "lng": float(lng or 0),
+        "lat": float(lat or 0),
         "province": str(properties.get("province") or ""),
         "city": str(properties.get("city") or ""),
         "district": str(properties.get("district") or ""),
@@ -981,8 +1040,8 @@ async def map_pois(
         async with conn.cursor() as cur:
             await cur.execute(
                 f"""SELECT p.element_id, p.gaode_poi_id, p.name, p.type_label,
-                           p.place_type, p.lng, p.lat, p.address, p.district,
-                           p.city, p.towncode, p.town_name,
+                           p.place_type, p.lng, p.lat, p.address, p.province,
+                           p.district, p.city, p.adcode, p.towncode, p.town_name,
                            z.zone_id, z.zone_name
                     FROM {s}.amap_spatial_pois p
                     LEFT JOIN {s}.poi_zone_assignments z
@@ -991,18 +1050,20 @@ async def map_pois(
                      AND z.zone_set_id = %s
                     WHERE p.graph_name=%s
                     ORDER BY p.type_label, p.name
-                    LIMIT 15000""",
+                    LIMIT 100000""",
                 (LIBO_ZONE_SET_ID, graph_name),
             )
             rows = await cur.fetchall()
     if rows:
-        try:
-            graph_categories = await asyncio.to_thread(
-                _graph_poi_categories,
-                graph_name,
-            )
-        except Exception:  # noqa: BLE001 - relational points remain usable
-            graph_categories = {}
+        graph_categories: dict[str, list[str]] = {}
+        if graph_name != SPATIAL_GRAPH_NAME:
+            try:
+                graph_categories = await asyncio.to_thread(
+                    _graph_poi_categories,
+                    graph_name,
+                )
+            except Exception:  # noqa: BLE001 - relational points remain usable
+                graph_categories = {}
         items = [
             {
                 "id": row["element_id"],
@@ -1017,8 +1078,10 @@ async def map_pois(
                 "lng": float(row["lng"]),
                 "lat": float(row["lat"]),
                 "address": row["address"] or "",
+                "province": row["province"] or "",
                 "district": row["district"] or "",
                 "city": row["city"] or "",
+                "adcode": row["adcode"] or "",
                 "towncode": row["towncode"] or "",
                 "town_name": row["town_name"] or "",
                 "zone_id": row["zone_id"] or "",
diff --git a/app/project_lifecycle.py b/app/project_lifecycle.py
index df7255d..2e96c76 100644
--- a/app/project_lifecycle.py
+++ b/app/project_lifecycle.py
@@ -20,6 +20,7 @@ from app.config import settings
 SAFE_RESOURCE_ID = re.compile(r"^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$")
 SAFE_SCHEMA_IDENTIFIER = re.compile(r"^[A-Za-z_][A-Za-z0-9_]{0,127}$")
 SAFE_SCHEMA_VERSION = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$")
+SAFE_ADCODE = re.compile(r"^\d{6}$")
 
 TYPE_ALIASES = {
     "str": "string",
@@ -51,6 +52,15 @@ SUPPORTED_FIELD_TYPES = {
 GRAPH_IMPORT_BATCH_THRESHOLD = 500
 GRAPH_IMPORT_BATCH_SIZE = 250
 
+SPATIAL_REGION_LEVELS = {"province", "city", "district"}
+MAP_ENTITY_TYPES = {
+    "FoodPlace",
+    "Hotel",
+    "ScenicSpot",
+    "TransitFacility",
+    "BusStop",
+}
+
 
 class ProjectValidationError(ValueError):
     """Raised when a provision payload is invalid before any write occurs."""
@@ -69,6 +79,48 @@ class GraphImportError(RuntimeError):
         self.cleanup_required = cleanup_error is not None
 
 
+def _adcode_belongs_to_region(adcode: str, region_adcode: str, level: str) -> bool:
+    if not SAFE_ADCODE.fullmatch(adcode) or not SAFE_ADCODE.fullmatch(region_adcode):
+        return False
+    if level == "province":
+        return adcode[:2] == region_adcode[:2]
+    if level == "city":
+        return adcode[:4] == region_adcode[:4]
+    return adcode == region_adcode
+
+
+def _region_names_match(value: Any, region_name: str) -> bool:
+    candidate = str(value or "").strip()
+    expected = str(region_name or "").strip()
+    return bool(candidate and expected and (candidate in expected or expected in candidate))
+
+
+def _is_spatial_map_node(node: Mapping[str, Any]) -> bool:
+    properties = node.get("properties")
+    if not isinstance(properties, Mapping):
+        return False
+    has_coordinates = (
+        properties.get("lng") is not None
+        and properties.get("lat") is not None
+    ) or (
+        properties.get("longitude") is not None
+        and properties.get("latitude") is not None
+    )
+    if not has_coordinates:
+        return False
+    labels = {
+        str(label)
+        for label in (node.get("labels") or [])
+        if str(label).strip()
+    }
+    labels.add(str(node.get("type") or ""))
+    return bool(
+        labels & MAP_ENTITY_TYPES
+        or str(properties.get("type_label") or "").strip()
+        or str(properties.get("place_type") or "").strip()
+    )
+
+
 def _as_mapping(value: Any) -> dict[str, Any]:
     return dict(value) if isinstance(value, Mapping) else {}
 
@@ -246,6 +298,20 @@ def normalize_provision_payload(body: Any) -> dict[str, Any]:
     map_scope = str(raw_spatial_map.get("scope") or "libo").strip().lower()
     if map_scope not in {"libo", "guizhou"}:
         errors.append("spatial_map.scope 仅支持 libo 或 guizhou")
+    map_region_name = str(raw_spatial_map.get("region_name") or "").strip()
+    map_region_adcode = str(raw_spatial_map.get("region_adcode") or "").strip()
+    map_region_level = str(raw_spatial_map.get("region_level") or "").strip().lower()
+    if map_enabled:
+        if not map_region_name:
+            errors.append("启用知识地图时必须选择地图区域")
+        if not SAFE_ADCODE.fullmatch(map_region_adcode):
+            errors.append("spatial_map.region_adcode 必须是 6 位行政区划代码")
+        if map_region_level not in SPATIAL_REGION_LEVELS:
+            errors.append("spatial_map.region_level 仅支持 province、city 或 district")
+        if SAFE_ADCODE.fullmatch(map_region_adcode):
+            expected_scope = "libo" if map_region_adcode == "522722" else "guizhou"
+            if map_scope != expected_scope:
+                errors.append("spatial_map.scope 与所选地图区域不一致")
 
     if not project_id:
         errors.append("项目英文标识不能为空")
@@ -399,6 +465,42 @@ def normalize_provision_payload(body: Any) -> dict[str, Any]:
             normalized_node["labels"] = normalized_labels
         nodes.append(normalized_node)
 
+    if map_enabled:
+        map_nodes = [node for node in nodes if _is_spatial_map_node(node)]
+        if not map_nodes:
+            errors.append("启用知识地图时，图谱数据至少需要一个带经纬度和业态的空间节点")
+        elif SAFE_ADCODE.fullmatch(map_region_adcode) and map_region_level in SPATIAL_REGION_LEVELS:
+            unverified_region = 0
+            mismatched_adcodes: set[str] = set()
+            for node in map_nodes:
+                properties = node["properties"]
+                adcode = str(properties.get("adcode") or "").strip()
+                if adcode and not _adcode_belongs_to_region(
+                    adcode,
+                    map_region_adcode,
+                    map_region_level,
+                ):
+                    mismatched_adcodes.add(adcode)
+                if adcode:
+                    continue
+                region_field = {
+                    "province": properties.get("province"),
+                    "city": properties.get("city"),
+                    "district": properties.get("district"),
+                }[map_region_level]
+                if not _region_names_match(region_field, map_region_name):
+                    unverified_region += 1
+            if unverified_region:
+                errors.append(
+                    f"知识地图空间节点有 {unverified_region} 条既无可用 adcode，"
+                    "也没有与所选区域匹配的省市区县字段"
+                )
+            if mismatched_adcodes:
+                examples = "、".join(sorted(mismatched_adcodes)[:5])
+                errors.append(
+                    f"知识地图数据与所选区域 {map_region_name} 不一致，发现行政区划代码：{examples}"
+                )
+
     relations: list[dict[str, Any]] = []
     for index, raw_relation in enumerate(raw_relations):
         path = f"graph_data.relations[{index}]"
@@ -462,7 +564,13 @@ def normalize_provision_payload(body: Any) -> dict[str, Any]:
         "display_name": display_name,
         "description": str(body.get("description") or "").strip() or None,
         "graph_name": graph_name,
-        "spatial_map": {"enabled": map_enabled, "scope": map_scope},
+        "spatial_map": {
+            "enabled": map_enabled,
+            "scope": map_scope,
+            "region_name": map_region_name,
+            "region_adcode": map_region_adcode,
+            "region_level": map_region_level or "province",
+        },
         "schema": schema,
         "graph_data": {"nodes": nodes, "relations": relations},
         "counts": {
diff --git a/design-qa.md b/design-qa.md
index 7b77937..e484498 100644
--- a/design-qa.md
+++ b/design-qa.md
@@ -101,6 +101,27 @@
 - 当前没有遗留 P0、P1 或 P2 问题。
 - final result: passed
 
+## 2026-08-26 统一知识地图与地图区域校验
+
+### 设计依据与证据
+
+- 固定分类快捷入口：`/var/folders/sl/bt4qhk351ndfm_1x3_4wkw440000gn/T/TemporaryItems/NSIRD_screencaptureui_4E2cld/Screenshot 2026-08-26 at 2.10.55 AM.png`
+- 地图模板：`/var/folders/sl/bt4qhk351ndfm_1x3_4wkw440000gn/T/TemporaryItems/NSIRD_screencaptureui_OhTxjA/Screenshot 2026-08-26 at 2.12.53 AM.png`
+- 项目创建地图选项：`/var/folders/sl/bt4qhk351ndfm_1x3_4wkw440000gn/T/TemporaryItems/NSIRD_screencaptureui_B4I7DT/Screenshot 2026-08-26 at 2.13.24 AM.png`
+
+### 实现与检查
+
+- 固定保留“美食、酒店、景点、交通设施”四个快捷入口和现有图片；其他业态仅进入分类筛选，不替换固定入口。
+- 开启知识地图后必须选择行政区域；默认城市项目兼容为“贵阳市 / 520100”，云游荔波兼容为“荔波县 / 522722”。
+- 地图边界、中心视图和 POI 过滤统一读取项目行政区域，不再根据项目英文标识猜测城市。
+- 后端在写入前校验空间节点的 `adcode`；旧数据缺少 `adcode` 时校验省/市/区县名称，发现跨区域数据会拒绝创建。
+- 前端生产构建、84 个 Python 测试和 43 个前端测试通过。
+
+### 可见质量状态
+
+- 应用内浏览器当前停在 `/admin/login` 且没有登录会话；未输入密码，因此无法在同一视口捕获“开启地图并选择区域”后的最终页面并完成并排视觉比较。
+- final result: blocked
+
 ## 2026-08-24 接口中心方案 1 重构验收
 
 ### 设计依据与证据
diff --git a/scripts/export_city_map_bundle.py b/scripts/export_city_map_bundle.py
new file mode 100644
index 0000000..ee99567
--- /dev/null
+++ b/scripts/export_city_map_bundle.py
@@ -0,0 +1,285 @@
+#!/usr/bin/env python3
+"""Export the authoritative province POI store as an importable map project.
+
+The legacy city project keeps its semantic graph in ``guiyang_new2`` and its
+map businesses in PostgreSQL ``amap_spatial_pois``.  This exporter snapshots
+the latter exactly, so an imported project preserves the 80,609-POI business
+count and can use the same knowledge-map template without a hidden graph-name
+redirect.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from collections import Counter
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+import psycopg
+from psycopg.rows import dict_row
+
+ROOT = Path(__file__).resolve().parents[1]
+if str(ROOT) not in sys.path:
+    sys.path.insert(0, str(ROOT))
+
+from app.config import settings
+from app.project_lifecycle import normalize_provision_payload
+from scripts.export_yunyou_libo_full_graph_bundle import (
+    SCHEMA_VERSION,
+    build_schema,
+    dump_json,
+    exported_counts,
+    jsonable,
+    safe_prefix,
+    sha256_file,
+)
+
+SOURCE_GRAPH_NAME = "guiyang_spatial_v1"
+DEFAULT_PROJECT_ID = "city_map_export_v3"
+DEFAULT_DISPLAY_NAME = "城市图谱"
+
+# ``raw_jsonb`` and ``photo_urls`` duplicate data that has already been
+# normalized into the columns below.  Keeping them is useful for an immutable
+# archive, but makes an 80,609-POI browser import several hundred megabytes.
+# The portable profile keeps every POI while retaining all fields used by the
+# shared map template, search and detail drawer.
+PORTABLE_PROPERTY_KEYS = {
+    "element_id",
+    "gaode_poi_id",
+    "name",
+    "type_label",
+    "place_type",
+    "amap_type",
+    "typecode",
+    "lng",
+    "lat",
+    "province",
+    "city",
+    "district",
+    "adcode",
+    "business_area",
+    "address",
+    "tel",
+    "open_time",
+    "rating",
+    "cost",
+    "level",
+    "tags",
+    "source",
+    "towncode",
+    "town_name",
+}
+
+CATEGORY_LABELS = {
+    "景点": "ScenicSpot",
+    "美食": "FoodPlace",
+    "酒店": "Hotel",
+    "商场": "Mall",
+    "医疗保健": "MedicalPlace",
+    "交通设施": "TransitFacility",
+    "生活服务": "LifeServicePlace",
+    "科教文化": "EducationPlace",
+    "政府机构": "GovernmentPlace",
+    "公共设施": "Facility",
+    "体育休闲": "RecreationPlace",
+    "商务住宅": "ResidentialPlace",
+    "公司企业": "EnterprisePlace",
+    "金融保险": "FinancePlace",
+    "汽车服务": "AutoServicePlace",
+    "汽车维修": "AutoRepairPlace",
+    "汽车销售": "AutoSalesPlace",
+    "摩托车服务": "MotorcycleServicePlace",
+    "地名地址": "NamedPlace",
+    "道路附属": "RoadFacility",
+}
+
+
+def read_nodes(
+    source_graph_name: str,
+    *,
+    profile: str,
+) -> tuple[list[dict[str, Any]], Counter[str]]:
+    nodes: list[dict[str, Any]] = []
+    categories: Counter[str] = Counter()
+    with psycopg.connect(settings.database_url, row_factory=dict_row) as conn:
+        with conn.cursor(name="city_map_export") as cur:
+            cur.execute(
+                f"""SELECT *
+                    FROM {settings.db_schema}.amap_spatial_pois
+                    WHERE graph_name=%s
+                    ORDER BY element_id""",
+                (source_graph_name,),
+            )
+            for row in cur:
+                element_id = str(row["element_id"])
+                category = str(row.get("type_label") or "其他地点")
+                business_label = CATEGORY_LABELS.get(category, "BusinessPlace")
+                properties = {
+                    str(key): jsonable(value)
+                    for key, value in row.items()
+                    if key != "graph_name"
+                    and (profile == "full" or key in PORTABLE_PROPERTY_KEYS)
+                    and (
+                        profile == "full"
+                        or value is not None
+                        and value != ""
+                        and value != []
+                        and value != {}
+                    )
+                }
+                if profile == "full":
+                    properties["source_graph_name"] = source_graph_name
+                nodes.append(
+                    {
+                        "id": element_id,
+                        "type": business_label,
+                        "labels": ["Place", business_label],
+                        "properties": properties,
+                    }
+                )
+                categories[category] += 1
+    return nodes, categories
+
+
+def export_city_map(
+    output_dir: Path,
+    *,
+    project_id: str,
+    display_name: str,
+    source_graph_name: str = SOURCE_GRAPH_NAME,
+    profile: str = "full",
+) -> dict[str, Any]:
+    output_dir.mkdir(parents=True, exist_ok=True)
+    generated_at = datetime.now(timezone.utc).isoformat()
+    nodes, category_counts = read_nodes(source_graph_name, profile=profile)
+    if len(nodes) != len({item["id"] for item in nodes}):
+        raise RuntimeError("省域 POI 数据存在重复 element_id")
+
+    relations: list[dict[str, Any]] = []
+    graph_name = project_id
+    spatial_map = {
+        "enabled": True,
+        "scope": "guizhou",
+        "region_name": "贵阳市",
+        "region_adcode": "520100",
+        "region_level": "city",
+    }
+    counts = exported_counts(nodes, relations)
+    schema = build_schema(
+        nodes,
+        relations,
+        project_id=project_id,
+        graph_name=graph_name,
+        display_name=display_name,
+    )
+    source_counts = {
+        "nodes": len(nodes),
+        "relations": 0,
+        "coordinate_nodes": sum(
+            1
+            for item in nodes
+            if item["properties"].get("lng") is not None
+            and item["properties"].get("lat") is not None
+        ),
+        "category_counts": dict(sorted(category_counts.items())),
+    }
+    graph_data = {
+        "_bundle": {
+            "format": "znkg-city-map-snapshot-v3",
+            "source": "postgresql.amap_spatial_pois",
+            "source_graph_name": source_graph_name,
+            "profile": profile,
+            "project_id": project_id,
+            "graph_name": graph_name,
+            "generated_at": generated_at,
+            "spatial_map": spatial_map,
+            "source_snapshot_counts": source_counts,
+        },
+        "nodes": nodes,
+        "relations": relations,
+    }
+    bundle = {
+        "format": "znkg-project-bundle-v3",
+        "project_id": project_id,
+        "display_name": display_name,
+        "spatial_map": spatial_map,
+        "schema": schema,
+        "graph_data": graph_data,
+    }
+    normalized = normalize_provision_payload(bundle)
+    if (
+        normalized["counts"]["nodes"] != len(nodes)
+        or normalized["counts"]["relations"] != 0
+    ):
+        raise RuntimeError("后端校验后的省域 POI 数量不一致")
+
+    prefix = safe_prefix(project_id)
+    suffix = "full" if profile == "full" else "portable"
+    schema_path = output_dir / f"{prefix}_{suffix}_schema.v3.json"
+    graph_path = output_dir / f"{prefix}_{suffix}_graph_data.v3.json"
+    bundle_path = output_dir / f"{prefix}_{suffix}_bundle.v3.json"
+    manifest_path = output_dir / f"{prefix}_{suffix}_manifest.v3.json"
+    dump_json(schema_path, schema, pretty=True)
+    dump_json(graph_path, graph_data)
+    dump_json(bundle_path, bundle)
+    files = {
+        path.name: {"bytes": path.stat().st_size, "sha256": sha256_file(path)}
+        for path in (schema_path, graph_path, bundle_path)
+    }
+    manifest = {
+        "format": "znkg-city-map-manifest-v3",
+        "project_id": project_id,
+        "graph_name": graph_name,
+        "source_graph_name": source_graph_name,
+        "profile": profile,
+        "schema_version": SCHEMA_VERSION,
+        "generated_at": generated_at,
+        "spatial_map": spatial_map,
+        "source_snapshot_counts": source_counts,
+        "export_counts": counts,
+        "validation": "passed",
+        "validation_checks": {
+            "node_count_matches_postgresql": counts["nodes"] == source_counts["nodes"],
+            "coordinate_count_matches_postgresql": (
+                counts["coordinate_nodes"] == source_counts["coordinate_nodes"]
+            ),
+            "node_ids_are_unique": True,
+            "backend_bundle_validation_passed": True,
+        },
+        "files": files,
+    }
+    dump_json(manifest_path, manifest, pretty=True)
+    manifest["manifest_file"] = str(manifest_path)
+    return manifest
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--output-dir", type=Path, required=True)
+    parser.add_argument("--project-id", default=DEFAULT_PROJECT_ID)
+    parser.add_argument("--display-name", default=DEFAULT_DISPLAY_NAME)
+    parser.add_argument("--source-graph-name", default=SOURCE_GRAPH_NAME)
+    parser.add_argument(
+        "--profile",
+        choices=("full", "portable"),
+        default="full",
+        help=(
+            "full keeps every source column; portable keeps every POI but "
+            "omits duplicated raw payloads for browser import."
+        ),
+    )
+    args = parser.parse_args()
+    manifest = export_city_map(
+        args.output_dir.expanduser().resolve(),
+        project_id=args.project_id,
+        display_name=args.display_name,
+        source_graph_name=args.source_graph_name,
+        profile=args.profile,
+    )
+    print(json.dumps(manifest, ensure_ascii=False, indent=2))
+
+
+if __name__ == "__main__":
+    main()
diff --git a/scripts/export_graph_snapshot_bundle.py b/scripts/export_graph_snapshot_bundle.py
new file mode 100644
index 0000000..9d3650b
--- /dev/null
+++ b/scripts/export_graph_snapshot_bundle.py
@@ -0,0 +1,8 @@
+#!/usr/bin/env python3
+"""CLI alias for the generic lossless FalkorDB project snapshot exporter."""
+
+from export_yunyou_libo_full_graph_bundle import main
+
+
+if __name__ == "__main__":
+    main()
diff --git a/scripts/export_yunyou_libo_full_graph_bundle.py b/scripts/export_yunyou_libo_full_graph_bundle.py
index 28ffb1f..2ad8e78 100644
--- a/scripts/export_yunyou_libo_full_graph_bundle.py
+++ b/scripts/export_yunyou_libo_full_graph_bundle.py
@@ -1,8 +1,8 @@
 #!/usr/bin/env python3
-"""Export the current Yunyou Libo FalkorDB graph as a lossless import bundle.
+"""Export any live FalkorDB graph as a lossless project import bundle.
 
-The live ``yunyou_libo`` graph is the authority for this export. Earlier
-versions rebuilt a different graph from PostgreSQL rows: duplicate AMap POIs
+The selected live graph is the authority for this export. Earlier project
+fixtures rebuilt a different graph from PostgreSQL rows: duplicate AMap POIs
 were split, media and links were modeled twice, and unrelated custom tables
 were imported automatically. That made the JSON totals differ from the graph
 shown by the project.
@@ -40,8 +40,6 @@ PROJECT_ID = "yunyou_libo"
 GRAPH_NAME = "yunyou_libo"
 DISPLAY_NAME = "云游荔波"
 SCHEMA_VERSION = "3.0.0"
-SPATIAL_MAP = {"enabled": True, "scope": "libo"}
-
 LABEL_PRIORITY = (
     "Hotel",
     "FoodPlace",
@@ -196,46 +194,69 @@ def export_live_graph(graph: Any) -> tuple[list[dict[str, Any]], list[dict[str,
     exported_id_by_internal: dict[str, str] = {}
     exported_ids: set[str] = set()
 
-    for row in graph.query("MATCH (n) RETURN n").result_set:
-        raw_node = row[0]
-        source_internal_id = internal_id(raw_node)
-        properties = properties_of(raw_node)
-        node_id = str(properties.get("__kg_node_id") or f"falkor:{source_internal_id}")
-        if node_id in exported_ids:
-            raise RuntimeError(f"图谱存在重复导出节点 ID：{node_id}")
-        labels = labels_of(raw_node)
-        exported_ids.add(node_id)
-        exported_id_by_internal[source_internal_id] = node_id
-        nodes.append(
-            {
-                "id": node_id,
-                "type": primary_label(labels),
-                "labels": labels,
-                "properties": properties,
-            }
-        )
+    page_size = 5000
+    offset = 0
+    while True:
+        rows = graph.query(
+            "MATCH (n) RETURN n ORDER BY id(n) "
+            f"SKIP {offset} LIMIT {page_size}"
+        ).result_set
+        for row in rows:
+            raw_node = row[0]
+            source_internal_id = internal_id(raw_node)
+            properties = properties_of(raw_node)
+            node_id = str(properties.get("__kg_node_id") or f"falkor:{source_internal_id}")
+            if node_id in exported_ids:
+                raise RuntimeError(f"图谱存在重复导出节点 ID：{node_id}")
+            labels = labels_of(raw_node)
+            exported_ids.add(node_id)
+            exported_id_by_internal[source_internal_id] = node_id
+            nodes.append(
+                {
+                    "id": node_id,
+                    "type": primary_label(labels),
+                    "labels": labels,
+                    "properties": properties,
+                }
+            )
+        if len(rows) < page_size:
+            break
+        offset += page_size
 
     relations: list[dict[str, Any]] = []
-    rows = graph.query("MATCH (source)-[relation]->(target) RETURN source, relation, target")
-    for source, edge, target in rows.result_set:
-        source_id = exported_id_by_internal.get(internal_id(source))
-        target_id = exported_id_by_internal.get(internal_id(target))
-        if not source_id or not target_id:
-            raise RuntimeError("关系引用了未导出的节点")
-        relations.append(
-            {
-                "type": relation_type_of(edge),
-                "source": source_id,
-                "target": target_id,
-                "properties": properties_of(edge),
-            }
-        )
+    offset = 0
+    while True:
+        rows = graph.query(
+            "MATCH (source)-[relation]->(target) "
+            "RETURN source, relation, target ORDER BY id(relation) "
+            f"SKIP {offset} LIMIT {page_size}"
+        ).result_set
+        for source, edge, target in rows:
+            source_id = exported_id_by_internal.get(internal_id(source))
+            target_id = exported_id_by_internal.get(internal_id(target))
+            if not source_id or not target_id:
+                raise RuntimeError("关系引用了未导出的节点")
+            relations.append(
+                {
+                    "type": relation_type_of(edge),
+                    "source": source_id,
+                    "target": target_id,
+                    "properties": properties_of(edge),
+                }
+            )
+        if len(rows) < page_size:
+            break
+        offset += page_size
     return nodes, relations
 
 
 def build_schema(
     nodes: list[dict[str, Any]],
     relations: list[dict[str, Any]],
+    *,
+    project_id: str,
+    graph_name: str,
+    display_name: str,
 ) -> dict[str, Any]:
     rows_by_label: dict[str, list[dict[str, Any]]] = defaultdict(list)
     primary_type_by_id: dict[str, str] = {}
@@ -271,10 +292,10 @@ def build_schema(
         }
 
     return {
-        "namespace": PROJECT_ID,
+        "namespace": project_id,
         "version": SCHEMA_VERSION,
-        "display_name": "云游荔波当前图谱快照 Schema v3",
-        "description": "从当前 yunyou_libo FalkorDB 图谱无损导出，保留多标签节点。",
+        "display_name": f"{display_name}当前图谱快照 Schema v3",
+        "description": f"从当前 {graph_name} FalkorDB 图谱无损导出，保留多标签节点。",
         "entity_types": entity_types,
         "relation_types": relation_types,
     }
@@ -302,9 +323,14 @@ def exported_counts(
         primary_type_counts[item["type"]] += 1
         properties = item["properties"]
         has_coordinates = properties.get("lng") is not None and properties.get("lat") is not None
+        if not has_coordinates:
+            has_coordinates = (
+                properties.get("longitude") is not None
+                and properties.get("latitude") is not None
+            )
         if has_coordinates:
             coordinate_nodes += 1
-            if labels & MAP_POI_LABELS:
+            if labels & MAP_POI_LABELS or properties.get("place_type") or properties.get("type_label"):
                 map_poi_nodes += 1
             if "BusStop" in labels:
                 bus_stop_nodes += 1
@@ -328,7 +354,8 @@ def source_counts(graph: Any) -> dict[str, Any]:
     relation_count = int(graph.query("MATCH ()-[r]->() RETURN count(r)").result_set[0][0])
     coordinate_count = int(
         graph.query(
-            "MATCH (n) WHERE n.lng IS NOT NULL AND n.lat IS NOT NULL RETURN count(n)"
+            "MATCH (n) WHERE coalesce(n.lng,n.longitude) IS NOT NULL "
+            "AND coalesce(n.lat,n.latitude) IS NOT NULL RETURN count(n)"
         ).result_set[0][0]
     )
     label_counts: Counter[str] = Counter()
@@ -405,18 +432,51 @@ def dump_json(path: Path, value: Any, *, pretty: bool = False) -> None:
         handle.write("\n")
 
 
-def export(output_dir: Path) -> dict[str, Any]:
+def safe_prefix(value: str) -> str:
+    normalized = "".join(
+        char.lower() if char.isalnum() else "_"
+        for char in value.strip()
+    )
+    return "_".join(part for part in normalized.split("_") if part) or "graph"
+
+
+def export(
+    output_dir: Path,
+    *,
+    project_id: str = PROJECT_ID,
+    graph_name: str = GRAPH_NAME,
+    display_name: str = DISPLAY_NAME,
+    map_enabled: bool = True,
+    spatial_scope: str = "libo",
+    region_name: str | None = None,
+    region_adcode: str | None = None,
+    region_level: str | None = None,
+    output_prefix: str | None = None,
+) -> dict[str, Any]:
     output_dir.mkdir(parents=True, exist_ok=True)
     generated_at = datetime.now(timezone.utc).isoformat()
+    default_region = (
+        ("荔波县", "522722", "district")
+        if spatial_scope == "libo"
+        else ("贵州省", "520000", "province")
+    )
+    spatial_map = {
+        "enabled": map_enabled,
+        "scope": spatial_scope,
+        "region_name": (region_name or default_region[0]) if map_enabled else "",
+        "region_adcode": (region_adcode or default_region[1]) if map_enabled else "",
+        "region_level": (region_level or default_region[2]) if map_enabled else "province",
+    }
+    prefix = safe_prefix(output_prefix or project_id)
     client = make_client()
     try:
         graph_names = {
             item.decode("utf-8") if isinstance(item, bytes) else str(item)
             for item in client.list_graphs()
         }
-        if GRAPH_NAME not in graph_names:
-            raise RuntimeError(f"FalkorDB 中不存在图谱 {GRAPH_NAME!r}")
-        graph = client.select_graph(GRAPH_NAME)
+        if graph_name not in graph_names:
+            raise RuntimeError(f"FalkorDB 中不存在图谱 {graph_name!r}")
+        graph = client.select_graph(graph_name)
         live_counts = source_counts(graph)
         nodes, relations = export_live_graph(graph)
     finally:
@@ -424,15 +484,21 @@ def export(output_dir: Path) -> dict[str, Any]:
 
     counts = exported_counts(nodes, relations)
     checks = validate_snapshot(live_counts, counts, nodes, relations)
-    schema = build_schema(nodes, relations)
+    schema = build_schema(
+        nodes,
+        relations,
+        project_id=project_id,
+        graph_name=graph_name,
+        display_name=display_name,
+    )
     graph_data = {
         "_bundle": {
             "format": "znkg-falkordb-snapshot-v3",
             "source": "falkordb",
-            "project_id": PROJECT_ID,
-            "graph_name": GRAPH_NAME,
+            "project_id": project_id,
+            "graph_name": graph_name,
             "generated_at": generated_at,
-            "spatial_map": SPATIAL_MAP,
+            "spatial_map": spatial_map,
             "source_snapshot_counts": live_counts,
         },
         "nodes": nodes,
@@ -440,9 +506,9 @@ def export(output_dir: Path) -> dict[str, Any]:
     }
     provision = {
         "format": "znkg-project-bundle-v3",
-        "project_id": PROJECT_ID,
-        "display_name": DISPLAY_NAME,
-        "spatial_map": SPATIAL_MAP,
+        "project_id": project_id,
+        "display_name": display_name,
+        "spatial_map": spatial_map,
         "schema": schema,
         "graph_data": graph_data,
     }
@@ -452,10 +518,10 @@ def export(output_dir: Path) -> dict[str, Any]:
     if normalized["counts"]["relations"] != counts["relations"]:
         raise RuntimeError("后端校验后的关系数量不一致")
 
-    schema_path = output_dir / "yunyou_libo_full_schema.v3.json"
-    graph_path = output_dir / "yunyou_libo_full_graph_data.v3.json"
-    bundle_path = output_dir / "yunyou_libo_full_bundle.v3.json"
-    manifest_path = output_dir / "yunyou_libo_full_manifest.v3.json"
+    schema_path = output_dir / f"{prefix}_full_schema.v3.json"
+    graph_path = output_dir / f"{prefix}_full_graph_data.v3.json"
+    bundle_path = output_dir / f"{prefix}_full_bundle.v3.json"
+    manifest_path = output_dir / f"{prefix}_full_manifest.v3.json"
     dump_json(schema_path, schema, pretty=True)
     dump_json(graph_path, graph_data)
     dump_json(bundle_path, provision)
@@ -466,12 +532,12 @@ def export(output_dir: Path) -> dict[str, Any]:
     }
     manifest = {
         "format": "znkg-full-graph-manifest-v3",
-        "project_id": PROJECT_ID,
-        "graph_name": GRAPH_NAME,
+        "project_id": project_id,
+        "graph_name": graph_name,
         "schema_version": SCHEMA_VERSION,
         "generated_at": generated_at,
         "source": "falkordb",
-        "spatial_map": SPATIAL_MAP,
+        "spatial_map": spatial_map,
         "source_snapshot_counts": live_counts,
         "export_counts": counts,
         "validation": "passed",
@@ -491,8 +557,46 @@ def main() -> None:
         required=True,
         help="Directory for schema, graph-data, bundle and manifest JSON files.",
     )
+    parser.add_argument("--project-id", default=PROJECT_ID)
+    parser.add_argument("--graph-name", default=GRAPH_NAME)
+    parser.add_argument("--display-name", default=DISPLAY_NAME)
+    parser.add_argument(
+        "--map-enabled",
+        action=argparse.BooleanOptionalAction,
+        default=True,
+        help="Whether the exported project should enable the knowledge-map template.",
+    )
+    parser.add_argument(
+        "--map-scope",
+        choices=("libo", "guizhou"),
+        default="libo",
+        help="Boundary scope used by the single knowledge-map template.",
+    )
+    parser.add_argument(
+        "--output-prefix",
+        default=None,
+        help="Optional filename prefix; defaults to project-id.",
+    )
+    parser.add_argument("--region-name", default=None)
+    parser.add_argument("--region-adcode", default=None)
+    parser.add_argument(
+        "--region-level",
+        choices=("province", "city", "district"),
+        default=None,
+    )
     args = parser.parse_args()
-    manifest = export(args.output_dir.expanduser().resolve())
+    manifest = export(
+        args.output_dir.expanduser().resolve(),
+        project_id=args.project_id,
+        graph_name=args.graph_name,
+        display_name=args.display_name,
+        map_enabled=args.map_enabled,
+        spatial_scope=args.map_scope,
+        region_name=args.region_name,
+        region_adcode=args.region_adcode,
+        region_level=args.region_level,
+        output_prefix=args.output_prefix,
+    )
     print(json.dumps(manifest, ensure_ascii=False, indent=2))
 
 
diff --git a/tests/test_plaza_graph_fallback.py b/tests/test_plaza_graph_fallback.py
index 9d6b405..92765ba 100644
--- a/tests/test_plaza_graph_fallback.py
+++ b/tests/test_plaza_graph_fallback.py
@@ -5,6 +5,7 @@ from app.api.plaza import (
     _graph_map_poi_items,
     _graph_poi_detail_payload,
     _graph_zone_payload,
+    _resolve_spatial_graph_name,
 )
 
 
@@ -48,6 +49,42 @@ class PlazaGraphFallbackTests(unittest.TestCase):
         self.assertEqual(items[1]["categories"], ["公交站"])
         self.assertEqual(items[0]["zone_id"], "A01")
 
+    def test_city_place_nodes_use_place_type_as_dynamic_business_category(self) -> None:
+        items = _graph_map_poi_items(
+            [[
+                None,
+                ["Place"],
+                {
+                    "element_id": "city:mall-1",
+                    "name": "测试商场",
+                    "place_type": "mall",
+                    "longitude": 106.63,
+                    "latitude": 26.65,
+                    "adcode": "520102",
+                },
+            ]]
+        )
+
+        self.assertEqual(items[0]["category"], "商场")
+        self.assertEqual(items[0]["categories"], ["商场"])
+        self.assertEqual(items[0]["lng"], 106.63)
+        self.assertEqual(items[0]["adcode"], "520102")
+
+    def test_coordinate_helper_nodes_are_not_rendered_as_business_pois(self) -> None:
+        items = _graph_map_poi_items(
+            [[
+                "cell-1",
+                ["GeoCell"],
+                {"name": "网格", "lng": 106.63, "lat": 26.65},
+            ]]
+        )
+
+        self.assertEqual(items, [])
+
+    def test_legacy_city_project_uses_its_explicit_spatial_companion(self) -> None:
+        self.assertEqual(_resolve_spatial_graph_name("guiyang_new2"), "guiyang_spatial_v1")
+        self.assertEqual(_resolve_spatial_graph_name("city_import_v3"), "city_import_v3")
+
     def test_graph_zones_decode_serialized_geometry(self) -> None:
         payload = _graph_zone_payload(
             [[{"towncode": "522722100000", "name": "玉屏街道"}, 12, 107.8, 25.3, 107.9, 25.5]],
diff --git a/tests/test_project_lifecycle.py b/tests/test_project_lifecycle.py
index df6f95d..19e40da 100644
--- a/tests/test_project_lifecycle.py
+++ b/tests/test_project_lifecycle.py
@@ -111,15 +111,92 @@ class ProjectPayloadValidationTests(unittest.TestCase):
     def test_spatial_map_defaults_to_disabled_libo_scope(self) -> None:
         payload = normalize_provision_payload(valid_payload())
 
-        self.assertEqual(payload["spatial_map"], {"enabled": False, "scope": "libo"})
+        self.assertEqual(payload["spatial_map"], {
+            "enabled": False,
+            "scope": "libo",
+            "region_name": "",
+            "region_adcode": "",
+            "region_level": "province",
+        })
 
     def test_spatial_map_option_is_normalized(self) -> None:
         body = valid_payload()
-        body["spatial_map"] = {"enabled": True, "scope": "guizhou"}
+        body["schema"]["entity_types"]["Place"]["fields"].update({
+            "lng": {"type": "number"},
+            "lat": {"type": "number"},
+            "adcode": {"type": "string"},
+            "place_type": {"type": "string"},
+        })
+        body["graph_data"]["nodes"][0]["properties"].update({
+            "lng": 106.63,
+            "lat": 26.65,
+            "adcode": "520102",
+            "place_type": "mall",
+        })
+        body["spatial_map"] = {
+            "enabled": True,
+            "scope": "guizhou",
+            "region_name": "贵阳市",
+            "region_adcode": "520100",
+            "region_level": "city",
+        }
 
         payload = normalize_provision_payload(body)
 
-        self.assertEqual(payload["spatial_map"], {"enabled": True, "scope": "guizhou"})
+        self.assertEqual(payload["spatial_map"], body["spatial_map"])
+
+    def test_spatial_map_rejects_data_outside_selected_city(self) -> None:
+        body = valid_payload()
+        body["schema"]["entity_types"]["Place"]["fields"].update({
+            "lng": {"type": "number"},
+            "lat": {"type": "number"},
+            "adcode": {"type": "string"},
+            "type_label": {"type": "string"},
+        })
+        body["graph_data"]["nodes"][0]["properties"].update({
+            "lng": 107.0,
+            "lat": 27.0,
+            "adcode": "520302",
+            "type_label": "美食",
+        })
+        body["spatial_map"] = {
+            "enabled": True,
+            "scope": "guizhou",
+            "region_name": "贵阳市",
+            "region_adcode": "520100",
+            "region_level": "city",
+        }
+
+        with self.assertRaises(ProjectValidationError) as raised:
+            normalize_provision_payload(body)
+
+        self.assertIn("数据与所选区域 贵阳市 不一致", "；".join(raised.exception.errors))
+
+    def test_spatial_map_accepts_legacy_city_name_when_adcode_is_missing(self) -> None:
+        body = valid_payload()
+        body["schema"]["entity_types"]["Place"]["fields"].update({
+            "lng": {"type": "number"},
+            "lat": {"type": "number"},
+            "city": {"type": "string"},
+            "place_type": {"type": "string"},
+        })
+        body["graph_data"]["nodes"][0]["properties"].update({
+            "lng": 106.63,
+            "lat": 26.65,
+            "city": "贵阳",
+            "place_type": "transit_stop",
+        })
+        body["spatial_map"] = {
+            "enabled": True,
+            "scope": "guizhou",
+            "region_name": "贵阳市",
+            "region_adcode": "520100",
+            "region_level": "city",
+        }
+
+        payload = normalize_provision_payload(body)
+
+        self.assertEqual(payload["spatial_map"]["region_name"], "贵阳市")
 
     def test_invalid_spatial_map_is_rejected(self) -> None:
         body = valid_payload()