foodcoops / foodsoft

Web-based software to manage a non-profit food coop (product catalog, ordering, accounting, job scheduling).

Foodsoft

Web-based software to manage a non-profit food coop (product catalog, ordering, accounting, job scheduling).

A food cooperative is a group of people that buy food from suppliers of their own choosing. A collective do-it-yourself supermarket. Members order their products online and collect them on a specified day. And all put in a bit of work to make that possible. Foodsoft facilitates the process.

If you're a food coop considering to use foodsoft, please have a look at the wiki page for foodcoops. When you'd like to experiment with or develop foodsoft, you can read how to set it up on your own computer.

More information about using this software and contributing can be found on the wiki.

Roadmap

If you'd like to see what is currently bring prioritised for development, check our roadmap. If you'd like to influence the roadmap, please join our monthly community call. As of March 2023, Foodsoft has limited development capacity but we are trying to build this up once more. For now, we try to prioritise what we work on, in order to focus our efforts. If your proposed changes are waiting for some time without review, please join the community call to discuss.

Developing

Foodsoft development needs your help! If you want to hack/triage/organise to improve the software, please consider joining our monthly community calls which are announced on this forum thread. In these calls, we check in with each other, discuss what to prioritise and try to make progress with development and community issues together.

Get foodsoft running locally, then visit our Developing Guidelines page on the wiki.

Get a foodsoft dev-environment running in the browser with Gitpod

Follow these instructions to complete setup from within the Gitpod workspace.

Deploying

Setup foodsoft to run in production, or join an existing hosting platform.

License

Foodsoft is licensed under the AGPL license (version 3 or later). Practically this means that you are free to use, adapt and redistribute the software, as long as you publish any changes you make to the code.

