札
落札ラボ
研 · Lab
首页 批次总览 现地调查 快速分析 发布管理 ⚙ 管理
🔐

请先登录

管理员页面需要 admin 权限。

⚙ 管理员页
仅管理员
当前批次列表
载入中…
数据同步 · Sheet → 数据库
仅 owner
将选定批次的 表格(Sheet)数据发布到数据库 —— 即公开页与编辑器读取的“受控已发布数据”。 幂等操作，并自动清理 改名遗留行（如 自由→白山）。Sheet 仍是编辑源； 是否发布由你点击决定，平时不会自动同步。
① 批次目录：把 Drive 的批次列表（名称·日期·件数）缓存到数据库；action=batches 即从数据库秒读，不再每次扫描 Drive。新增/删除批次后先点这里。
② 物件数据：把选定批次的 Sheet 物件数据发布到数据库。
③ 恢复现地字段：把 Sheet 中存在、但数据库缺失的现地调查字段（如 现场考察摘要） 仅补充合并进数据库——不覆盖已有值（安全，不会重演“全部丢失”）。使用上方所选批次。
④ 重新链接报告：按 Sheet 的法拍文件编号 为每个物件匹配其三点セット报告文件，把 报告文件ID/名 写入数据库——修复因案号碰撞（同案号跨令和7/8）而链接到错误报告的物件， 并标记两个物件指向同一报告的情况。只写这两个链接字段，不动其它数据。使用上方所选批次。
新批次の追加
新批次は Drive にフォルダを作成し、上の「数据同步 → 🗂 刷新批次目录」をクリックすると検出・登録されます。 /api/data?action=batches は Drive を毎回走査せず、この目录キャッシュを秒読みします。
  1. ルートフォルダ（GOOGLE_DRIVE_ROOT_FOLDER_ID）に新規フォルダを作成。命名規則：2026-5 B 批次 / 2026-6 A 批次 など（YYYY-M [A-Z] 批次）
  2. そのフォルダ内に master sheet を配置。ファイル名に「法拍管理套表」「管理套表」または「入例表」を含めること（複数あれば Google Sheets 形式が優先）
  3. 下のボタンで自動検出を確認。検出された批次は上の一覧に追加されます
初始化新批次主表（按当前字段）：把当前字段表头写进一个全新空白的 Google 表格的 B 列， 使其与当前批次结构一致——之后用 例 录入向导选择该批次录入即可。常用于补录历史批次： 旧批次各自独立，不会改动任何旧表。若目标表已含「物件命名」等字段则拒绝写入（防止覆盖已有数据）。
批次主表重新匹配：选择批次 + 填入该批次独立的主表 文件ID，数据库即知道该批次的录入写入此表（覆盖按文件夹名自动识别——旧批次往往只能识别到旧表）。 每个批次一张独立数据表。勾选「同时初始化」会先写入字段表头。绑定要求该表已有 入例表【土地+建物】 工作表，绝不写旧表。
字段维护说明 · 如何增加 / 调整一个字段

字段布局编辑器已停用——字段现在在后端代码里维护（更可靠、可走测试 + 预览灰度）。下面是增加或调整一个字段要改的地方，按需照做。新增字段无需数据库迁移（Supabase data 是 JSONB）。

① field-layout.json — 注册字段

  • page_sections[].subsections[].fields[] 加一项：{ "name":"字段名", "type":"basic|extended|input", "sheet_row":null, "format":"text_long" }
    • type：basic=所有人可见（公开事实）· extended=高级查看展开 · input=分析/录入字段
    • format：text / text_long / currency_jpy / percent / date / number / select / multi_select
    • sheet_row：新字段填 null（写入器按"列标签"自动追加到主表底部，不会错位）；老字段才有行号
  • wizard_phases[].sections[].fields[] 加上"字段名"，录入向导才会显示它
  • （可选）field_definitions 加 "字段名":"说明" → UI 上的「?」悬浮提示

② api/data.py 的 _FIELD_AUTH — 谁能看到

  • '字段名': 'Guest' = 公开（访客可见值）· 'Guest -folded' = 高级折叠 · 'Agent' = 仅 agent
  • 决定该字段在物件页 / 卡片 / feed 上对访客是否显示

③（可选）AI 自动填写 — _AI_SUMMARY_FIELDS（data.py）

  • 想让 🤖AI摘要 从三点报告 OCR 自动填该字段，就加 "字段名":"日文 prompt"

④ 数据怎么流

  • 录入向导提交 → 写主表入例表（按标签追加行）+ Supabase properties_staging →（核对/公开后）进 properties
  • 公开页读 properties（经 oracle 分级）；首页 feed 读 ongoing / 批次页读 active_props

⑤（可选）特殊展示

  • 卡片角标（如 ⚠ / ★）改共用 /mono-card.js；详情页特殊块改 property/index.html

⑥ 测试（必做）

  • 新增向导字段要同步更新 golden-master tests/test_wizard_phases.py 的 EXPECTED_WIZARD_FIELDS
  • 为新字段/行为加一条回归测试；.venv/bin/pytest tests/ 全绿再 push（push main = 上线 prod）

