federatedbookkeeping / timesheets

Federated Timesheets Project. Gitter: https://gitter.im/federatedbookkeeping/timesheets
MIT License
9 stars 1 forks source link

Presentation of completion milestones 4 and 1a #52

Closed michielbdejong closed 2 years ago

michielbdejong commented 2 years ago

I want to compose a Request for Payment for our milestones 4 and 1a. As proof of completion, I want to include a short recorded presentation that shows these two parts of what we built so far.

Rough script:

Milestone 1: Prejournal

Prejournal.org will be a headless bookkeeping connector that can take data from many types of source documents and export data to many different bookkeeping tools. It can be run as a stand-alone LAMP application, or as a Nextcloud app.

Deliverable: Tagged release of the code that does the following.

1a - 6000 EUR) Import timesheets data from the timetracker tools listed in the wiki (4) that allow data retrieval, either through an API or through a manual export-and-import flow, as well as relevant open standards (like caldav etc).

Milestone 4: Documentation

6000 EUR) Formats wiki - a wiki that describes all the various formats and protocols, including a list of target formats for items 1), 2) and 3), with a simple repeating example. The target formats will be an agreed sub-list of all the formats found. Including hosting costs and other expenses.

mcalligator commented 2 years ago

I like the idea of doing a pre-recorded presentation - nice!

I've a couple of questions and observations:

  1. For 1a, why use a non-federated time-tracking system to capture an entry in preference to one of our three federated tools? Would that not confuse matters? Or are you aiming to show that an arbitrary third-party system can be used to enter data, which will then be replicated to other systems federated to the one it is integrated with?
  2. For 4, given its expanded scope to encompass analysis of and findings from the project, do you envisage incorporating those into the presentation as well, given their importance in demonstrating how it has fulfilled its larger objectives, and the potential further work that could build on it? Or do you see the presentation as being an interim snapshot of where we've got to thus far?
michielbdejong commented 2 years ago

are you aiming to show that an arbitrary third-party system can be used to enter data, which will then be replicated to other systems federated to the one it is integrated with?

Exactly!

Apart from our initial tendency to try to define "yet another" single union format "to rule them all", which changed over time (as you documented) to a translations approach with multiple equally OK data formats, and all the understanding we gathered on the way about how to translate identifiers, I think the end result of our project still shows two interesting archeological marks:

https://docs.google.com/drawings/d/1y2PrBsfq0UtUVk0pYrsMlY0C7MckQFDYjqPkoGyv8hU/edit?usp=sharing timesheets network (2)

expanded scope to encompass analysis of and findings from the project, do you envisage incorporating those

Hm, I don't think I would do them justice - I just wanted to present the things that tick the boxes on the original milestones plan for now, to have something to send along with the Request for Payment today.

And then maybe in general we can work towards some sort of all-encompassing recorded presentation together, that covers your documentation work as well?

mcalligator commented 2 years ago

OK, understood. I'll DM you about the division of labour for Milestone 4 to ensure we're still on the same page.

michielbdejong commented 2 years ago

Part 1: https://youtu.be/w4Rd1IGFk_Q

michielbdejong commented 2 years ago

Part 2: https://youtu.be/VUTyv6FF0s0