For private use, there are no restrictions, but if you give others access to Foodsoft (like running it open to the internet), you must also make your changes available under the same license. This can be as easy as forking the project on Github and pushing your changes. You are not required to integrate your changes back into the main Foodsoft version (but if you're up for it that would be very welcome).

To make it a little easier, configuration files are exempt, so you can just install and configure Foodsoft without having to publish your changes. These files are marked as public domain in the file header.

If you have any remaining questions, please open an issue or open a new topic at the forum.

Please see LICENSE for the full and authoritative text. Some bundled third-party components have other licenses.

Thanks to Icons8 for letting us use their icons.

foodsoft's Issues

link to old orders is broken

on ‘/ordering/myOrders’ pagination is broken.

Performance improvements

ist ja grauslich langsam. bitte ändern!

Layout of view finance/balancing/article overview is broken

The table layout is broken.

Menu is broken in Internet Explorer

I guess its just a litte css problem. Fixing should be easy.

Rest ins Lager

"Reste ins Lager"

Das Feature will ich auch haben!!

Allerdings finde ich den Lösungsvorschlag nicht so gut. Zumindest nicht von der User-Perspektive, denn eine Sonderbestellgruppe verwirrt nur, glaube ich. Vielmehr sollte der User nur die Möglichkeit haben

* Gebinde nach Bestellende "voll zu machen" (diese Mengen wandern dann ins Lager)
* bei der Abrechnung den Lageranteil transparent einsehen zu können. 

Ob das technisch dann eine Sonderbestellgruppe wird können wir ja nochmal beschnacken.

Ordering in finance/balancing broken for some article numbers

Some companies have article numbers in the format

sa2-02-001
ni2-93-250

With this type of article numbers currently no helpful ordering is performed.

Tags für Artikel

Die bisher oft in den Artikelnamen enthaltene Infos sollten in spezielle Felder/Tags usw. ausgegliedert werden: - vegan/vegetarisch (als Tag?) - Fair Trade (als Tag?) - Anbauregion/-land (am Artikel gepflegt, wird auch von Terra geliefert) - Herstellername (am Artikel gepflegt, wird auch von Terra geliefert)

Original-Reporter: Lassi

Infomails zu "Konto aktualisiert" oder "Bestellungen online" durch Foodsoft

Zur Erleichterung der Arbeit der Kontogruppe und der Palettengruppe, könnte die Software anbieten per Mausklick die Infomail "Konten aktualisiert" oder "Bestellungen online" zu versenden.

Dann müssten die Gruppen nicht extra noch in Ihre Mailprogramm wechseln.

Ich weiß derzeit gibt es damit keine Probleme oder zumindest kann ich micht nicht daran erinnern, aber vielleicht wäre es doch nett für die fleissigen Bienchen.

Vielleicht könnte auch eine halb-automatische Mail "Bestellungen rausgeschickt" geben, dann muss mensch nicht solange bangen, ob wirklich was kommt.

Vielleicht sollten wir dazu aber auch noch die Paletten/Konto/Bestell-Menschen befragen.

Ich könnte mir das ganze gut im Rahmen einer (mittel)größeren Umstellung bezüglich der Arbeitsablauf-Führung vorstellen. Eine Art Checklist am Rande, um sich durch die zuerledigenden Schritte für einen jeweiligen Arbeitsbereich zu hangeln. (Eine Art Mini-Howto/Don't forget list).

sandoz/foodsoft/issues zeigt E-Mail-Adresse nicht an

Ist das ein Feature?

Ich glaube nicht, oder?

Move foodsoft-config into own database table

Otherwise foodcoops can't modify the config for themselfs if they can't access the config file. (Which is the case for our hosting solution)

Make customizable if tolerance is costly

If you participate in an order, increase tolerance for an article decreases the amout of available money of your account.

This give a negative incentive to use tolerance. There should be an configuration option to change this behaviour to ignoring tolerance values until the order is finished. This could give negative account balances, but this is IMHO no problem.

Order directly from supplier via mail

When an order was finished, there should be an easy way to send an email to the supplier with the article list. The mailtext should be editable, so the user can add/remove some articles.

Accounting by groups in finance view

(For an English description see comments below.)

Für die Abrechnung von Bestellungen ist es hilfreich, wenn die Artikel auch in der "Gruppenübersicht" abgerechnet werden könnten.

Die Kommentar zu den Bestellungen beziehen sich ja immer auf Artikel einer Gruppe, so dass die Finanzperson für jede zu bearbeitende Gruppe durch die ganze Liste der Artikel springen muss, um die Artikel zu bearbeiten, dass ist mehr Arbeit, als wenn Sie sich alle Artikel zu einer Bestellgruppe anzeigen lassen könnte und diese dann bearbeiten kann.

Original-Reporter: Johanna

edit group link in tasks/ordergroups is broken

Umfrage-Tool

Mit unserem User-Management lässt sich doch sicher ein einfaches Umfrage-Tool erzeugen.

Wir bräuchten das Modell poll mit attributen:

* question
* answers, die möglichen antworten als Array. oder doch besser in eigenem Modell?
* begin, der Startzeitpunk
* end, jede Umfrage muss zu ende gehen
* timestamps
* (optional) groups, array mit ids der verschiedenen Gruppen, für "kleine" Umfragen, die einzelne Gruppen betreffen 

Die Antworten werden dann über eine join-table aus Usern und Umfragen gespeichert. z.b. Votings:

* poll_id
* user_id
* answer, hier wird festgelegt, welche Antwort ausgewählt wurde, z.b. integer
* created_at, wann wurde die Stimme abgegeben? 

Durch die feste Bindung an den User können wir hiermit endlich mal vollständige Mitgliederbefragungen durchführen. auf den Plena sind ja immer nur teile der Foodcoop vertreten.

Fragen:

• [create, update, destroy] schützen? d.h. soll es Umfrage-Beauftragte geben?
• Sollen die Umfragen kommentiert werden können?

Einladen-Link auf der Mitglieder-bearbeiten-Seite kaputt.

Site wide announcements

sieh z.b. "railscast":http://railscasts.com/episodes/103-site-wide-announcements

Wiki Template "Aktuelles" auf die Startseite

Wäre gut, wenn man ein kleines Wiki-Fenster (aktuelles) oben in der Startseite hätte. Das könnte sehr gut zur internen Kommunikation genutzt werden.

Login Seite sollte als Titel "FoodSoft Login" heißen

oder FoodSoft Anmeldung oder so...

Artikelanzahl in StockIt

Für die Artikelansicht im Lager wäre es toll, wenn auch eine kurze Summe der aktuellen Artikel erschiene, also z.B. als Überschrift

"Artikelübersicht: 33 Artikel im Lager"

Original-Reporter: Stephan

migrate from trac to github?

Now there is an ticket system on github available. So should we use it instead of trac. Lets try it out…

Show all recipients of message

When a foodsoft message is sent, only the user who reads it is shown as recipient even when there are multiple recipients.

Suggestion: store groups and users with the message, and show groups and users as recipients.
Example: Sorting group, benni, horst, peter

Original text: Empfänger in Nachrichten auflisten Momentan steht als Empfänger in einer Foodsoft-Nachricht immer nur ein user (der, der die mail bekommt). Alle anderen Empfänger bleiben verborgen und das ist beim Antworten blöd.
Damit bei einer Mail an "alle" aber nicht alle Foodcoop-Mitglieder angezeigt werden sollten wir als Empfänger noch die Gruppen und eben "alle" mit speichern. Dann würde in der Mail stehen:
Empfängerinnnen: Sortiergruppe, benni, horst, peter

Artikelabkürzung of unzureichend

Die Artikel-Kürzel, die auf den Sortierlisten in der Matrix gedruckt werden, sind oft nicht sehr gut. Man versteht sie schlecht und es gibt doppelte Bezeichnungen. Vielleicht könnte man ein paar mehr Buchstaben zulassen und die Titelzeile einfach um 90° drehen. Dann könnten allerdings pro Seite weniger Bestellgruppen gelistet werden.

Original-Reporter: Alex

Persönliche Bestellübersichten übersichtlicher machen

z.b. durch Ausblendung von allen Artikeln, die ich nicht bestellt habe (derzeit in grau). Geht vielleicht einfacher per javascript und ein paar Optionshaken, wie "verstecke nicht bestellte Artikel"

feedback feature for users

I would like to have a button (nearby the help-link), which popups a new text-field where users can input feature-request, problem etc.
The text should be automaticly send to an support-mail-address.

Anhänge für Wiki-Seiten

Es wäre cool, wenn wir möglichst bald Anhänge für Wikiseiten anbieten könnten, da im alten Wiki doch ein paar solcher Seiten existieren. Zum Beispiel-Preislisten der Anbieterinnen.

Search for members on members page should include login name

stephan reported this issue. thanks.

Kommentar zu Artikel sollte bei Erstellen der Bestelllung geändert werden können

Wenn man eine Bestellung zusammenstellt, und zu einem Artikel einen Kommentar (Glühbirnchen) eingeben möchte, muss man dies über den Umweg der Artikeldatenbank tun.

Es wäre wünschenswert, wenn man diesen Kommentar direkt beim Zusammenstellen der Bestellung eingeben bzw den vorgegebenen Kommentar (einmalig oder dauerhaft) ändern könnte. Oft sind diese Kommentare auch nur für diese eine Bestellung gültig und dann ist es unnötig, sie in der Artikeldatenbank zu speichern.

Also das einfachste wäre eine Direkt-Editier-Funktion für die Artikelnotiz in der Bestellauswahl. Das müsste ich hinbekommen.

Original-Reporter: Stephan

typo on register page

"Du bist eingeladen worden in der Foodcoop Administrators mitzumachen. " Das sollte wohl Gruppe heißen.

Salat wird immer teuerer nach Bestellende

keine Ahnung warum???

stockit: articles with negative stock amount shouldn't be listed during order create

Currently only articles with an stock amount of zero aren't shown to select when creating a new stockorder. This ticket requests the same behaviour for articles with an amount lower than zero.

avoid unmeant duplicate entries of articles

mareike: könntest du einrichten, dass, wenn man einen neuen artikel in die palette aufnimmt, der schon drin ist, dies angezeigt wird. so könnten wir die vielen dopplungen verhindern und es macht das palettieren auch viel einfacher, hinsichtlich der essenswünsche.

Adressangabe Bestellgruppe zuordnen und nicht dem User

Momentan werden die Kontaktdaten ja ausschließlich an den User gehangen. Das ist insofern nicht dry, weil viele Nutzer u.U. die gleichen Kontaktdaten eingeben müssten. Sinnvoller wäre, das ganze an die Gruppe zu hängen. Also Adresse, Telefon 1 und 2, URL ;-)

Der User sollte eine eigene Telefonnummer optional angeben können. Und ein Bild natürlich.

in view finance/balancing the prices for a whole set of ordered articles is wrongly calculated.

In view finance/balancing

Menge GebGr \* Einheit Netto Brutto MwSt Pfand
2 1 \* St 2,27 / 4,54 2,43 / 4,86 7.0 0

the prices 2 and 4 are wrongly calculated, if the ‘gebinde’ is not 1.

suppliers/view zeigt E-Mail-Adresse nicht an

Ist das ein Feature?

Ich glaube nicht, oder?

Vote for edit-invoice link in balancing page

After creating an invoice during the balancing process, there is currently no link to edit the invoice data. Users are confused ....

Inform users about javascript dependency

Sometimes users deactivate javscript (e.g. through noscript plugin) and therefore they got some problems. The javascript note on session start page should be more visible.

Notizfunktion für Lagerlieferung

ein Wunsch: Es wäre gut, beim Anlegen einer Lagerlieferung eine Notiz eingeben zu können.

Original-Reporter: Stephan

Group editing is broken ...

in namespace /foodcoop/edit_group/

bestellgruppensummen werden bei Abrechnung nicht korrekt aktualisiert.

Beispiel Lieferung nicht gekommen. Werden nur die Artikel aus der Bestellung gelöscht, dann werden die Gruppensummen nicht aktualisiert und es würden falsche Summen den Gruppen abgebucht. Dringend beheben!

"low watermark" entries for stock articles

We need a kind of stock amount tracker. Stephan's idea: Implement a "low watermark" value and notify a specific workgroup when current stock amount falls below this entry.

Send order notifications into background

The notification of e.g. 30 groups with about 60 users takes a lot time. Why not moving this feature into a background prozess (a.k.a. rake task)

Typo auf Bestellanzeigenseite wenn nicht bestellt wurde

Dann steht da "... das ist dein Chance (Link)", auch dann, wenn die Bestellung schon beendet wurde.

Artikel-bearbeiten-Ansicht springt zurück auf default-paginate-Wert

Wenn ich Artikel bearbeite in der FoodSoft, und dabei für die Ansicht wähle, dass ich mehr als 30 Artikel gleichzeitig anzeigen möchte und dann einen Artikel per Auswahl und drop-down-Menü (unten) als nicht mehr verfügbar markiere dann ist die Ansicht wieder beim Defaultwert von 30 und nicht mehr bei meiner Wunschansicht.

Original-Reporter: Stephan

Default order in view finance/balancing not ordered order

It seems, that the default ordering in view finance/balancing is now by article name and not the order it was ordered.

With that it’s difficult to balance a Terra order.

Article statistics

(see English translation in comment below)

Wir könnten eine Statistik generieren, welche Artikel wie oft gekauft wurden.
In der Paletten-Auswahl könnte mensch dann die Artikel nach Beliebtheit sortieren. Vielleicht macht das die Palette einfacher. Zumindest könnte mensch so die Produkte aussortieren, die niemals bestellt wurden.

Man müsste noch mal darüber nachdenken, ob wir die "angeklickten" (gewünschten) Artikel oder die tatsächlich bestellten Artikel oder beides zählen wollen.

Original-Reporter: hullewuppe

Wikiseiten-Parent bearbeiten können

Wenn ich eine Wikiseite angelegt habe, kann ich im Moment den Parent nicht verändern.

Wir könnten eine "Elternseite verändern"-Link in pages/edit anzeigen und dann ein Dropdown präsentieren, um das neue Elternteil auszuwählen.

Option anbieten Wikiseiten-Titel zuverändern ohne Titel-Historie zuverändern.

Wenn ich derzeit den Titel einer Wikiseite verändere, dann werden zukünftige Request auf den alten Titel zum neuen Titel weitergeleitet.
Das ist ansich ein cooles Feature, es gibt allerdings Fälle (s.u.), in denen ich das nicht will, daher wäre es gut eine Option im pages/edit zu haben.

Wenn ich unter "Thema-Test" eine neue Version erstmal über eine Zeit entwickeln möchte, ohne dass die schon in Produktion befindliche Seite "Thema" zuverändern, dann möchte ich nach abschluß meiner Arbeiten "Thema-Test" in "Thema" umbenennen. Damit ich das machen kann muss ich "Thema" in "Thema-alt" umbenennen. Wenn jetzt die Titel-Historie allerdings verändert wird, dann ist der Titel "Thema" weiterhin besetzt und ich kann "Thema-Test" nicht in "Thema" umbennenen.

Stockit: Hide articles with a stock amount of zero

The default stockit view should hide articles with an amount lower than 1. But, viewing all stockarticles should be possible.

Kontext-bezogene Hilfe

Wir brauchen dringen eine vernünftige Dokumentation. Am besten wäre das kontext-bezogen, damit bei einem Problem nicht lange gesucht werden muss.

Als Anfang folgender Vorschlag:

Wir platzieren beim Logout-Link einen Link "Hilfe". Der Link wird dynamisch erzeugt und adressiert eine bestimmte Hilfe-seite, bezogen auf den aktuellen controller/action. Beispiel:

# articles/list/4
 ....
<a href="help/articles/list">Hilfe...

Im Controller wird dann auf eine Seite mit der Hilfe zur "Artikelansicht" geroutet.

Die Hilfe-Seite sollte sich außerdem in einem neuen Fenster öffnen, damit man parallel lesen kann.

Vorteil: Wir brauchen nicht in jeder neuen Seite irgendwelche Hilfe-Buttons integrieren, und hätten an zentraler Stelle alle Inhalte. man könnte auch leicht die Hilfeseiten untereinander verlinken.

Vorher muss das Wiki integriert sein.