最近实例：特别警示事项 + 关注 / 不推荐 / 取下 —— 完整步骤见 docs/STAGE_WARNING_RECOMMEND.md。
字段总表 / 读取规范：docs/MASTER_DATA_STRUCTURE.md + docs/REPORT_FIELD_MAP.md。

权限同步 · auth matrix → 数据库
仅 owner
从 Google 表格 「auth matrix」读取权限矩阵，应用到数据库（profiles 角色 + 能力）。 先「预览」查看将发生的变更，确认后再「应用」。应用是幂等的： 只新增/更新表中的用户，绝不自动撤销表里没有的账号（仅列出）。 表中的新用户会被自动创建并生成设置密码邀请链接。
用户权限管理
权限存储于 Auth0 app_metadata.monospages_role，用户无法自行修改。
载入中…
权限级别说明
级别Key可访问内容
管理员admin全部功能 + 用户管理 + 批次创建
编辑员worker查看全部 + 编辑分析 + 上传媒体
高级查看viewer_premium全部3个区段（只读）+ 扩展字段
基础查看viewer_basic仅🔴基础字段，隐藏现地调查&投资分析
无权限（空）登录后显示权限受限提示
快速邀请调查员
共享当前批次 Drive 文件夹 + 可选设置权限
⚠️ 当前 OAuth 同意屏幕处于测试模式 — 被邀请人还需手动加入 GCP 测试用户名单才能使用照片上传功能。
→ 打开 GCP OAuth 同意屏幕  （点 "Test users" → Add users → 粘贴邮件 → Save）
或发布同意屏幕（PUBLISH APP）一劳永逸，最多支持 100 个用户。
点击"发送邀请"后，对方会收到来自 Google Drive 的共享邮件，并获得当前批次文件夹的编辑权限，可向其中上传照片。
Auth0 登录权限（查看物件数据）需另行在上方"用户权限管理"中设置。
快速邀请分析员
共享当前批次 Drive 文件夹（查看者）
⚠️ 同上：OAuth 同意屏幕测试模式限制同样适用于分析员。
→ 打开 GCP OAuth 同意屏幕  添加测试用户，或 PUBLISH APP 一劳永逸。
分析员获得当前批次文件夹的查看者权限，可浏览调查照片但不能上传。
快速分析页面的数据读取权限（Google Sheet）及 Auth0 角色仍需在上方"用户权限管理"中另行设置。
首页横幅预览
最新公告
2026年5月A批次开始受理
本期共收录21件东京都内法拍物件。
入札期间：2026年5月21日 — 5月28日
查看当前推荐关注物件 →
21
件物件
5/28
入札截止
编辑横幅内容
📦 件数・截止日 are auto-managed from the latest active batch — saving here is a no-op for these. The CTA button is now a fixed「查看当前推荐关注物件」feature (filters the home feed to 关注 cards) — not editable copy.
读取中…
推荐使用 Unsplash 或 Google Drive 直链。宽度建议 1600px 以上。
滚动公告条 · 顶部跑马灯 📣
首页顶部那条橙色滚动公告（与上方的主横幅卡片是两个不同的东西）。在这里改文字、开关显示，保存后约几秒生效。
📣 …
历史横幅 · 近 20 条
每次保存横幅或公告条都会记录当时的标题 / 说明 / 公告文字。点任一字段即复制，「套用」一键填回左侧表单。
暂无历史记录
读取质量 · 识别(Parser) vs 🤖Gemini

每次提交物件后自动记录：识别(parser，技能层) 与 🤖Gemini(通读，捕获层) 各自的提案 vs 人工最终值。 下面是各自命中率、最该优先打磨的字段（被人工修正最多）、以及 parser↔Gemini 的分歧—— 这些就是「读取技能」改进的输入（修定义/补 parser/加校验规则）。

AI 技能提案 · 写入 M/N（不动你的 K定义 / L读取）

让 Gemini 基于现有人工 定义/读取 + 报告位置 + 样例，为每个字段提出它自己的 定义 与 读取，写入主表的 M / N 列（绝不覆盖你的 K定义 / L读取）。你在表里并排比较人工 vs AI，择优把更好的并入 K/L，并记到 READING_SKILL_LOG。
⚠ 先把该表共享给服务账号 monos-sheet-reader@monos-sheet-reader.iam.gserviceaccount.com 为「编辑者」，否则写入 403。

🔗 数据接入 · L0 数据层 仅 owner

把政府数据资源接入定价引擎，并把全部物件（现/往，所有批次）的 L0 特征快照写入 pricing_ledger（校准台账＝护城河）。本轮零外部抓取：直接用已解析的 評価書 字段（売却基準/積算/収益/建物/土地…）。幂等，可重复运行。

🔒 先进入例 · 结构化通读（新注册表 → 第二通道）

🚀 打开 先进入例 完整录入台 →

完整录入台＝从 例 继承的全套界面（选批次/物件 · 左栏列表 · 右栏报告 · 分步录入），核心换成新注册表 + 第二通道。下面是轻量快速读取（单份测试）：仅 owner 可见，按 registry_NEW_ORDER 读取已预读全文的报告 → xianjin_reads，不触碰现有 例/物件 数据。