Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Account for allocated vs unallocated inventory

未关闭
#5,667 3 条评论 0 个 reaction 已指派 1 人 在 GitHub 查看

维护者通常 1 天内回复

@awwaiid 已经在做这个了。

开始于 2026年9月28日。

  • #5696 来自 @armahillo —— 未关闭

评估

这个 Issue 还没有评估数据。

描述

Difficulty—Advanced Ruby for Good 2026 DC

This issue is to track exploration around this whole problem domain, so that we have some place to take notes and link PRs against. Any work we do immediately will need to have a neutral or considered impact on users.


  • Architecture design of the event level tracking of allocated
  • Looking at reports for allocated inventory
  • Maybe this only matters for audits
  • Make sure people are marking their distributions as "completed" -- encourage them, show them the consequences of not doing it
  • Lift up actions into the main distribution row -- button for "complete"

Survey current state of world

  • How many / how often / how recent are incomplete distributions?

Architecture design of the event level tracking of allocated

  • Add a new datapoint of allocated inventory to events
  • Show unallocated everywhere we currently show quantities

Fix audits/adjustments:

  • In Audit, give error if they adjust the inventory to below allocated total
  • In Adjustments, give error if they adjust the inventory to below the allocated total

Improve distribution completion compliance

  • Show a persistent non-dismissable banner when there are incomplete distributions past their estimated distribution date
  • Make it easy to mark distributions as complete by bringing the button onto the distribution list page

Comment from CL:

  1. I worry that we're setting ourselves up for a whole lot of pain to support what sounds like a pretty non-standard business practice. 2. Some of the things in the above will end up breaking the system if, for example, they have a theft.

Straw Man from CL:

Simplest? Way to handle this As much as possible restrict changes to just the audit process

On “New Audit”

Give a strong suggestion that they complete any distributions that have “left the building” as far as auditing is confined.

On saved audits:

When we have a saved-in-progress audit

I believe we show the Quantity in Records. This should show “Unallocated”. TBD: also show “allocated” as the number of that item in distributions that have not been completed, and perhaps a “Physical expected” which would be the sum

Warn them again on confirming?

Similar changes on confirmed audits

On finalizing audit:

Have a Big Ol’ “You must confirm that all distributions that have “left the building” are marked complete before finalizing the audit, or your new inventory available for allocation will be wrong,
give a list of all the incomplete distributions
Allow them to mark them all complete with 1 button or to handle them individually (possibly by going back to the distributions list).
If there are any incomplete distributions, they have to say: “I acknowledge that the items earmarked for not-completed distributions are included in the physical counts for this audit”;
Then, when they hit the final finalize, the new values in the inventory will be calculated to be the physical values - the earmarked values.

Historical audits

What are the implications for looking at historical audits — not just the ones we have now, but the new ones looking back?

We’ll want to have a “physical” column, an “unallocated in records” and a “allocated in records” Maybe put a “Current” on those, to keep it clear.

We'll also want a disclaimer re before we implement this.

Impact:

Maybe new fields on Audit, maybe not?

At the end of the day, all the inventory numbers are still unallocated.

Does that solve the problem?

主要语言
Ruby
星标
594
派生
596
平均合并
1 天 17 小时
30 天内合并 PR
12

环境准备

在 Codespaces 中打开

在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

rubyforgood/human-essentials 的其他 Issue

查看 rubyforgood/human-essentials 的全部 Issue

相似的 Issue

更多 Ruby Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。