Files
jiu/web/dist/docs/index.html
T
wangjia aa7099ba94 feat(devops): 发版拆分为 client/site/server 三条独立流水线
将单一 CI/CD 流水线拆成三条互不影响的发布流水线,各有 tag 前缀、独立版本
序列与独立 CHANGELOG:

- client(client-v*):Flutter 全平台 + version.yaml 自更新清单
- site(site-v*):web/ Eleventy 营销站,不含 web 版 app
- server(server-v*):backend Go 服务 + 共享基建 nginx/systemd

新增 3 个 workflow(deploy-client/site/server.yml)替换 deploy.yml;CI 脚本
按 part 拆分为 compile-/release-/deploy-{client,site,server}.sh,抽出公共函数
lib-forgejo.sh;compile-{macos,android,ios,windows}.sh 改去 client-v 前缀;
manual.yml 按前缀路由回滚。

跨流水线解耦:version.yaml 归 client,后端每请求实时读取(不重启、不触发
server 流水线);官网下载页的版本徽章/下载链接/更新日志时间线运行时经
/api/v1/public/release 动态拉取(API 不可达回退构建时静态内容)。为此一次性
扩展后端 changelog 字段(version.go/public.go)与 download.njk 动态渲染。

CHANGELOG.md 重命名为 CHANGELOG-client.md,新增 CHANGELOG-site/server.md;
重写 /release 命令为 /release <part> [version];同步更新 CLAUDE.md 与部署文档。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-17 08:21:28 +08:00

