mirror of
https://github.com/ajisaacs/OpenNest.git
synced 2026-10-27 07:11:06 -04:00
A drawing set is a named list of library drawings with quantities (a kit,
an assembly, a recurring order) that will later be released into one nest
per material. This is the server half: sets get the same revision,
If-Match and archive contract as /api/drawings so the client and tests
follow a known shape.
Schema v7 adds drawing_sets, drawing_set_revisions and
drawing_set_members. Members reference drawings by id and mean each
drawing's current revision, so reads join the current drawing record:
the client can group members by material without one request per drawing,
and the joined record is ignored on save so a read record can be sent
back unchanged. Every change keeps its own member list, and
/api/drawings/{id}/sets answers "used in" from current revisions only.
The drawing query's enum, integer and history-paging parsing is now shared
so both APIs refuse bad input identically.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
141 lines
4.6 KiB
C#
141 lines
4.6 KiB
C#
using System.Text.Json;
|
|
using System.Text.Json.Nodes;
|
|
using OpenNest.Data;
|
|
|
|
namespace OpenNest.Server;
|
|
|
|
/// <summary>
|
|
/// Parses drawing set requests with the drawing library's strictness: unknown, repeated
|
|
/// or out-of-range values are rejected rather than ignored or clamped, and sort accepts
|
|
/// names only.
|
|
/// </summary>
|
|
internal static class DrawingSetRequest
|
|
{
|
|
private static readonly string[] QueryKeys =
|
|
{
|
|
"search", "customer", "includeArchived", "sort", "order", "offset", "limit",
|
|
};
|
|
|
|
private static readonly JsonSerializerOptions SetOptions = new(JsonSerializerDefaults.Web)
|
|
{
|
|
PropertyNameCaseInsensitive = true,
|
|
};
|
|
|
|
public static bool TryParseQuery(IQueryCollection values, out DrawingSetQuery query, out string error)
|
|
{
|
|
query = new DrawingSetQuery();
|
|
foreach (var key in values.Keys)
|
|
{
|
|
if (!QueryKeys.Contains(key, StringComparer.OrdinalIgnoreCase))
|
|
{
|
|
error = $"Unknown query parameter '{key}'.";
|
|
return false;
|
|
}
|
|
|
|
if (values[key].Count > 1)
|
|
{
|
|
error = $"Query parameter '{key}' was given more than once.";
|
|
return false;
|
|
}
|
|
}
|
|
|
|
var sort = DrawingSetSortField.SavedAt;
|
|
if (values.TryGetValue("sort", out var sortText) && !DrawingLibraryRequest.TryEnumName(sortText.ToString(), out sort))
|
|
{
|
|
error = $"sort must be one of: {string.Join(", ", Enum.GetNames<DrawingSetSortField>().Select(DrawingLibraryRequest.CamelCase))}.";
|
|
return false;
|
|
}
|
|
|
|
var descending = true;
|
|
if (values.TryGetValue("order", out var orderText))
|
|
{
|
|
if (string.Equals(orderText, "asc", StringComparison.OrdinalIgnoreCase))
|
|
{
|
|
descending = false;
|
|
}
|
|
else if (!string.Equals(orderText, "desc", StringComparison.OrdinalIgnoreCase))
|
|
{
|
|
error = "order must be asc or desc.";
|
|
return false;
|
|
}
|
|
}
|
|
|
|
var includeArchived = false;
|
|
if (values.TryGetValue("includeArchived", out var archivedText) && !bool.TryParse(archivedText.ToString(), out includeArchived))
|
|
{
|
|
error = "includeArchived must be true or false.";
|
|
return false;
|
|
}
|
|
|
|
var offset = 0;
|
|
var limit = DrawingSetQuery.DefaultLimit;
|
|
if (!DrawingLibraryRequest.TryInteger(values, "offset", ref offset, out error)
|
|
|| !DrawingLibraryRequest.TryInteger(values, "limit", ref limit, out error))
|
|
return false;
|
|
|
|
query = new DrawingSetQuery
|
|
{
|
|
Search = values["search"].ToString(),
|
|
Customer = values["customer"].ToString(),
|
|
IncludeArchived = includeArchived,
|
|
Sort = sort,
|
|
Descending = descending,
|
|
Offset = offset,
|
|
Limit = limit,
|
|
};
|
|
error = query.GetValidationError() ?? "";
|
|
return error.Length == 0;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Reads and validates one set JSON object. <c>members</c> must be present; each
|
|
/// member's joined <c>drawing</c> is ignored, so a record read from the server may be
|
|
/// sent back as it is.
|
|
/// </summary>
|
|
public static bool TryReadSet(string? json, out DrawingSetRecord record, out string error)
|
|
{
|
|
record = new DrawingSetRecord();
|
|
if (string.IsNullOrWhiteSpace(json))
|
|
{
|
|
error = "Missing set.";
|
|
return false;
|
|
}
|
|
|
|
try
|
|
{
|
|
if (JsonNode.Parse(json) is not JsonObject root)
|
|
{
|
|
error = "The set must be a JSON object.";
|
|
return false;
|
|
}
|
|
|
|
var members = root.FirstOrDefault(p => string.Equals(p.Key, "members", StringComparison.OrdinalIgnoreCase));
|
|
if (members.Key is null)
|
|
{
|
|
error = "members is required.";
|
|
return false;
|
|
}
|
|
|
|
if (members.Value is JsonArray array)
|
|
{
|
|
foreach (var member in array.OfType<JsonObject>())
|
|
{
|
|
foreach (var key in member.Select(p => p.Key)
|
|
.Where(k => string.Equals(k, "drawing", StringComparison.OrdinalIgnoreCase)).ToList())
|
|
member.Remove(key);
|
|
}
|
|
}
|
|
|
|
record = root.Deserialize<DrawingSetRecord>(SetOptions) ?? record;
|
|
}
|
|
catch (JsonException)
|
|
{
|
|
error = "Invalid set JSON.";
|
|
return false;
|
|
}
|
|
|
|
error = DrawingSetRules.GetError(record) ?? "";
|
|
return error.Length == 0;
|
|
}
|
|
}
|