seb/dashback
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

file meta

Browse Source
This commit is contained in:
seb
2026-09-18 05:20:03 +02:00
parent bbd285109d
commit 8c19388901
6 changed files with 334 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

87
src/api/openapi.js
View File

@@ -422,12 +422,97 @@
* allOf:
* - $ref: '#/components/schemas/DeliverySummary'
* - type: object
* required: [lines]
* required: [lines, files]
* properties:
* lines:
* type: array
* items:
* $ref: '#/components/schemas/DeliveryLine'
* files:
* type: array
* description: Attached documents (pdf/txt) for the delivery
* items:
* $ref: '#/components/schemas/DeliveryFile'
* DeliveryFile:
* type: object
* description: Attachment metadata (binary content is served via the attachment content endpoints)
* required: [id, manifestId, fileId, sort, hash, mimetype, name, size]
* properties:
* id:
* type: integer
* description: manifestattachment id
* manifestId:
* type: integer
* fileId:
* type: integer
* sort:
* type: integer
* hash:
* type: string
* description: SHA-256 of the file content
* mimetype:
* type: string
* description: application/pdf or text/plain
* name:
* type: string
* size:
* type: integer
* created:
* type: string
* format: date-time
* modified:
* type: string
* format: date-time
* thumbavif:
* type: string
* format: byte
* nullable: true
* thumbx:
* type: integer
* nullable: true
* thumby:
* type: integer
* nullable: true
* meta:
* type: object
* nullable: true
* description: String key/value metadata from the file row
* additionalProperties:
* type: string
* DeliveryFileInput:
* type: object
* required: [mimetype, name, content]
* description: Attachment input. Only application/pdf and text/plain are accepted.
* properties:
* mimetype:
* type: string
* enum: [application/pdf, text/plain]
* name:
* type: string
* content:
* type: string
* format: byte
* description: File content (base64-encoded in JSON)
* sort:
* type: integer
* description: Optional sort order (defaults to appending after existing files)
* size:
* type: integer
* description: Optional size in bytes (defaults to content length)
* hash:
* type: string
* description: Optional SHA-256 (auto-computed if omitted)
* created:
* type: string
* format: date-time
* modified:
* type: string
* format: date-time
* meta:
* type: object
* description: Optional string key/value metadata stored with the file
* additionalProperties:
* type: string
* ManifestLine:
* type: object
* required: [id, sku, name, pu, amount, net, rebate, taxrate, comment]

30
src/api/routes/delivery.js
View File

@@ -107,6 +107,13 @@ export function register(app, basePath = '') {
* type: array
* items:
* $ref: '#/components/schemas/DeliveryLineInput'
* files:
* type: array
* description: |
* Attached documents (pdf or txt) stored with the delivery
* and returned in `files` on every delivery response.
* items:
* $ref: '#/components/schemas/DeliveryFileInput'
* example:
* externalNumber: DHL-123
* date: '2026-08-10'
@@ -118,6 +125,10 @@ export function register(app, basePath = '') {
* amount: 10
* net: 99.5
* taxrate: 19
* files:
* - mimetype: application/pdf
* name: delivery-note.pdf
* content: '<base64 encoded content>'
* responses:
* 201:
* description: Created delivery
@@ -129,7 +140,7 @@ export function register(app, basePath = '') {
* delivery:
* $ref: '#/components/schemas/Delivery'
* 400:
* description: Invalid delivery, invalid lines, or no company selected
* description: Invalid delivery, invalid lines or files, or no company selected
* content:
* application/json:
* schema:
@@ -147,7 +158,7 @@ export function register(app, basePath = '') {
* schema:
* $ref: '#/components/schemas/Error'
* 404:
* description: Company, supplier, or article not found
* description: Company or supplier not found
* content:
* application/json:
* schema:
@@ -175,7 +186,7 @@ export function register(app, basePath = '') {
return res.status(400).json({ error: selected.error });
}
const { externalNumber, date, supplierId, lines } = req.body ?? {};
const { externalNumber, date, supplierId, lines, files } = req.body ?? {};
try {
const delivery = await db.create(req.user.id, {
@@ -183,6 +194,7 @@ export function register(app, basePath = '') {
date,
supplierId,
lines,
files,
});
res.status(201).json({ delivery });
} catch (error) {
@@ -280,6 +292,13 @@ export function register(app, basePath = '') {
* type: array
* items:
* $ref: '#/components/schemas/DeliveryLineInput'
* files:
* type: array
* description: |
* Appends attachments (pdf or txt) to the delivery.
* Omit to leave existing files unchanged.
* items:
* $ref: '#/components/schemas/DeliveryFileInput'
* example:
* externalNumber: DHL-124
* lines: []
@@ -312,7 +331,7 @@ export function register(app, basePath = '') {
* schema:
* $ref: '#/components/schemas/Error'
* 404:
* description: Delivery, supplier, article, or company not found
* description: Delivery, supplier, or company not found
* content:
* application/json:
* schema:
@@ -405,6 +424,9 @@ export function register(app, basePath = '') {
if (Object.prototype.hasOwnProperty.call(body, 'lines')) {
patch.lines = body.lines;
}
if (Object.prototype.hasOwnProperty.call(body, 'files')) {
patch.files = body.files;
}
try {
const delivery = await db.update(req.user.id, id, patch);