chore(repo): Remove unused files / 清理无用文件与过时说明

.gitignore

@@ -50,6 +50,8 @@ run.stderr.log
 .tmp-region-data/
 tmp/
 .playwright-mcp/
+apps/admin-region-tiler/geojson/materialize-report.json
+apps/admin-region-tiler/geojson/download-report.json
 
 # OS/editor noise
 .DS_Store

apps/admin-region-tiler/.dockerignore

@@ -8,6 +8,8 @@ tiles/
 dist/
 build/
 .tmp-region-data/
+geojson/materialize-report.json
+geojson/download-report.json
 
 tiler
 tiler.exe

apps/admin-region-tiler/README.md

@@ -168,15 +168,17 @@ node .\scripts\release_preflight.mjs
 
 ## 当前架构
 
-新的内部包结构从 `internal/` 开始：
-
-- `internal/api`：统一 HTTP API。
-- `internal/auth`：可选登录和会话。
-- `internal/config`：应用配置、地图源和输出路径。
-- `internal/area`：bbox 和行政区划区域选择。
-- `internal/planner`：任务定义、运行记录和子任务规划。
-- `internal/downloader`：瓦片枚举、下载、重试和写入。
-- `internal/artifact`：ZIP、MBTiles 和兼容产物。
-- `internal/web`：统一静态前端辅助。
+当前内部包和主应用的职责如下：
+
+- `internal/area`：bbox 和行政区划参数校验。
+- `internal/downloader`：bbox 瓦片坐标及数量计算。
+- `server.go`、`main.go`、`db.go`：HTTP API、配置、登录、SQLite 事务与迁移。
+- `runtime.go`、`queue.go`：任务控制、持久排队和工作进程调度。
+- `task.go`、`enumeration.go`、`worker_process.go`：枚举、下载、重试和写入。
+- `artifact_lifecycle.go`、`integrity.go`、`reconcile.go`：产物发布、删除、累计完整度与历史核对。
+- `static/`：登录、新建计划、任务管理及地图预览页面。
+
+详细入口见 [项目地图](../../docs/project-map.md)，清理结果和后续问题见
+[维护清单](../../docs/maintenance-audit-2026-09-11.md)。
 
 旧 `.NET` 范围下载器的框选交互和简单天地图流程已迁移到当前 Go 应用，旧运行代码已退役。

apps/admin-region-tiler/deploy/DEPLOYMENT.md

@@ -11,8 +11,12 @@
 
 ## Docker 部署
 
+首次启动前，复制 `.env.example` 为 `.env` 并在本地编辑
+`AUTH_DEFAULT_USERNAME`、`AUTH_DEFAULT_PASSWORD`，保持登录启用。
+
 ```bash
 cp .env.example .env
+# 编辑 .env 中的初始账号后再启动
 docker compose up -d --build
 ```
 
@@ -36,8 +40,11 @@ useradd -r -s /usr/sbin/nologin tiler
 chown -R tiler:tiler /opt/tiler
 ```
 
-4. 安装 `deploy/systemd/tiler.service`
-5. 执行：
+4. 首次启动前，在本地 `conf.toml` 的 `[auth]` 中设置初始用户名和密码，并限制
+   配置文件读取权限。二进制不会自动读取 `.env`；当前 systemd 示例也未配置
+   `EnvironmentFile`，仅复制 `.env` 不会生效。
+5. 安装 `deploy/systemd/tiler.service`
+6. 执行：
 
 ```bash
 systemctl daemon-reload
@@ -59,20 +66,26 @@ systemctl status tiler
 nginx -t && systemctl reload nginx
 ```
 
-## 首次登录
+## 初始账号
 
 - 用户名：`admin`
 - 密码：`adminmap`
 
-建议上线后第一时间修改默认密码。
+以上仅为开发默认值，部署时需在首次启动前替换。应用没有已实现的改密页面或接口，
+修改 `AUTH_DEFAULT_PASSWORD` 不会重置数据库里已有同名用户的密码；不要通过删除
+数据库来改密，以免丢失任务记录。已有默认账号的处置需单独安排。
 
-`.env` 中可以覆盖：
+Docker 的 `.env` 中可以覆盖以下配置；源码或二进制需使用进程环境变量或
+`conf.toml`（`HOST_PORT` 仅用于 Docker 端口映射）：
 
 - `HOST_PORT`
 - `APP_PORT`
 - `APP_DATABASE`
 - `AUTH_DEFAULT_USERNAME`
 - `AUTH_DEFAULT_PASSWORD`
+- `TASK_MAX_TILES`
+- `TASK_MAX_ACTIVE`
+- `TASK_WORKERS`
 
 ## 数据持久化目录
 
@@ -107,8 +120,7 @@ nginx -t && systemctl reload nginx
 ## 删除任务说明
 
 - `取消` 只改变任务状态，不会删除记录
-- `删除` 会彻底删除：
-  - `plans` 中的任务记录
-  - `task_runs` 中的运行记录
-  - 该任务对应的产物文件与输出目录
-- `删除` 不会删除共享的 `geojson/` 区域文件
+- `删除` 会清理任务记录、历史运行、产物、失败记录和关联元数据；父任务包括全部子任务。
+- 运行、暂停或打包中的任务需要先取消并等待结束。清理失败后可重试。
+- 内置区域文件和仍有其他任务引用的文件受保护；任务生成的区域文件在最后一个引用解除后清理。
+- 升级前的备份、副本验证和历史核对方式见 [修复验收记录](../../../docs/repair-acceptance-2026-09-11.md)。