[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82680":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":13,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":15,"starSnapshotCount":15,"syncStatus":12,"lastSyncTime":27,"discoverSource":28},82680,"open-warehouse-system","BarneyD66\u002Fopen-warehouse-system","BarneyD66","Chinese-first open-source WMS starter for cross-border warehouse, fulfillment, inventory, billing, returns, and 3PL operations.",null,"TypeScript",144,2,1,11,0,22,298,62.43,"MIT License",false,"main",true,[],"2026-06-12 04:01:38","# Open Warehouse System\n\n[English README](README.en.md) | 中文说明\n\n中文优先的开源仓储管理系统 Starter，面向跨境电商、海外仓、3PL 和自营仓配团队。项目覆盖官网获客、客户自助门户、运营后台、仓库作业台、库存、入库、出库、账单、退货和物流轨迹等核心流程，适合作为轻量 WMS \u002F OMS \u002F TMS 一体化系统的参考实现。\n\n> English: an open-source WMS starter for cross-border warehouse operations, fulfillment, inventory, billing, returns, and customer self-service workflows.\n\n![Open Warehouse System preview](public\u002Fassets\u002Fuk-warehouse-brand-hero.png)\n\n## 为什么开源\n\n很多中小跨境团队需要的不是一套沉重 ERP，而是一个能快速跑通真实业务闭环的仓储系统底座。本项目把海外仓常见流程拆成可读、可改、可部署的 Next.js + PostgreSQL 应用，希望给以下团队一个可复制的起点：\n\n- 中国跨境卖家、英国\u002F欧洲海外仓和 3PL 服务商\n- 想从表格、微信群和人工对账迁移到结构化系统的运营团队\n- 正在学习 WMS、履约、库存流水、账单复核和退货质检流程的开发者\n- 需要一个中文业务语境下的 SaaS \u002F Ops 后台样板项目的团队\n\n## 核心能力\n\n- 官网和获客页：服务介绍、报价入口、询盘表单、费用说明、帮助中心\n- 客户门户：注册登录、客户资料、询盘、入库预报、SKU、出库、退货、账单、文件资料\n- 运营后台：询盘跟进、报价草稿、客户审核、入库\u002F出库推进、账单复核、异常和待办\n- 仓库作业台：入库收货、上架、出库拣货、打包复核、交运、库位和打印页\n- 库存底座：SKU 档案、库存余额、库存流水、库存调整审批、盘点和补货规划\n- 物流与账单：承运商规则、运费试算、面单\u002F追踪号、账单确认、付款凭证和异议处理\n- 数据层：本地 JSON fallback + PostgreSQL schema，便于从 demo 过渡到正式数据库\n- 验证材料：已有 lint\u002Fbuild\u002FPlaywright 验证记录和产品文档沉淀在 `docs\u002F`\n\n## 技术栈\n\n- Next.js 16 App Router\n- React 19\n- TypeScript\n- Tailwind CSS 4\n- PostgreSQL via `postgres`\n- Playwright for browser verification\n- Vercel-friendly deployment\n\n## 快速开始\n\n```bash\nnpm install\ncp .env.example .env.local\nnpm run dev\n```\n\n打开 \u003Chttp:\u002F\u002Flocalhost:3000>。\n\n常用入口：\n\n- `\u002F` 官网首页\n- `\u002Flogin` 客户登录和注册\n- `\u002Fportal` 客户工作台\n- `\u002Fops-login` 员工登录\n- `\u002Fops` 运营后台\n- `\u002Fwarehouse` 仓库作业台\n- `\u002Ftracking` 业务追踪\n\n开发环境会使用本地演示登录能力。生产环境请配置 `SESSION_SECRET`、`STAFF_WHITELIST_JSON`、`POSTGRES_URL` 或 `DATABASE_URL`，并关闭演示登录开关。\n\n## 数据库\n\n项目可以先用本地 `.local-data` 运行，也可以接入 PostgreSQL。\n\n```bash\nnpm run db:init\nnpm run db:migrate:local\n```\n\nSchema 位于 `db\u002Fschema.sql`。本地 JSON 到 PostgreSQL 的迁移脚本位于 `scripts\u002Fmigrate-local-json-to-postgres.mjs`。\n\n## 文档索引\n\n- `docs\u002F31-mvp-current-status.md`：当前 MVP 状态和验证记录\n- `docs\u002F25-self-operated-wms-prd.md`：自营仓储系统一期 PRD\n- `docs\u002F27-postgres-migration.md`：PostgreSQL 迁移说明\n- `docs\u002F35-launch-readiness-hardening.md`：上线前安全和配置检查\n- `docs\u002FCODEX_FOR_OSS_APPLICATION.md`：Codex for OSS 申请草稿\n- `docs\u002FOPEN_SOURCE_LAUNCH_CHECKLIST.md`：公开仓库发布清单\n- `docs\u002FGITHUB_REPO_PROFILE.md`：GitHub About、topics 和 release 文案\n- `docs\u002FINITIAL_ISSUES.md`：公开后可复制的首批 issues\n- `docs\u002FSTAR_AND_FORK_MESSAGE.md`：发给朋友帮忙 star\u002Ffork 的短文案\n- `docs\u002FARCHITECTURE.md`：系统架构和边界说明\n- `ROADMAP.md`：开源路线图\n\n## 适合贡献的方向\n\n- 更完整的 PostgreSQL 持久化和种子数据\n- 仓库作业移动端体验和扫码流程\n- 真实承运商 API、PDF\u002FZPL 面单和 webhook 回传\n- 多语言文案、英文文档和部署教程\n- RBAC、审计、文件存储和生产安全加固\n- Playwright 端到端测试和 GitHub Actions CI\n\n## 开源协议\n\nMIT License。你可以自由使用、修改和二次开发，但请不要提交真实客户资料、真实仓库地址、密钥或生产数据库连接串。\n","BarneyD66\u002Fopen-warehouse-system 是一个面向跨境电商、海外仓和3PL服务的中文优先开源仓储管理系统。项目基于Next.js和PostgreSQL构建，覆盖了从官网获客、客户自助门户到运营后台、仓库作业台及库存管理等核心流程，支持轻量级WMS\u002FOMS\u002FTMS一体化需求。特别适合需要快速搭建真实业务闭环的中小跨境团队使用，帮助他们从传统的表格、微信群管理和人工对账方式过渡到结构化系统。此外，对于正在学习相关领域技术或寻找中文环境下SaaS\u002FOps后台参考实现的开发者来说，这也是一个很好的起点。","2026-06-11 04:08:56","CREATED_QUERY"]