890 lines
36 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="color-scheme" content="light" />
<title>使用手册 · 岩美酒库管理系统</title>
<meta name="description" content="岩美酒库管理系统使用手册,覆盖入库、出库、库存、财务等全功能操作说明。" />
<link rel="stylesheet" href="/assets/color.css" />
<link rel="stylesheet" href="/assets/style.css" />
<link rel="stylesheet" href="/assets/docs.css" />
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
<script src="https://unpkg.com/lucide@0.469.0/dist/umd/lucide.min.js"></script>
</head>
<body>
<nav class="topnav">
<div class="topnav-inner">
<a href="/" class="topnav-brand">
<img src="/assets/logo-full.svg" alt="岩美" />
</a>
<div class="topnav-links">
<a href="/#modules">产品</a>
<a href="/features/inventory.html">库存</a>
<a href="/features/approval.html">审核流</a>
<a href="/#pricing">价格</a>
<a href="/download/">下载</a>
<a href="/docs/">文档</a>
<a href="/#faq">支持</a>
</div>
<div class="topnav-cta" id="nav-cta">
<a href="/register/" class="btn btn-primary btn-sm">注册门店</a>
</div>
<button class="nav-hamburger" id="nav-hamburger" aria-label="菜单" aria-expanded="false">
<span></span><span></span><span></span>
</button>
</div>
<div class="nav-mobile-menu" id="nav-mobile-menu">
<a href="/#modules">产品</a>
<a href="/features/inventory.html">库存管理</a>
<a href="/features/approval.html">审核流</a>
<a href="/#pricing">价格</a>
<a href="/download/">下载</a>
<a href="/docs/">文档</a>
<a href="/#faq">支持</a>
<div class="nav-mobile-cta" id="nav-mobile-cta">
<a href="/register/" class="btn btn-primary">注册门店</a>
</div>
</div>
</nav>
<!-- ============================== DOCS SUB-NAV ============================== -->
<div class="docs-subnav">
<div class="docs-subnav-inner">
<nav class="breadcrumb">
<a href="/">岩美</a>
<span class="sep">/</span>
<span class="current">使用手册</span>
</nav>
<div class="docs-search">
<i data-lucide="search" class="search-icon icon"></i>
<input type="text" placeholder="搜索文档..." id="docs-search-input" />
<span class="kbd">⌘K</span>
</div>
<div class="docs-version">
<i data-lucide="tag" class="icon"></i>
<span class="docs-version-label">版本</span>
<span>v1.0.54</span>
</div>
</div>
</div>
<!-- ============================== THREE-COLUMN LAYOUT ============================== -->
<div class="docs-layout">
<!-- Left TOC -->
<aside class="docs-toc" id="docs-toc">
<div class="toc-section">
<div class="toc-section-title">快速开始</div>
<a href="#ch-1" class="toc-link" data-chapter="ch-1">
<span class="toc-num">1</span>
系统概述
</a>
<a href="#ch-2" class="toc-link" data-chapter="ch-2">
<span class="toc-num">2</span>
登录与退出
</a>
<a href="#ch-3" class="toc-link" data-chapter="ch-3">
<span class="toc-num">3</span>
界面说明
</a>
</div>
<div class="toc-section">
<div class="toc-section-title">业务操作</div>
<a href="#ch-4" class="toc-link" data-chapter="ch-4">
<span class="toc-num">4</span>
角色与权限
</a>
<a href="#ch-5" class="toc-link" data-chapter="ch-5">
<span class="toc-num">5</span>
入库管理
</a>
<a href="#ch-6" class="toc-link" data-chapter="ch-6">
<span class="toc-num">6</span>
出库管理
</a>
<a href="#ch-7" class="toc-link" data-chapter="ch-7">
<span class="toc-num">7</span>
库存管理
</a>
<a href="#ch-8" class="toc-link" data-chapter="ch-8">
<span class="toc-num">8</span>
财务管理
</a>
<a href="#ch-9" class="toc-link" data-chapter="ch-9">
<span class="toc-num">9</span>
往来单位
</a>
</div>
<div class="toc-section">
<div class="toc-section-title">基础设置</div>
<a href="#ch-10" class="toc-link" data-chapter="ch-10">
<span class="toc-num">10</span>
基础数据(商品管理)
</a>
<a href="#ch-11" class="toc-link" data-chapter="ch-11">
<span class="toc-num">11</span>
系统设置
</a>
<a href="#ch-12" class="toc-link" data-chapter="ch-12">
<span class="toc-num">12</span>
常见问题
</a>
</div>
</aside>
<!-- Main content -->
<main class="docs-main" id="docs-main">
<section class="docs-chapter" id="ch-1">
<h2>1. 系统概述</h2>
<p>岩美酒库管理系统专为酒行门店设计,将入库、出库、库存查询、财务往来等日常业务整合到一个平台,支持多人协同操作,数据实时同步。</p>
<p><strong>核心功能一览</strong></p>
<table>
<thead>
<tr>
<th>模块</th>
<th>主要用途</th>
</tr>
</thead>
<tbody>
<tr>
<td>入库管理</td>
<td>新建入库单、提交审核、审批通过后自动更新库存</td>
</tr>
<tr>
<td>出库管理</td>
<td>新建出库单、提交审核、审批时自动扣减库存</td>
</tr>
<tr>
<td>库存管理</td>
<td>查询实时库存、库存盘点、打印标签</td>
</tr>
<tr>
<td>财务管理</td>
<td>查看应付款(欠供应商)和应收款(客户欠款)、标记结清</td>
</tr>
<tr>
<td>往来单位</td>
<td>管理供应商和客户的基本信息</td>
</tr>
<tr>
<td>基础数据</td>
<td>维护商品名称、系列、规格字典</td>
</tr>
<tr>
<td>系统设置</td>
<td>用户管理、仓库管理、编号规则、数据导入</td>
</tr>
</tbody>
</table>
<p><strong>支持平台</strong>:Web 浏览器(现已上线);Windows、macOS、iOS、Android 客户端即将推出。</p>
<hr>
</section>
<section class="docs-chapter" id="ch-2">
<h2>2. 登录与退出</h2>
<h3>2.1 登录</h3>
<ol>
<li>打开系统,进入登录页面。</li>
<li>在「门店编号」栏输入酒行的门店代号(例如 <code>S001</code>)。</li>
<li>输入「用户名」和「密码」。</li>
<li>点击「登录」按钮。</li>
</ol>
<p>登录成功后,系统自动跳转到「入库管理」页面。</p>
<p><strong>提示</strong>:系统会记录最近登录过的用户名,点击输入框可从候选列表中快速选择。</p>
<h3>2.2 退出登录</h3>
<p>点击顶部右侧用户名旁的下拉箭头,选择「退出登录」。</p>
<h3>2.3 查看当前登录信息</h3>
<p>点击顶部左侧「岩美」标题或右侧「门店编号」区域,弹出门店信息面板,显示门店编号、登录账号、姓名、系统版本。</p>
<hr>
</section>
<section class="docs-chapter" id="ch-3">
<h2>3. 界面说明</h2>
<p>系统主界面由三个区域组成:</p>
<pre><code>┌──────────────────────────────────────────────────────────┐
│ 顶部导航栏(标题、门店编号、用户名、退出) │
├──────────┬───────────────────────────────────────────────┤
│ │ │
│ 左侧 │ 主内容区域 │
│ 侧边栏 │ │
│ │ │
├──────────┴───────────────────────────────────────────────┤
│ 状态栏(门店、用户、登录时间、当前时间、连接状态) │
└──────────────────────────────────────────────────────────┘
</code></pre>
<p><strong>左侧侧边栏导航项</strong></p>
<table>
<thead>
<tr>
<th>导航项</th>
<th>功能</th>
</tr>
</thead>
<tbody>
<tr>
<td>入库管理</td>
<td>入库单录入与审核</td>
</tr>
<tr>
<td>出库管理</td>
<td>出库单录入与审核</td>
</tr>
<tr>
<td>库存管理</td>
<td>库存查询与盘点</td>
</tr>
<tr>
<td>财务管理</td>
<td>应付款和应收款</td>
</tr>
<tr>
<td>往来单位</td>
<td>供应商与客户</td>
</tr>
<tr>
<td>基础数据</td>
<td>商品名称、系列、规格字典</td>
</tr>
<tr>
<td>系统设置</td>
<td>用户、仓库、编号规则等配置</td>
</tr>
</tbody>
</table>
<p>点击侧边栏顶部的菜单图标可收起或展开侧边栏,节省屏幕空间。</p>
<p><strong>更新提示</strong>:有新版本时,内容区顶部会显示黄色提示横幅;如果是必须更新的版本,会弹出对话框要求立即更新。</p>
<p><strong>离线提示</strong>:网络断开时,顶部显示红色横幅「网络连接已断开」,状态栏变红,此时展示上次加载的缓存数据。</p>
<hr>
</section>
<section class="docs-chapter" id="ch-4">
<h2>4. 角色与权限</h2>
<p>系统有四种角色,权限从高到低依次为:</p>
<table>
<thead>
<tr>
<th>角色</th>
<th>说明</th>
<th>可执行操作</th>
</tr>
</thead>
<tbody>
<tr>
<td>超级管理员</td>
<td>系统最高权限账号</td>
<td>全部操作,含数据清空</td>
</tr>
<tr>
<td>管理员</td>
<td>门店管理人员</td>
<td>全部操作,含用户管理、酒行信息编辑</td>
</tr>
<tr>
<td>操作员</td>
<td>日常录入审核人员</td>
<td>新建、编辑、提交、审核单据,查询数据</td>
</tr>
<tr>
<td>只读</td>
<td>仅查看数据</td>
<td>只能查看,不能新建、修改、删除任何数据</td>
</tr>
</tbody>
</table>
<p><strong>权限说明</strong></p>
<ul>
<li>只读账号点击任何写操作按钮时,系统将直接提示「无权限」。</li>
<li>新增或编辑用户、重置密码仅管理员可操作。</li>
<li>修改酒行基本信息仅管理员可操作。</li>
<li>数据清空仅超级管理员可操作。</li>
</ul>
<hr>
</section>
<section class="docs-chapter" id="ch-5">
<h2>5. 入库管理</h2>
<p>入库管理页面包含两个标签页:<strong>入库审核</strong>(新建和待审核)和<strong>入库单</strong>(已完成记录)。</p>
<h3>5.1 入库单状态说明</h3>
<p>单据状态按以下流程流转:</p>
<p><strong>草稿</strong><strong>待审核</strong><strong>已审批</strong>(库存增加)</p>
<p>待审核阶段也可被拒绝,变为<strong>已拒绝</strong>状态(库存不变)。</p>
<table>
<thead>
<tr>
<th>状态</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>草稿</td>
<td>已保存但未提交,可继续编辑或删除</td>
</tr>
<tr>
<td>待审核</td>
<td>已提交等待审批,不可再编辑</td>
</tr>
<tr>
<td>已审批</td>
<td>审批通过,库存已增加,同时生成应付账款记录</td>
</tr>
<tr>
<td>已拒绝</td>
<td>审批不通过,库存不变</td>
</tr>
</tbody>
</table>
<h3>5.2 新建入库单</h3>
<ol>
<li>点击左侧「入库管理」,切换到「入库审核」标签页。</li>
<li>点击右上角「新建入库审核单」按钮。</li>
<li>填写入库基本信息:
<ul>
<li><strong>仓库</strong>(必填):选择货物入库的目标仓库。</li>
<li><strong>供应商</strong>(必填):选择供货的往来单位。</li>
<li><strong>入库日期</strong>(必填):默认为今天,可修改。</li>
<li><strong>备注</strong>(选填):填写本批次入库说明。</li>
</ul>
</li>
<li>在商品明细区域填写每一行商品:
<ul>
<li><strong>商品名称</strong>(必填):从字典中选择或直接输入。</li>
<li><strong>系列</strong>(必填):选择商品系列。</li>
<li><strong>规格</strong>(必填):选择商品规格,如 500ml×6。</li>
<li><strong>生产日期</strong>(必填):点击日历图标选择。</li>
<li><strong>批次号</strong>(选填):填写批次编号,用于后续追踪查询。</li>
<li><strong>数量</strong>(必填):填写入库数量。</li>
<li><strong>单价</strong>(必填):填写进货单价,系统自动计算总金额。</li>
</ul>
</li>
<li>点击「添加商品」可继续增加商品行,点击行末「删除」可移除该行。</li>
<li>完成后选择操作:
<ul>
<li><strong>保存草稿</strong>:保存后可以继续修改。</li>
<li><strong>保存并提交审核</strong>:提交后进入待审核状态,不可再编辑。</li>
</ul>
</li>
</ol>
<h3>5.3 提交审核</h3>
<p>草稿状态的入库单,在列表中点击「提交」按钮,确认后单据进入「待审核」状态。</p>
<h3>5.4 审批入库单</h3>
<p>操作员及以上权限的用户均可审批。</p>
<ol>
<li>在「入库审核」标签页中找到待审核的入库单。</li>
<li>点击「通过」:弹窗确认,确认后系统自动将商品入库,库存增加,同时生成一笔应付账款记录。</li>
<li>点击「拒绝」:弹窗确认,拒绝后库存不变,单据进入「已拒绝」状态。</li>
</ol>
<p><strong>注意</strong>:审批通过后操作不可撤销,请仔细核对商品数量和单价后再确认。</p>
<h3>5.5 查看入库单详情</h3>
<p>点击入库单号(蓝色链接)可弹出详情页,显示完整的商品明细、数量、金额及审核信息。详情页右上角有打印按钮,可直接打印入库单。</p>
<h3>5.6 打印入库单</h3>
<p>在列表中点击对应行的「打印」按钮,直接调用打印机打印入库单据。</p>
<h3>5.7 打印商品标签</h3>
<ol>
<li>在列表中点击对应行的「打标签」按钮。</li>
<li>弹出商品标签打印对话框,列出本次入库的所有商品。</li>
<li>勾选需要打印标签的商品(默认全选)。</li>
<li>点击「打印选中」,系统逐张打印选中商品的标签。</li>
</ol>
<p>标签内容包括:商品名称、编码、系列、规格、批次号、生产日期、酒行名称及联系方式、二维码。</p>
<h3>5.8 标记货款结清</h3>
<p>审批通过的入库单会自动生成应付账款记录。货款付清后,在列表中点击「结清」按钮,确认后将对应财务记录标记为已结清。</p>
<h3>5.9 筛选与导出</h3>
<ul>
<li><strong>仓库筛选</strong>:点击列头「仓库」的筛选图标,选择仓库进行过滤。</li>
<li><strong>供应商筛选</strong>:点击列头「供应商」的筛选图标,选择供应商进行过滤。</li>
<li><strong>日期筛选</strong>:点击「选择日期」按钮,选择日期范围。</li>
<li><strong>导出</strong>:点击「导出」按钮,将当前列表导出为 Excel 文件。</li>
</ul>
<hr>
</section>
<section class="docs-chapter" id="ch-6">
<h2>6. 出库管理</h2>
<p>出库管理与入库管理操作流程类似,包含<strong>出库审核</strong>(待处理)和<strong>出库单</strong>(已完成)两个标签页。</p>
<h3>6.1 出库单状态说明</h3>
<p>出库单状态流转与入库单相同:草稿 → 待审核 → 已审批或已拒绝。</p>
<p>审批通过后:</p>
<ul>
<li>系统会先检查库存是否充足,库存不足时审批失败并给出提示,库存不变。</li>
<li>库存充足时自动扣减库存,并生成应收账款记录。</li>
</ul>
<h3>6.2 新建出库单</h3>
<ol>
<li>点击左侧「出库管理」,切换到「出库审核」标签页。</li>
<li>点击右上角「新建出库审核单」按钮。</li>
<li>填写基本信息:
<ul>
<li><strong>仓库</strong>(必填):选择出货仓库。</li>
<li><strong>客户</strong>(必填):选择购买方(往来单位中的客户类型)。</li>
<li><strong>出库日期</strong>(必填):默认今天,可修改。</li>
</ul>
</li>
<li>填写商品明细:商品名称、系列、规格、数量、单价(操作方式同入库单)。</li>
<li>保存草稿或保存并提交审核。</li>
</ol>
<p><strong>注意</strong>:出库数量不能超过当前库存,审批时系统会自动检查,库存不足会提示失败。</p>
<h3>6.3 审批出库单</h3>
<p>操作步骤与入库审批相同。审批通过后库存自动扣减,同时生成应收账款记录。</p>
<h3>6.4 打印出库单</h3>
<p>在列表中点击「打印」按钮,打印出库单据。</p>
<h3>6.5 标记货款结清</h3>
<p>出库单审批通过后生成应收账款。收到货款后,在列表中点击「结清」按钮,将对应财务记录标记为已结清。</p>
<hr>
</section>
<section class="docs-chapter" id="ch-7">
<h2>7. 库存管理</h2>
<h3>7.1 查询库存</h3>
<p>点击左侧「库存管理」进入库存列表。</p>
<p>列表显示每个商品的实时库存数量、所在仓库、单价、金额、生产日期、批次等信息。</p>
<ul>
<li><strong>搜索</strong>:在搜索框输入商品名称关键字(也支持拼音或拼音首字母),实时过滤结果。</li>
<li><strong>仓库筛选</strong>:点击列头「仓库」的筛选图标,按仓库查看库存。</li>
<li><strong>导出</strong>:点击「导出」按钮,将当前库存列表导出为 Excel 文件。</li>
</ul>
<h3>7.2 修改备注</h3>
<p>在库存列表中,点击「备注」列对应单元格(显示铅笔图标或现有备注内容),弹出编辑框,填写后点击「保存」即可。</p>
<h3>7.3 打印商品标签</h3>
<p>在库存列表中点击某商品行的「打印标签」按钮,可单独打印该商品的标签。</p>
<h3>7.4 库存盘点</h3>
<ol>
<li>在库存管理页面切换到「库存盘点」标签页。</li>
<li>选择要盘点的<strong>仓库</strong>,系统自动加载该仓库所有商品的账面库存数量。</li>
<li>选择盘点类型(全盘)。</li>
<li>逐行填写<strong>实际盘点数量</strong>(与账面不符时修改数量)。</li>
<li>点击「提交盘点」完成。</li>
</ol>
<p>盘点单编号由系统自动生成。</p>
<h3>7.5 库存流水</h3>
<p>「库存流水」标签页可查看每次库存变动记录,包括入库、出库的时间、变动数量等。</p>
<hr>
</section>
<section class="docs-chapter" id="ch-8">
<h2>8. 财务管理</h2>
<h3>8.1 财务记录说明</h3>
<p>系统在以下情况自动生成财务记录:</p>
<ul>
<li>入库单审批通过 → 自动生成<strong>应付账款</strong>(欠供应商的货款)</li>
<li>出库单审批通过 → 自动生成<strong>应收账款</strong>(客户欠的货款)</li>
</ul>
<p>点击左侧「财务管理」进入财务页面,包含三个标签:</p>
<table>
<thead>
<tr>
<th>标签</th>
<th>内容</th>
</tr>
</thead>
<tbody>
<tr>
<td>全部记录</td>
<td>所有财务流水</td>
</tr>
<tr>
<td>应付账款</td>
<td>需要向供应商付款的记录</td>
</tr>
<tr>
<td>应收账款</td>
<td>客户尚未付款的记录</td>
</tr>
</tbody>
</table>
<h3>8.2 查看财务记录</h3>
<ul>
<li>默认显示当前月份的记录,可通过月份选择器查看历史月份。</li>
<li>支持按「类型」和「往来单位」列头筛选。</li>
<li>点击「导出」可导出当月数据为 Excel 文件。</li>
</ul>
<h3>8.3 标记结清</h3>
<p><strong>方式一</strong>:在入库单或出库单列表中点击「结清」按钮,直接结清该单据对应的账款。</p>
<p><strong>方式二</strong>:在财务管理列表中找到对应记录,点击「结清」按钮,单笔结清。</p>
<p>结清后该记录状态从「未结清」变为「已结清」。</p>
<h3>8.4 财务汇总</h3>
<p>财务管理页面显示当期应付和应收总额,便于掌握资金往来概况。</p>
<hr>
</section>
<section class="docs-chapter" id="ch-9">
<h2>9. 往来单位</h2>
<p>往来单位管理<strong>供应商</strong><strong>客户</strong>两类信息,新建入库单时选择供应商,新建出库单时选择客户。</p>
<h3>9.1 查看往来单位</h3>
<p>点击左侧「往来单位」,通过「供应商」和「客户」标签页分别查看。列表支持按名称搜索和导出。</p>
<h3>9.2 新建往来单位</h3>
<ol>
<li>在对应标签页点击右上角「新建」按钮。</li>
<li>填写信息:
<ul>
<li><strong>名称</strong>(必填)</li>
<li><strong>联系电话</strong>(选填)</li>
<li><strong>地址</strong>(选填)</li>
<li><strong>卡号</strong>(选填,如有账户绑定)</li>
<li><strong>初始余额</strong>(选填,导入历史数据时填写)</li>
<li><strong>备注</strong>(选填)</li>
</ul>
</li>
<li>点击「保存」。</li>
</ol>
<h3>9.3 编辑往来单位</h3>
<p>在列表中点击「编辑」按钮,修改信息后保存。</p>
<h3>9.4 删除往来单位</h3>
<p>在列表中点击「删除」按钮,确认后删除。</p>
<p><strong>注意</strong>:已关联入库单或出库单的往来单位不可删除。</p>
<hr>
</section>
<section class="docs-chapter" id="ch-10">
<h2>10. 基础数据(商品管理)</h2>
<p>点击左侧「基础数据」,进入商品字典管理页面,包含三个标签:<strong>商品名称</strong><strong>系列</strong><strong>规格</strong></p>
<p>这些字典数据是新建入库或出库单时选择商品的基础,需要先在此处维护好商品信息。</p>
<h3>10.1 商品名称管理</h3>
<p>商品名称是酒品的主名称,例如「茅台飞天 53°」。</p>
<ol>
<li>在「商品名称」标签页,点击「新建」按钮。</li>
<li>填写商品名称(必填)、编号(选填)、备注(选填)。</li>
<li>点击「保存」。</li>
</ol>
<p>支持按名称或编号搜索,支持分页浏览,支持编辑和删除。</p>
<h3>10.2 系列管理</h3>
<p>系列是商品所属的系列或品牌线,例如「飞天系列」「王子系列」。操作步骤与商品名称相同。</p>
<h3>10.3 规格管理</h3>
<p>规格用于描述包装规格,例如「500ml×6」「1000ml×1」。新建时可填写「单品数量」(即一箱包含的单瓶数量)。</p>
<h3>10.4 商品详情与二维码</h3>
<p>每个商品都有唯一的二维码,可通过扫码访问商品公开信息页面。在商品详情页可查看或上传商品图片。</p>
<hr>
</section>
<section class="docs-chapter" id="ch-11">
<h2>11. 系统设置</h2>
<p>点击左侧「系统设置」,包含七个标签页。</p>
<h3>11.1 酒行信息</h3>
<p>显示本门店的基本信息:门店编号、门店名称、地址、联系电话、负责人。</p>
<p><strong>编辑</strong>(仅管理员):点击「编辑信息」按钮,修改门店名称、地址、电话、负责人后保存。门店编号不可修改。</p>
<h3>11.2 用户管理(仅管理员)</h3>
<p><strong>查看用户</strong>:显示本门店所有用户的姓名、用户名、角色、启用状态。</p>
<p><strong>新增用户</strong></p>
<ol>
<li>点击「新增用户」按钮。</li>
<li>填写用户名(登录账号,不可重复)、姓名、手机号、初始密码。</li>
<li>选择角色(操作员、管理员、只读、超级管理员)。</li>
<li>点击「保存」。</li>
</ol>
<p><strong>编辑用户</strong>:点击用户行的「编辑」按钮,可修改姓名、手机号、角色(用户名不可修改)。</p>
<p><strong>重置密码</strong>:点击「重置密码」按钮,输入新密码后确认,下次登录时使用新密码。</p>
<p><strong>启用或停用</strong>:在用户列表中拨动状态开关。停用后该用户无法登录。</p>
<h3>11.3 仓库管理</h3>
<p><strong>查看仓库</strong>:显示所有仓库名称、位置、是否为默认仓库。</p>
<p><strong>新建仓库</strong></p>
<ol>
<li>点击「新建」按钮。</li>
<li>填写仓库名称(必填)、位置(选填)。</li>
<li>可勾选「设为默认仓库」,新建单据时将自动选择此仓库。</li>
<li>点击「保存」。</li>
</ol>
<p><strong>编辑或删除</strong>:点击对应按钮操作。已有库存的仓库不可删除。</p>
<h3>11.4 编号规则</h3>
<p>系统为每类单据自动生成唯一编号,格式由前缀、日期和序号组成,例如入库单编号 <code>RK20260523001</code></p>
<p><strong>查看当前规则</strong>:列表显示每种单据的前缀、当前序号及下一编号示例。</p>
<p><strong>修改规则</strong></p>
<ol>
<li>点击对应规则行的「编辑」按钮。</li>
<li>可修改「前缀」和「当前序号」。</li>
<li>点击「保存」,修改后对新建单据生效。</li>
</ol>
<p><strong>注意</strong>:请勿将序号调小至已使用过的范围,否则可能导致编号重复。</p>
<h3>11.5 系统参数</h3>
<p>配置系统的全局参数:</p>
<ul>
<li><strong>系统名称、货币单位、日期格式、时区</strong>(通常无需修改)</li>
<li><strong>入库单需要审核</strong>:关闭后提交即视为通过,无需审批</li>
<li><strong>出库单需要审核</strong>:关闭后同上</li>
<li><strong>允许超量出库</strong>:开启后,出库数量超过库存时仍可审批通过</li>
</ul>
<p>修改后点击「保存设置」生效,点击「重置默认」恢复出厂默认值。</p>
<h3>11.6 数据导入</h3>
<p>通过 Excel 文件批量导入历史数据。支持以下数据类型:往来单位、商品名称、商品系列、商品规格、商品编码、库存。</p>
<p>各类型的 Excel 格式要求详见系统内「系统设置 → 数据导入」页面说明。</p>
<p><strong>操作步骤</strong></p>
<ol>
<li>在对应数据类型行点击「选择文件」,选择 Excel(.xls 或 .xlsx)文件。</li>
<li>全部文件选择完成后,点击「全部导入」按钮。</li>
<li>系统依次处理每个文件并显示导入结果(新增、跳过重复、失败数量)。</li>
<li>如有失败,根据错误提示修正文件后重新导入。</li>
</ol>
<p><strong>导入规则</strong>:以名称去重,已存在的记录不重复导入。导入过程中请勿切换页面。</p>
<p><strong>数据清空(仅超级管理员)</strong>:在数据导入页面下方「危险操作」区域,选择要清空的数据表,点击确认后输入「确认清空」完成操作。<strong>此操作不可撤销,请务必提前做好数据备份。</strong></p>
<h3>11.7 关于</h3>
<ul>
<li><strong>版本信息</strong>:显示当前系统版本。有新版本时可点击「立即更新」。</li>
<li><strong>授权信息</strong>:显示授权类型(试用、月付、年付、买断)、授权状态、到期时间。授权剩余不足 30 天时会显示倒计时提醒。</li>
<li><strong>意见反馈</strong>:点击「反馈 Bug」或「功能建议」,通过邮件向开发团队反馈。</li>
</ul>
<hr>
</section>
<section class="docs-chapter" id="ch-12">
<h2>12. 常见问题</h2>
<p><strong>Q:入库单提交后发现填错了,怎么办?</strong></p>
<p>单据提交(待审核状态)后不可再修改。请联系管理员将该单据拒绝,然后重新新建一张正确的入库单。</p>
<p><strong>Q:出库审批时提示「库存不足」,怎么处理?</strong></p>
<p>出库数量超过当前仓库库存时,系统会拒绝审批。请检查出库数量,或确认对应商品的入库单是否已审批通过、库存已更新。</p>
<p><strong>Q:结清了财务记录但发现结清错了,如何撤销?</strong></p>
<p>目前系统不支持撤销结清操作。如需处理,请联系技术支持。</p>
<p><strong>Q:如何查找某批商品是从哪张入库单入库的?</strong></p>
<p>在库存管理列表中查看商品的批次号,然后在入库管理中按批次号搜索对应的入库单。</p>
<p><strong>Q:导入数据时提示「格式错误」,怎么处理?</strong></p>
<p>请检查 Excel 文件的列顺序是否与「系统设置 → 数据导入」页面说明的格式一致,且第一行为数据行(无需填写表头)。如问题持续,可将文件发送给技术支持排查。</p>
<p><strong>Q:用户无法登录,怎么处理?</strong></p>
<p>请管理员在「系统设置 → 用户管理」中检查该用户是否处于启用状态,并使用「重置密码」功能为其设置新密码。</p>
<p><strong>Q:操作时提示「无权限」,是什么原因?</strong></p>
<p>当前账号角色为「只读」,不允许执行写操作。如需操作,请联系管理员调整账号角色。</p>
<p><strong>Q:系统显示「网络连接已断开」,数据还准确吗?</strong></p>
<p>网络断开时,系统展示上次加载的缓存数据,可能不是最新状态。请恢复网络连接后刷新页面获取最新数据。</p>
<p><strong>Q:如何联系技术支持?</strong></p>
<p>进入「系统设置 → 关于」查看联系邮箱和技术支持时间。工作日(周一至周五)9:00 - 18:00 可获得响应。</p>
</section>
<div class="docs-feedback">
<span class="feedback-q">这篇文档对您有帮助吗?</span>
<div class="feedback-actions">
<button class="feedback-btn" onclick="sendFeedback('yes')">
<i data-lucide="thumbs-up" class="icon"></i>有帮助
</button>
<button class="feedback-btn" onclick="sendFeedback('no')">
<i data-lucide="thumbs-down" class="icon"></i>需要改进
</button>
</div>
</div>
</main>
<!-- Right rail -->
<aside class="docs-rail" id="docs-rail">
<div class="rail-title">本页目录</div>
<ul class="rail-list" id="rail-list"></ul>
<div class="rail-actions">
<button class="rail-action" onclick="window.print()">
<i data-lucide="printer" class="icon"></i>打印此页
</button>
<button class="rail-action" id="copy-link-btn">
<i data-lucide="link" class="icon"></i>复制链接
</button>
<a class="rail-action" href="#ch-1">
<i data-lucide="arrow-up" class="icon"></i>回到顶部
</a>
</div>
</aside>
</div>
<script>
(function() {
var chapters = document.querySelectorAll('.docs-chapter');
var tocLinks = document.querySelectorAll('.toc-link');
var railList = document.getElementById('rail-list');
// Build right rail from all chapter h2+h3 headings
function buildRail() {
var items = [];
chapters.forEach(function(ch) {
var chId = ch.id;
var chTitle = ch.querySelector('h2');
if (chTitle) {
items.push({ id: chId, text: chTitle.textContent, level: 2 });
}
ch.querySelectorAll('h3').forEach(function(h3) {
if (!h3.id) {
h3.id = chId + '-' + h3.textContent.replace(/\s+/g, '-').replace(/[^\w\-]/g, '').toLowerCase();
}
items.push({ id: h3.id, text: h3.textContent, level: 3 });
});
});
railList.innerHTML = items.map(function(item) {
var indent = item.level === 3 ? ' style="padding-left:20px;"' : '';
return '<li><a href="#' + item.id + '"' + indent + '>' + item.text + '</a></li>';
}).join('');
}
// Scrollspy: highlight active TOC link and rail link
function setupScrollspy() {
if (!window.IntersectionObserver) return;
var activeChapterId = null;
var observer = new IntersectionObserver(function(entries) {
entries.forEach(function(entry) {
if (entry.isIntersecting) {
activeChapterId = entry.target.id;
}
});
if (!activeChapterId) return;
// Update left TOC
tocLinks.forEach(function(link) {
var isActive = link.getAttribute('data-chapter') === activeChapterId;
link.classList.toggle('active', isActive);
});
// Update rail links
railList.querySelectorAll('a').forEach(function(a) {
a.classList.remove('active');
if (a.getAttribute('href') === '#' + activeChapterId) {
a.classList.add('active');
}
});
}, { rootMargin: '-20% 0px -70% 0px', threshold: 0 });
chapters.forEach(function(ch) { observer.observe(ch); });
}
// ⌘K / Ctrl+K 聚焦搜索框
document.addEventListener('keydown', function(e) {
if ((e.metaKey || e.ctrlKey) && e.key === 'k') {
var inp = document.getElementById('docs-search-input');
if (inp) { e.preventDefault(); inp.focus(); inp.select(); }
}
});
// Simple search: highlight matching text in main content
var searchInput = document.getElementById('docs-search-input');
if (searchInput) {
searchInput.addEventListener('input', function() {
var q = this.value.trim().toLowerCase();
if (!q) {
chapters.forEach(function(ch) { ch.style.display = ''; });
return;
}
chapters.forEach(function(ch) {
var text = ch.textContent.toLowerCase();
ch.style.display = text.includes(q) ? '' : 'none';
});
});
}
// Copy link button
var copyBtn = document.getElementById('copy-link-btn');
if (copyBtn) {
copyBtn.addEventListener('click', function() {
navigator.clipboard.writeText(window.location.href).then(function() {
copyBtn.querySelector('span, .icon') && null;
var orig = copyBtn.innerHTML;
copyBtn.innerHTML = '<i data-lucide="check" class="icon"></i>已复制';
if (window.lucide) lucide.createIcons();
setTimeout(function() { copyBtn.innerHTML = orig; if (window.lucide) lucide.createIcons(); }, 2000);
});
});
}
function sendFeedback(val) {
var fb = document.querySelector('.docs-feedback');
if (fb) fb.innerHTML = '<span style="color:var(--success-700);font-size:var(--text-md);">感谢您的反馈!</span>';
}
window.sendFeedback = sendFeedback;
document.addEventListener('DOMContentLoaded', function() {
buildRail();
setupScrollspy();
if (window.lucide) lucide.createIcons();
});
})();
</script>
<footer>
<div class="container">
<div class="footer-grid">
<div class="footer-brand">
<img src="/assets/logo-full.svg" alt="岩美" />
<p>为酒行与酒店设计的库存、审核、财务一体化管理平台。</p>
<div class="footer-contact">
<div><a href="mailto:yammy2023@163.com">yammy2023@163.com</a></div>
</div>
</div>
<div class="footer-col">
<h5>产品</h5>
<ul>
<li><a href="/#modules">核心模块</a></li>
<li><a href="/#platforms">多端覆盖</a></li>
<li><a href="/#reports">数据洞察</a></li>
<li><a href="/#pricing">价格方案</a></li>
<li><a href="/download/">版本更新</a></li>
</ul>
</div>
<div class="footer-col">
<h5>资源</h5>
<ul>
<li><a href="/docs/">使用手册</a></li>
<li><a href="/download/">下载客户端</a></li>
</ul>
</div>
<div class="footer-col">
<h5>客户支持</h5>
<ul>
<li><a href="/#faq">常见问题</a></li>
<li><a href="mailto:yammy2023@163.com">联系我们</a></li>
</ul>
</div>
<div class="footer-col">
<h5>公司</h5>
<ul>
<li><a href="/register/">注册门店</a></li>
</ul>
</div>
</div>
<div class="footer-bottom">
<div>© 2026 岩美科技 · 保留所有权利</div>
</div>
</div>
</footer>
<script src="/assets/nav.js"></script>
</body>
</html>