Add migration to include AccruedExpensesCode in gl_account_config table
- Introduced a new column 'AccruedExpensesCode' of type varchar(20) to the 'gl_account_config' table. - Added SQL command to update existing records with a default value of '2300' for the 'AccruedExpensesCode' where it is currently null.
This commit is contained in:
Dhananjaya99
@@ -2,6 +2,7 @@ using ERPCore.Domain;
|
||||
using ERPCore.Domain.Entities;
|
||||
using ERPCore.Domain.Enums;
|
||||
using ERPCore.Dtos.Approvals;
|
||||
using ERPCore.Dtos.Common;
|
||||
using ERPCore.Dtos.Notifications;
|
||||
using ERPCore.Dtos.Products;
|
||||
using ERPCore.Dtos.Stock;
|
||||
@@ -28,7 +29,8 @@ public class DualApprovalTests
|
||||
// Requester, two approvers, and a clerk who can approve but isn't a manager.
|
||||
private const int Requester = 10, ApproverA = 11, ApproverB = 12, Clerk = 13;
|
||||
private const int ApproverRoleId = 2, ClerkRoleId = 3;
|
||||
private const int ItemId = 1, WarehouseId = 1, ReasonId = 1;
|
||||
// ReasonId is an ordinary adjustment reason (VAR); WastageReasonId is a wastage one (DMG), which has its own approval switch.
|
||||
private const int ItemId = 1, WarehouseId = 1, ReasonId = 1, WastageReasonId = 2;
|
||||
|
||||
// --- Stock adjustments ------------------------------------------------------------------
|
||||
|
||||
@@ -226,11 +228,95 @@ public class DualApprovalTests
|
||||
public void RequiredLevels_FollowTheSettings(int configured, double threshold, double measure, int expected)
|
||||
=> Assert.Equal(expected, ApprovalService.Levels(configured, (decimal)threshold, (decimal)measure));
|
||||
|
||||
// --- Wastage: its own approval switch ------------------------------------------------------
|
||||
|
||||
[Fact]
|
||||
public async Task Wastage_WithTheSwitchOff_ReducesStockAtOnce_EvenWhenAdjustmentsNeedTwoApprovals()
|
||||
{
|
||||
var h = await Harness.CreateAsync(stockLevels: 2, wastageLevels: 0);
|
||||
|
||||
var dto = await h.Stock.CreateAsync(Request(-3, WastageReasonId));
|
||||
|
||||
Assert.Equal(AdjustmentStatus.Posted, dto.Status);
|
||||
Assert.Equal(0, dto.RequiredApprovals);
|
||||
Assert.Single(h.Mutator.Calls);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public async Task Wastage_WithTheSwitchOn_IsARequest_AndMovesNothingUntilApproved()
|
||||
{
|
||||
var h = await Harness.CreateAsync(stockLevels: 0, wastageLevels: 2);
|
||||
|
||||
var dto = await h.Stock.CreateAsync(Request(-3, WastageReasonId));
|
||||
|
||||
Assert.Equal(AdjustmentStatus.PendingApproval, dto.Status);
|
||||
Assert.Equal(2, dto.RequiredApprovals);
|
||||
Assert.Empty(h.Mutator.Calls);
|
||||
|
||||
h.User.Be(ApproverA);
|
||||
await h.Stock.ApproveAsync(dto.AdjustmentId, null);
|
||||
Assert.Empty(h.Mutator.Calls); // one of two: still nothing
|
||||
h.User.Be(ApproverB);
|
||||
var posted = await h.Stock.ApproveAsync(dto.AdjustmentId, null);
|
||||
Assert.Equal(AdjustmentStatus.Posted, posted.Status);
|
||||
Assert.Single(h.Mutator.Calls);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public async Task TheWastageSwitch_DoesNotLoosenOrdinaryAdjustments_AndTheirLevelsDoNotTouchWastage()
|
||||
{
|
||||
var h = await Harness.CreateAsync(stockLevels: 2, wastageLevels: 0);
|
||||
|
||||
// An ordinary adjustment (not a wastage reason) still needs two approvals.
|
||||
var ordinary = await h.Stock.CreateAsync(Request(-3));
|
||||
Assert.Equal(AdjustmentStatus.PendingApproval, ordinary.Status);
|
||||
|
||||
// A stock GAIN with a wastage reason is not wastage, so it follows the adjustment levels too.
|
||||
var gain = await h.Stock.CreateAsync(Request(+3, WastageReasonId));
|
||||
Assert.Equal(AdjustmentStatus.PendingApproval, gain.Status);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public async Task WastageList_ReturnsOnlyAdjustmentsWithAWastageReason()
|
||||
{
|
||||
var h = await Harness.CreateAsync(stockLevels: 0, wastageLevels: 0);
|
||||
await h.Stock.CreateAsync(Request(-1, WastageReasonId));
|
||||
await h.Stock.CreateAsync(Request(-2));
|
||||
|
||||
var all = await h.Stock.ListAsync(new PageQuery { Page = 1, PageSize = 50 }, null, null, null);
|
||||
var wastage = await h.Stock.ListAsync(new PageQuery { Page = 1, PageSize = 50 }, null, null, null, null, CancellationToken.None, wastageOnly: true);
|
||||
|
||||
Assert.Equal(2, all.Items.Count);
|
||||
var only = Assert.Single(wastage.Items);
|
||||
Assert.Equal(WastageReasonId, only.ReasonCodeId);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public async Task WastageList_CanBeNarrowedToOneItem()
|
||||
{
|
||||
var h = await Harness.CreateAsync(stockLevels: 0, wastageLevels: 0);
|
||||
await h.Stock.CreateAsync(Request(-1, WastageReasonId));
|
||||
|
||||
var forItem = await h.Stock.ListAsync(new PageQuery { Page = 1, PageSize = 50 }, null, null, null, null, CancellationToken.None, wastageOnly: true, itemId: ItemId);
|
||||
var otherItem = await h.Stock.ListAsync(new PageQuery { Page = 1, PageSize = 50 }, null, null, null, null, CancellationToken.None, wastageOnly: true, itemId: 999);
|
||||
|
||||
Assert.Single(forItem.Items);
|
||||
Assert.Empty(otherItem.Items);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void WastageApproval_IsOffByDefault_AndTheSettingIsReadBack()
|
||||
{
|
||||
Assert.Equal(0, new ApprovalConfig().WastageLevels);
|
||||
Assert.True(ERPCore.Domain.WastageReasonCodes.IsWastage("dmg"));
|
||||
Assert.False(ERPCore.Domain.WastageReasonCodes.IsWastage("VAR"));
|
||||
}
|
||||
|
||||
// --- helpers ------------------------------------------------------------------------------
|
||||
|
||||
private static CreateAdjustmentRequest Request(decimal qty) => new()
|
||||
private static CreateAdjustmentRequest Request(decimal qty, int reasonId = ReasonId) => new()
|
||||
{
|
||||
WarehouseId = WarehouseId, BranchId = 1, ReasonCodeId = ReasonId,
|
||||
WarehouseId = WarehouseId, BranchId = 1, ReasonCodeId = reasonId,
|
||||
Lines = [new CreateAdjustmentLineInput { ItemId = ItemId, QtyDelta = qty }]
|
||||
};
|
||||
|
||||
@@ -250,7 +336,7 @@ public class DualApprovalTests
|
||||
public required AdjustmentService Stock { get; init; }
|
||||
public required PriceAdjustmentService Prices { get; init; }
|
||||
|
||||
public static async Task<Harness> CreateAsync(int stockLevels = 2, decimal stockThreshold = 0, string? level2RoleIds = null)
|
||||
public static async Task<Harness> CreateAsync(int stockLevels = 2, decimal stockThreshold = 0, string? level2RoleIds = null, int wastageLevels = 0)
|
||||
{
|
||||
var db = new ErpDbContext(
|
||||
new DbContextOptionsBuilder<ErpDbContext>().UseInMemoryDatabase(Guid.NewGuid().ToString("N"), Root).Options,
|
||||
@@ -279,11 +365,14 @@ public class DualApprovalTests
|
||||
db.Uoms.Add(new Uom { UomId = 1, Name = "pcs" });
|
||||
db.Items.Add(new Item { ItemId = ItemId, Sku = "SKU-1", Name = "Cola", BaseUomId = 1, CategoryId = 1,
|
||||
SellingMinPrice = 90m, SellingMaxPrice = 150m, SellingFlatPrice = 100m });
|
||||
db.ReasonCodes.Add(new ReasonCode { ReasonCodeId = ReasonId, Code = "DMG", Description = "Damage", Context = ReasonContext.Adjustment });
|
||||
db.ReasonCodes.AddRange(
|
||||
new ReasonCode { ReasonCodeId = ReasonId, Code = "VAR", Description = "Variance", Context = ReasonContext.Adjustment },
|
||||
new ReasonCode { ReasonCodeId = WastageReasonId, Code = "DMG", Description = "Damage", Context = ReasonContext.Adjustment });
|
||||
db.ApprovalConfig.Add(new ApprovalConfig
|
||||
{
|
||||
ApprovalConfigId = ApprovalConfig.SingletonId, StockAdjustmentLevels = stockLevels,
|
||||
StockAdjustmentLevel2ThresholdValue = stockThreshold, PriceAdjustmentLevels = 2, Level2RoleIds = level2RoleIds
|
||||
StockAdjustmentLevel2ThresholdValue = stockThreshold, PriceAdjustmentLevels = 2, Level2RoleIds = level2RoleIds,
|
||||
WastageLevels = wastageLevels
|
||||
});
|
||||
await db.SaveChangesAsync();
|
||||
|
||||
|
||||
@@ -29,8 +29,8 @@ public sealed class StockAdjustmentsController : ApiControllerBase
|
||||
[ProducesResponseType(typeof(PagedResponse<AdjustmentSummaryDto>), StatusCodes.Status200OK)]
|
||||
public async Task<ActionResult<PagedResponse<AdjustmentSummaryDto>>> List(
|
||||
[FromQuery] PageQuery query, [FromQuery] int? warehouseId, [FromQuery] int? branchId, [FromQuery] int? reasonCodeId,
|
||||
[FromQuery] AdjustmentStatus? status, CancellationToken ct)
|
||||
=> Ok(await _adjustments.ListAsync(query, warehouseId, branchId, reasonCodeId, status, ct));
|
||||
[FromQuery] AdjustmentStatus? status, CancellationToken ct, [FromQuery] bool wastage = false, [FromQuery] int? itemId = null)
|
||||
=> Ok(await _adjustments.ListAsync(query, warehouseId, branchId, reasonCodeId, status, ct, wastage, itemId));
|
||||
|
||||
/// <summary>Get one adjustment with its lines, approval trail and the ledger entries it posted.</summary>
|
||||
[HttpGet("{adjustmentId:int}")]
|
||||
|
||||
@@ -35,6 +35,10 @@ public class ApprovalConfig
|
||||
/// <summary>With 2 levels: an adjustment whose stock value is below this needs only one approval. 0 = always two.</summary>
|
||||
public decimal StockAdjustmentLevel2ThresholdValue { get; set; }
|
||||
|
||||
/// <summary>Approvals wastage (damage / theft / expiry write-offs) needs: 0 = none, stock reduces on save (default);
|
||||
/// 2 = two different approvers first. Separate from <see cref="StockAdjustmentLevels"/>, which governs every other adjustment.</summary>
|
||||
public int WastageLevels { get; set; }
|
||||
|
||||
public int PriceAdjustmentLevels { get; set; } = 2;
|
||||
/// <summary>With 2 levels: a change smaller than this percent (largest across its lines) needs only one approval. 0 = always two.</summary>
|
||||
public decimal PriceAdjustmentLevel2ThresholdPercent { get; set; }
|
||||
|
||||
@@ -60,6 +60,7 @@ public class GlAccountConfig
|
||||
|
||||
/// <summary>Cash takings at day-end (was <c>SalesDayEnd:GlCashAccountCode</c>).</summary>
|
||||
public string? CashAccountCode { get; set; }
|
||||
public string? AccruedExpensesCode { get; set; }
|
||||
|
||||
public DateTime? UpdatedAt { get; set; }
|
||||
|
||||
|
||||
@@ -0,0 +1,13 @@
|
||||
namespace ERPCore.Domain;
|
||||
|
||||
/// <summary>
|
||||
/// Which Adjustment reason codes make a stock adjustment "wastage" (damage, theft, expiry). Wastage is stored as a stock
|
||||
/// adjustment; this is what tells the two apart. Matches the frontend's <c>isWastageReasonCode</c> (lib/api/wastage.ts).
|
||||
/// </summary>
|
||||
public static class WastageReasonCodes
|
||||
{
|
||||
public static readonly IReadOnlyCollection<string> Codes = new[] { "DMG", "THEFT", "EXP" };
|
||||
|
||||
public static bool IsWastage(string? reasonCode) =>
|
||||
reasonCode is not null && Codes.Contains(reasonCode.Trim(), StringComparer.OrdinalIgnoreCase);
|
||||
}
|
||||
@@ -10,7 +10,7 @@ public sealed record ApprovalStepDto(int Level, ApprovalDecision Decision, int D
|
||||
public sealed record ApprovalConfigDto(
|
||||
int StockAdjustmentLevels, decimal StockAdjustmentLevel2ThresholdValue,
|
||||
int PriceAdjustmentLevels, decimal PriceAdjustmentLevel2ThresholdPercent,
|
||||
IReadOnlyList<int> Level2RoleIds, DateTime? UpdatedAt);
|
||||
IReadOnlyList<int> Level2RoleIds, DateTime? UpdatedAt, int WastageLevels = 0);
|
||||
|
||||
public sealed class UpdateApprovalConfigRequest
|
||||
{
|
||||
@@ -20,6 +20,9 @@ public sealed class UpdateApprovalConfigRequest
|
||||
[Range(0, 1000)] public decimal PriceAdjustmentLevel2ThresholdPercent { get; set; }
|
||||
/// <summary>Roles allowed to give the second approval; empty = anyone with the Approve action.</summary>
|
||||
public List<int> Level2RoleIds { get; set; } = new();
|
||||
|
||||
/// <summary>0 = wastage posts on save, 2 = two approvals first. Null keeps the stored value (an older client that doesn't know the setting).</summary>
|
||||
[Range(0, 2)] public int? WastageLevels { get; set; }
|
||||
}
|
||||
|
||||
public sealed class ApproveRequest
|
||||
|
||||
@@ -47,4 +47,6 @@ public sealed class UpdateGlAccountConfigRequest
|
||||
[MaxLength(GlAccountConfig.CodeMaxLength)] public string? CogsAccountCode { get; set; }
|
||||
[MaxLength(GlAccountConfig.CodeMaxLength)] public string? InventoryLossAccountCode { get; set; }
|
||||
[MaxLength(GlAccountConfig.CodeMaxLength)] public string? CashAccountCode { get; set; }
|
||||
/// <summary>Optional so an older client that doesn't know this role can't blank it out: null keeps the stored code.</summary>
|
||||
[MaxLength(GlAccountConfig.CodeMaxLength)] public string? AccruedExpensesCode { get; set; }
|
||||
}
|
||||
|
||||
@@ -35,7 +35,8 @@ public sealed class GlAccountConfigConfiguration : IEntityTypeConfiguration<GlAc
|
||||
nameof(GlAccountConfig.InventoryGainAccountCode),
|
||||
nameof(GlAccountConfig.CogsAccountCode),
|
||||
nameof(GlAccountConfig.InventoryLossAccountCode),
|
||||
nameof(GlAccountConfig.CashAccountCode)
|
||||
nameof(GlAccountConfig.CashAccountCode),
|
||||
nameof(GlAccountConfig.AccruedExpensesCode)
|
||||
})
|
||||
{
|
||||
builder.Property(code).HasMaxLength(GlAccountConfig.CodeMaxLength);
|
||||
|
||||
@@ -304,7 +304,8 @@ public static class DataSeeder
|
||||
InventoryGainAccountCode = Legacy("Adjustment:GlGainAccountCode"),
|
||||
CogsAccountCode = Legacy("SalesDayEnd:GlCogsAccountCode"),
|
||||
InventoryLossAccountCode = Legacy("Adjustment:GlLossAccountCode"),
|
||||
CashAccountCode = Legacy("SalesDayEnd:GlCashAccountCode")
|
||||
CashAccountCode = Legacy("SalesDayEnd:GlCashAccountCode"),
|
||||
AccruedExpensesCode = Legacy("Expense:GlAccruedExpensesCode")
|
||||
});
|
||||
return true;
|
||||
}
|
||||
|
||||
+11370
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,36 @@
|
||||
using Microsoft.EntityFrameworkCore.Migrations;
|
||||
|
||||
#nullable disable
|
||||
|
||||
namespace ERPCore.Migrations
|
||||
{
|
||||
/// <inheritdoc />
|
||||
public partial class AddWastageApprovalSetting : Migration
|
||||
{
|
||||
/// <inheritdoc />
|
||||
protected override void Up(MigrationBuilder migrationBuilder)
|
||||
{
|
||||
migrationBuilder.AddColumn<int>(
|
||||
name: "WastageLevels",
|
||||
table: "approval_config",
|
||||
type: "int",
|
||||
nullable: false,
|
||||
defaultValue: 0);
|
||||
|
||||
migrationBuilder.UpdateData(
|
||||
table: "approval_config",
|
||||
keyColumn: "ApprovalConfigId",
|
||||
keyValue: 1,
|
||||
column: "WastageLevels",
|
||||
value: 0);
|
||||
}
|
||||
|
||||
/// <inheritdoc />
|
||||
protected override void Down(MigrationBuilder migrationBuilder)
|
||||
{
|
||||
migrationBuilder.DropColumn(
|
||||
name: "WastageLevels",
|
||||
table: "approval_config");
|
||||
}
|
||||
}
|
||||
}
|
||||
+11374
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,34 @@
|
||||
using Microsoft.EntityFrameworkCore.Migrations;
|
||||
|
||||
#nullable disable
|
||||
|
||||
namespace ERPCore.Migrations
|
||||
{
|
||||
/// <inheritdoc />
|
||||
public partial class AddAccruedExpensesGlRole : Migration
|
||||
{
|
||||
/// <inheritdoc />
|
||||
protected override void Up(MigrationBuilder migrationBuilder)
|
||||
{
|
||||
migrationBuilder.AddColumn<string>(
|
||||
name: "AccruedExpensesCode",
|
||||
table: "gl_account_config",
|
||||
type: "varchar(20)",
|
||||
maxLength: 20,
|
||||
nullable: true,
|
||||
collation: "utf8mb4_unicode_ci");
|
||||
|
||||
// Until now the accrued-expenses account lived only in appsettings (Expense:GlAccruedExpensesCode, "2300"); carry it
|
||||
// over so an existing deployment keeps working and the code now shows - and is checked - on Settings -> GL Accounts.
|
||||
migrationBuilder.Sql("UPDATE `gl_account_config` SET `AccruedExpensesCode` = '2300' WHERE `ConfigId` = 1 AND `AccruedExpensesCode` IS NULL;");
|
||||
}
|
||||
|
||||
/// <inheritdoc />
|
||||
protected override void Down(MigrationBuilder migrationBuilder)
|
||||
{
|
||||
migrationBuilder.DropColumn(
|
||||
name: "AccruedExpensesCode",
|
||||
table: "gl_account_config");
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -86,6 +86,9 @@ namespace ERPCore.Migrations
|
||||
b.Property<int?>("UpdatedBy")
|
||||
.HasColumnType("int");
|
||||
|
||||
b.Property<int>("WastageLevels")
|
||||
.HasColumnType("int");
|
||||
|
||||
b.HasKey("ApprovalConfigId");
|
||||
|
||||
b.ToTable("approval_config", null, t =>
|
||||
@@ -101,7 +104,8 @@ namespace ERPCore.Migrations
|
||||
PriceAdjustmentLevels = 2,
|
||||
RowVersion = 1u,
|
||||
StockAdjustmentLevel2ThresholdValue = 0m,
|
||||
StockAdjustmentLevels = 2
|
||||
StockAdjustmentLevels = 2,
|
||||
WastageLevels = 0
|
||||
});
|
||||
});
|
||||
|
||||
@@ -2252,6 +2256,10 @@ namespace ERPCore.Migrations
|
||||
.HasMaxLength(20)
|
||||
.HasColumnType("varchar(20)");
|
||||
|
||||
b.Property<string>("AccruedExpensesCode")
|
||||
.HasMaxLength(20)
|
||||
.HasColumnType("varchar(20)");
|
||||
|
||||
b.Property<string>("CashAccountCode")
|
||||
.HasMaxLength(20)
|
||||
.HasColumnType("varchar(20)");
|
||||
|
||||
@@ -112,9 +112,19 @@ public sealed class AdjustmentService : IAdjustmentService
|
||||
}
|
||||
|
||||
public async Task<PagedResponse<AdjustmentSummaryDto>> ListAsync(
|
||||
PageQuery query, int? warehouseId, int? branchId, int? reasonCodeId, AdjustmentStatus? status = null, CancellationToken ct = default)
|
||||
PageQuery query, int? warehouseId, int? branchId, int? reasonCodeId, AdjustmentStatus? status = null,
|
||||
CancellationToken ct = default, bool wastageOnly = false, int? itemId = null)
|
||||
{
|
||||
var q = _adjustments.Query().AsNoTracking();
|
||||
// Adjustments that touch this item (the product page's activity).
|
||||
if (itemId is not null) q = q.Where(a => a.Lines.Any(l => l.ItemId == itemId));
|
||||
if (wastageOnly)
|
||||
{
|
||||
// Wastage = an adjustment with a damage / theft / expiry reason code.
|
||||
var wastageCodes = WastageReasonCodes.Codes.Select(c => c.ToUpper()).ToList();
|
||||
var wastageReasonIds = _reasonCodes.Query().Where(r => wastageCodes.Contains(r.Code.ToUpper())).Select(r => r.ReasonCodeId);
|
||||
q = q.Where(a => wastageReasonIds.Contains(a.ReasonCodeId));
|
||||
}
|
||||
|
||||
if (!string.IsNullOrWhiteSpace(query.Q))
|
||||
{
|
||||
@@ -189,7 +199,12 @@ public sealed class AdjustmentService : IAdjustmentService
|
||||
// Validated only: posting resolves them again and creates any new ones exactly once.
|
||||
DiscardUnsavedSerials();
|
||||
|
||||
var required = await _approvals.RequiredForStockAdjustmentAsync(value, ct);
|
||||
// Wastage (a write-off with a damage / theft / expiry reason) has its own switch; every other adjustment and a
|
||||
// stock-count variance keeps the stock-adjustment levels and threshold.
|
||||
var isWastage = WastageReasonCodes.IsWastage(reason.Code) && request.Lines.All(l => l.QtyDelta < 0);
|
||||
var required = isWastage
|
||||
? await _approvals.RequiredForWastageAsync(ct)
|
||||
: await _approvals.RequiredForStockAdjustmentAsync(value, ct);
|
||||
|
||||
var now = DateTime.UtcNow;
|
||||
var (adjustment, refs) = await _uow.ExecuteInTransactionAsync(async token =>
|
||||
|
||||
@@ -55,6 +55,7 @@ public sealed class ApprovalService : IApprovalService
|
||||
|
||||
config.StockAdjustmentLevels = Math.Clamp(request.StockAdjustmentLevels, 0, 2);
|
||||
config.StockAdjustmentLevel2ThresholdValue = Math.Max(0m, request.StockAdjustmentLevel2ThresholdValue);
|
||||
if (request.WastageLevels is int wastageLevels) config.WastageLevels = Math.Clamp(wastageLevels, 0, 2);
|
||||
config.PriceAdjustmentLevels = Math.Clamp(request.PriceAdjustmentLevels, 0, 2);
|
||||
config.PriceAdjustmentLevel2ThresholdPercent = Math.Max(0m, request.PriceAdjustmentLevel2ThresholdPercent);
|
||||
var roleIds = request.Level2RoleIds.Where(id => id > 0).Distinct().ToList();
|
||||
@@ -79,6 +80,9 @@ public sealed class ApprovalService : IApprovalService
|
||||
return Levels(c.StockAdjustmentLevels, c.StockAdjustmentLevel2ThresholdValue, absoluteValue);
|
||||
}
|
||||
|
||||
public async Task<int> RequiredForWastageAsync(CancellationToken ct = default)
|
||||
=> Math.Clamp((await LoadConfigAsync(ct)).WastageLevels, 0, 2);
|
||||
|
||||
public async Task<int> RequiredForPriceAdjustmentAsync(decimal largestChangePercent, CancellationToken ct = default)
|
||||
{
|
||||
var c = await LoadConfigAsync(ct);
|
||||
@@ -188,5 +192,5 @@ public sealed class ApprovalService : IApprovalService
|
||||
private static ApprovalConfigDto Map(ApprovalConfig c) => new(
|
||||
c.StockAdjustmentLevels, c.StockAdjustmentLevel2ThresholdValue,
|
||||
c.PriceAdjustmentLevels, c.PriceAdjustmentLevel2ThresholdPercent,
|
||||
Level2RoleIds(c).Order().ToList(), c.UpdatedAt);
|
||||
Level2RoleIds(c).Order().ToList(), c.UpdatedAt, c.WastageLevels);
|
||||
}
|
||||
|
||||
@@ -27,11 +27,11 @@ public sealed class ExpensePaymentService : IExpensePaymentService
|
||||
private readonly IGeneralLedgerService _gl;
|
||||
private readonly ICurrentUser _currentUser;
|
||||
private readonly IUnitOfWork _uow;
|
||||
private readonly string _glAccruedExpensesCode;
|
||||
private readonly IGlAccountConfigService _glAccounts;
|
||||
|
||||
public ExpensePaymentService(
|
||||
IRepository<Expense> expenses, IRepository<ExpensePayment> payments, ExpenseService expenseService,
|
||||
IGeneralLedgerService gl, ICurrentUser currentUser, IUnitOfWork uow, IConfiguration configuration)
|
||||
IGeneralLedgerService gl, ICurrentUser currentUser, IUnitOfWork uow, IGlAccountConfigService glAccounts)
|
||||
{
|
||||
_expenses = expenses;
|
||||
_payments = payments;
|
||||
@@ -39,7 +39,7 @@ public sealed class ExpensePaymentService : IExpensePaymentService
|
||||
_gl = gl;
|
||||
_currentUser = currentUser;
|
||||
_uow = uow;
|
||||
_glAccruedExpensesCode = configuration["Expense:GlAccruedExpensesCode"] ?? string.Empty;
|
||||
_glAccounts = glAccounts;
|
||||
}
|
||||
|
||||
public async Task<IReadOnlyList<ExpensePaymentDto>> PayAsync(int expenseId, CreateExpensePaymentRequest request, CancellationToken ct = default)
|
||||
@@ -110,7 +110,8 @@ public sealed class ExpensePaymentService : IExpensePaymentService
|
||||
{
|
||||
var total = request.Lines.Sum(l => l.Amount);
|
||||
var narration = $"Payment of expense {expense.DocNo}";
|
||||
var glLines = new List<GlJournalEntryLineRequest> { new(_glAccruedExpensesCode, total, 0m, narration) };
|
||||
var accruedExpensesCode = (await _glAccounts.GetCodesAsync(ct))[GlAccountRole.AccruedExpenses];
|
||||
var glLines = new List<GlJournalEntryLineRequest> { new(accruedExpensesCode, total, 0m, narration) };
|
||||
glLines.AddRange(request.Lines.Select(l => new GlJournalEntryLineRequest(accounts[l.GlBankAccountId].GlAccountCode, 0m, l.Amount, narration)));
|
||||
|
||||
var period = await _gl.GetPeriodByDateAsync(paymentDay, ct);
|
||||
|
||||
@@ -32,12 +32,12 @@ public sealed class ExpenseService : IExpenseService
|
||||
private readonly IBranchConfigService _branchConfig;
|
||||
private readonly IUnitOfWork _uow;
|
||||
private readonly IGeneralLedgerService _gl;
|
||||
private readonly string _glAccruedExpensesCode;
|
||||
private readonly IGlAccountConfigService _glAccounts;
|
||||
|
||||
public ExpenseService(
|
||||
IRepository<Expense> expenses, IRepository<ExpenseTitle> titles, IRepository<Vendor> vendors,
|
||||
ICurrentUser currentUser, INumberSequenceService numbers, IBranchConfigService branchConfig,
|
||||
IUnitOfWork uow, IGeneralLedgerService gl, IConfiguration configuration)
|
||||
IUnitOfWork uow, IGeneralLedgerService gl, IGlAccountConfigService glAccounts)
|
||||
{
|
||||
_expenses = expenses;
|
||||
_titles = titles;
|
||||
@@ -47,7 +47,7 @@ public sealed class ExpenseService : IExpenseService
|
||||
_branchConfig = branchConfig;
|
||||
_uow = uow;
|
||||
_gl = gl;
|
||||
_glAccruedExpensesCode = configuration["Expense:GlAccruedExpensesCode"] ?? string.Empty;
|
||||
_glAccounts = glAccounts;
|
||||
}
|
||||
|
||||
public async Task<PagedResponse<ExpenseSummaryDto>> ListAsync(PageQuery query, ExpenseListFilter filter, CancellationToken ct = default)
|
||||
@@ -174,6 +174,7 @@ public sealed class ExpenseService : IExpenseService
|
||||
|
||||
var now = DateTime.UtcNow;
|
||||
var narration = $"{expense.Category?.Name} - {title.Name} ({expense.DocNo})";
|
||||
var accruedExpensesCode = (await _glAccounts.GetCodesAsync(ct))[GlAccountRole.AccruedExpenses];
|
||||
var period = await _gl.GetPeriodByDateAsync(expense.ExpenseDate, ct);
|
||||
var posted = await _gl.PostJournalEntryAsync(new GlJournalEntryRequest
|
||||
{
|
||||
@@ -185,7 +186,7 @@ public sealed class ExpenseService : IExpenseService
|
||||
Lines =
|
||||
[
|
||||
new GlJournalEntryLineRequest(title.GlExpenseAccountCode, expense.Amount, 0m, narration),
|
||||
new GlJournalEntryLineRequest(_glAccruedExpensesCode, 0m, expense.Amount, narration)
|
||||
new GlJournalEntryLineRequest(accruedExpensesCode, 0m, expense.Amount, narration)
|
||||
]
|
||||
}, ct);
|
||||
|
||||
@@ -215,6 +216,7 @@ public sealed class ExpenseService : IExpenseService
|
||||
{
|
||||
var today = DateOnly.FromDateTime(now);
|
||||
var narration = $"Cancellation of expense {expense.DocNo}";
|
||||
var accruedExpensesCode = (await _glAccounts.GetCodesAsync(token))[GlAccountRole.AccruedExpenses];
|
||||
var period = await _gl.GetPeriodByDateAsync(today, token);
|
||||
var reversal = await _gl.PostJournalEntryAsync(new GlJournalEntryRequest
|
||||
{
|
||||
@@ -225,7 +227,7 @@ public sealed class ExpenseService : IExpenseService
|
||||
Narration = narration,
|
||||
Lines =
|
||||
[
|
||||
new GlJournalEntryLineRequest(_glAccruedExpensesCode, expense.Amount, 0m, narration),
|
||||
new GlJournalEntryLineRequest(accruedExpensesCode, expense.Amount, 0m, narration),
|
||||
new GlJournalEntryLineRequest(expense.GlExpenseAccountCode ?? string.Empty, 0m, expense.Amount, narration)
|
||||
]
|
||||
}, token);
|
||||
|
||||
@@ -54,7 +54,11 @@ public enum GlAccountRole
|
||||
InventoryLoss,
|
||||
|
||||
/// <summary>Cash takings at day-end close.</summary>
|
||||
Cash
|
||||
Cash,
|
||||
|
||||
/// <summary>Expenses booked but not yet paid (a liability): credited when an expense is posted, debited when it is paid.
|
||||
/// Used to live only in appsettings (<c>Expense:GlAccruedExpensesCode</c>), where nobody could see or check it.</summary>
|
||||
AccruedExpenses
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
|
||||
@@ -105,6 +105,8 @@ public sealed class GlAccountConfigService : IGlAccountConfigService
|
||||
config.CogsAccountCode = submitted[GlAccountRole.Cogs];
|
||||
config.InventoryLossAccountCode = submitted[GlAccountRole.InventoryLoss];
|
||||
config.CashAccountCode = submitted[GlAccountRole.Cash];
|
||||
// An older client that does not send this role keeps what is stored (it must never blank a mapping it can't see).
|
||||
if (request.AccruedExpensesCode is not null) config.AccruedExpensesCode = submitted[GlAccountRole.AccruedExpenses];
|
||||
config.UpdatedAt = DateTime.UtcNow;
|
||||
config.UpdatedBy = _currentUser.AuditUserId;
|
||||
|
||||
@@ -146,7 +148,8 @@ public sealed class GlAccountConfigService : IGlAccountConfigService
|
||||
[GlAccountRole.InventoryGain] = Trim(c.InventoryGainAccountCode),
|
||||
[GlAccountRole.Cogs] = Trim(c.CogsAccountCode),
|
||||
[GlAccountRole.InventoryLoss] = Trim(c.InventoryLossAccountCode),
|
||||
[GlAccountRole.Cash] = Trim(c.CashAccountCode)
|
||||
[GlAccountRole.Cash] = Trim(c.CashAccountCode),
|
||||
[GlAccountRole.AccruedExpenses] = Trim(c.AccruedExpensesCode)
|
||||
};
|
||||
|
||||
private static Dictionary<GlAccountRole, string?> Submitted(UpdateGlAccountConfigRequest r) => new()
|
||||
@@ -162,7 +165,8 @@ public sealed class GlAccountConfigService : IGlAccountConfigService
|
||||
[GlAccountRole.InventoryGain] = Trim(r.InventoryGainAccountCode),
|
||||
[GlAccountRole.Cogs] = Trim(r.CogsAccountCode),
|
||||
[GlAccountRole.InventoryLoss] = Trim(r.InventoryLossAccountCode),
|
||||
[GlAccountRole.Cash] = Trim(r.CashAccountCode)
|
||||
[GlAccountRole.Cash] = Trim(r.CashAccountCode),
|
||||
[GlAccountRole.AccruedExpenses] = Trim(r.AccruedExpensesCode)
|
||||
};
|
||||
|
||||
private static string? Trim(string? code) => string.IsNullOrWhiteSpace(code) ? null : code.Trim();
|
||||
|
||||
@@ -8,7 +8,8 @@ namespace ERPCore.Services.Interfaces;
|
||||
public interface IAdjustmentService
|
||||
{
|
||||
Task<PagedResponse<AdjustmentSummaryDto>> ListAsync(
|
||||
PageQuery query, int? warehouseId, int? branchId, int? reasonCodeId, AdjustmentStatus? status = null, CancellationToken ct = default);
|
||||
PageQuery query, int? warehouseId, int? branchId, int? reasonCodeId, AdjustmentStatus? status = null,
|
||||
CancellationToken ct = default, bool wastageOnly = false, int? itemId = null);
|
||||
|
||||
Task<AdjustmentDto?> GetAsync(int adjustmentId, CancellationToken ct = default);
|
||||
|
||||
|
||||
@@ -29,6 +29,9 @@ public interface IApprovalService
|
||||
/// <summary>Approvals a stock adjustment worth <paramref name="absoluteValue"/> needs (0, 1 or 2).</summary>
|
||||
Task<int> RequiredForStockAdjustmentAsync(decimal absoluteValue, CancellationToken ct = default);
|
||||
|
||||
/// <summary>Approvals a wastage write-off needs (Settings -> Approvals "Wastage needs dual approval"): 0 or 2.</summary>
|
||||
Task<int> RequiredForWastageAsync(CancellationToken ct = default);
|
||||
|
||||
/// <summary>Approvals a price change of <paramref name="largestChangePercent"/> needs (0, 1 or 2).</summary>
|
||||
Task<int> RequiredForPriceAdjustmentAsync(decimal largestChangePercent, CancellationToken ct = default);
|
||||
|
||||
|
||||
@@ -648,3 +648,16 @@ Spec: `docs/30-BACKEND-PHASE2.md` (model + rules **and** API — one doc, unlike
|
||||
- **Running balance is now computed on read** (`StockService.GetLedgerAsync`): the sum of every movement of the same item + warehouse up to that row (In adds, Out subtracts). The stored `RunningBalance` column was wrong for sales issues (`SalesPostingService` posts `0`), so those rows showed 0; the read-time value is right for old rows, later pages and any filter. The column is no longer read.
|
||||
- **Rows carry** `itemSku`, `itemName`, `categoryName`, `brandName`; the endpoint takes `categoryId` and `brandId` (items in them). The page shows the item NAME with SKU, category and brand underneath, signed quantities (+In / −Out), unit cost with up to 4 decimals, Out values negative, and Category / Brand / searchable Item (SKU — name) / Warehouse filters; the item picker follows the category and brand.
|
||||
- **Tests:** `StockLedgerTests` (4). Suite 218/218. Not changed: `SalesPostingService` still writes `RunningBalance = 0` to the stored column (nothing reads it).
|
||||
|
||||
### 2026-10-18 (6) — Wastage reduces stock again; wastage approval is a setting
|
||||
- **Why stock stopped reducing:** wastage is a stock adjustment, and the dual-approval engine seeds `StockAdjustmentLevels = 2`, so every wastage was only a pending request (no FIFO consume, ledger row or GL journal) until two other users approved it.
|
||||
- **Setting:** `approval_config.WastageLevels` (0 = none, default; 2 = two approvers). Settings -> Approvals has a *Wastage needs dual approval* switch. Wastage = Adjustment reason DMG / THEFT / EXP with every line a decrease (`WastageReasonCodes`); everything else (manual adjustments, count variances, wastage *gains*) keeps the stock-adjustment levels and threshold. Migration `AddWastageApprovalSetting` (additive, default 0, **not applied**).
|
||||
- **List:** `GET /stock-adjustments?wastage=true` filters server-side; the Wastage page uses it, counts posted wastage in its totals, shows pending requests apart ("Waiting for approval") with no value, and loads every item so names resolve past the first 200. Record Wastage shows whether it reduces stock now or needs approval.
|
||||
- **Not touched:** requests already pending stay pending (approve them in the Approval Queue or withdraw and re-record).
|
||||
- **Tests:** 5 new in `DualApprovalTests` (switch off posts at once; on stays pending until two approvers; the two settings don't affect each other; list filter; default). The existing adjustment tests now use an ordinary reason (VAR) instead of DMG. Suite 223/223.
|
||||
|
||||
### 2026-10-18 (7) — Expense posting: "Account 5200-01 / 2300 not found"
|
||||
- **Cause:** the GL used by this deployment had none of the accounts the Expense module posts to: the four expense accounts the seeded titles point at (`5200-01`..`5200-04`, children of an "Operating Expenses" `5200` control account) and the **Accrued Expenses** liability (`2300`) that every expense is credited to. The expense-title accounts are editable on Accounts -> Expense Setup; the accrued account was **only in appsettings** (`Expense:GlAccruedExpensesCode`), invisible and unchecked.
|
||||
- **Fix in code:** `GlAccountRole.AccruedExpenses` + `gl_account_config.AccruedExpensesCode` (migration `AddAccruedExpensesGlRole`, **not applied**, fills existing config with `2300`; fresh databases seed it from the old appsettings key). `ExpenseService` / `ExpensePaymentService` read the mapped role, so it is edited, validated (must exist and be postable) and checked at startup like every other GL role, on Settings -> GL Accounts.
|
||||
- **GL data (done through the GL's own API, not SQL):** created `5200 Operating Expenses` (header) with `5200-01` Utility, `5200-02` Rental, `5200-03` Salaries and Wages, `5200-04` Other Expenses, and `2300 Accrued Expenses`.
|
||||
- **Still true for a brand-new GL:** the chart of accounts itself is created in the GL service, not in the ERP; the ERP only maps roles to existing accounts and now tells you which are missing.
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
import { useEffect, useMemo, useState } from "react"
|
||||
import { useParams, usePathname, useRouter } from "next/navigation"
|
||||
import Link from "next/link"
|
||||
import { AlertTriangle, ArrowLeft, BadgeDollarSign, Boxes, Package, PackageCheck, Pencil, Save, ShoppingCart, TrendingUp } from "lucide-react"
|
||||
import { AlertOctagon, AlertTriangle, ArrowLeft, BadgeDollarSign, Boxes, Package, PackageCheck, Pencil, Save, ShoppingCart, TrendingUp } from "lucide-react"
|
||||
|
||||
import { approvalsApi, priceAdjustmentsApi } from "@/lib/api/approvals"
|
||||
import { itemsApi } from "@/lib/api/items"
|
||||
@@ -14,6 +14,8 @@ import { uomsApi } from "@/lib/api/uoms"
|
||||
import { taxRatesApi } from "@/lib/api/tax-rates"
|
||||
import { warehousesApi } from "@/lib/api/warehouses"
|
||||
import { stockApi } from "@/lib/api/stock"
|
||||
import { reasonCodesApi } from "@/lib/api/reason-codes"
|
||||
import { WastageRecord, wastageApi } from "@/lib/api/wastage"
|
||||
import { errorMessage, fieldErrors } from "@/lib/error-map"
|
||||
import { validateItemForm } from "@/lib/validations/master-data"
|
||||
import { cn } from "@/lib/utils"
|
||||
@@ -104,6 +106,9 @@ function ItemDetailPage() {
|
||||
|
||||
// Profile activity: full recent movement history for this item, across every warehouse.
|
||||
const [ledger, setLedger] = useState<LedgerEntry[] | null>(null)
|
||||
// Damage / theft / expiry write-offs of this item (stock adjustments with a wastage reason), and the reason names.
|
||||
const [wastage, setWastage] = useState<WastageRecord[] | null>(null)
|
||||
const [reasonNames, setReasonNames] = useState<Map<number, string>>(new Map())
|
||||
const [stockValue, setStockValue] = useState<number | null>(null)
|
||||
|
||||
// Basic info form
|
||||
@@ -218,6 +223,11 @@ function ItemDetailPage() {
|
||||
useEffect(() => {
|
||||
if (!Number.isFinite(itemId)) return
|
||||
stockApi.ledger({ itemId, pageSize: 500 }).then((res) => setLedger(res.items)).catch(() => setLedger([]))
|
||||
wastageApi.list({ itemId, pageSize: 100 }).then(setWastage).catch(() => setWastage([]))
|
||||
reasonCodesApi
|
||||
.list("Adjustment", { pageSize: 200 })
|
||||
.then((r) => setReasonNames(new Map(r.items.map((x) => [x.reasonCodeId, x.description]))))
|
||||
.catch(() => {})
|
||||
stockApi
|
||||
.onHandList({ itemId, pageSize: 200 })
|
||||
.then((res) => res.items.filter((r) => r.onHand > 0))
|
||||
@@ -280,6 +290,8 @@ function ItemDetailPage() {
|
||||
.reduce((sum, r) => sum + r.qtyBase, 0),
|
||||
[sortedLedger, cutoff30]
|
||||
)
|
||||
// Wastage that has actually reduced stock counts; a request still waiting for approval is listed but not counted.
|
||||
const wastedQty = useMemo(() => (wastage ?? []).filter((w) => w.status === "Posted").reduce((sum, w) => sum + w.qty, 0), [wastage])
|
||||
const recentSales = useMemo(
|
||||
() => sortedLedger.filter((r) => r.direction === "Out" && SALES_DOC_TYPES.has(r.sourceDocType)).slice(-8).reverse(),
|
||||
[sortedLedger]
|
||||
@@ -626,7 +638,7 @@ function ItemDetailPage() {
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-2 gap-3 lg:grid-cols-4">
|
||||
<div className="grid grid-cols-2 gap-3 lg:grid-cols-5">
|
||||
<StatChip icon={Boxes} label={`On hand (${uomName(item.baseUomId)})`} value={currentStockQty.toLocaleString()} />
|
||||
<StatChip
|
||||
icon={BadgeDollarSign}
|
||||
@@ -635,6 +647,7 @@ function ItemDetailPage() {
|
||||
/>
|
||||
<StatChip icon={ShoppingCart} label="Sold, last 30 days" value={salesQty30d.toLocaleString()} />
|
||||
<StatChip icon={PackageCheck} label="Purchases on record" value={recentGrns.length > 0 ? `${sortedLedger.filter((r) => r.sourceDocType === "GRN").length}` : "0"} />
|
||||
<StatChip icon={AlertOctagon} label="Wasted, all time" value={wastage === null ? "…" : wastedQty.toLocaleString()} />
|
||||
</div>
|
||||
|
||||
{conflict && (
|
||||
@@ -919,6 +932,76 @@ function ItemDetailPage() {
|
||||
|
||||
|
||||
|
||||
<div className="flex flex-col gap-3 rounded-xl border p-5">
|
||||
<h2 className="text-base font-semibold text-foreground">Recent wastage</h2>
|
||||
{wastage === null ? (
|
||||
<Skeleton className="h-32 w-full" />
|
||||
) : wastage.length === 0 ? (
|
||||
<p className="py-6 text-center text-sm text-muted-foreground">No wastage recorded for this item.</p>
|
||||
) : (
|
||||
<>
|
||||
{/* Mobile: stacked cards. */}
|
||||
<div className="flex flex-col gap-2 md:hidden">
|
||||
{wastage.slice(0, 8).map((w) => (
|
||||
<div key={`${w.adjustmentId}-${w.adjLineId}`} className="flex flex-col gap-1.5 rounded-lg border p-3 text-sm">
|
||||
<div className="flex items-center justify-between gap-2">
|
||||
<Link href={`/dashboard/stock/adjustments/${w.adjustmentId}`} className="truncate font-medium text-primary hover:underline">
|
||||
{w.docNo}
|
||||
</Link>
|
||||
<span className="shrink-0 text-xs text-muted-foreground">{new Date(w.createdAt).toLocaleDateString()}</span>
|
||||
</div>
|
||||
<div className="flex items-center justify-between text-muted-foreground">
|
||||
<span>{reasonNames.get(w.reasonCodeId) ?? `Reason #${w.reasonCodeId}`} · Qty {w.qty.toLocaleString()}</span>
|
||||
<span className="font-medium text-foreground">
|
||||
{w.status === "Posted" ? `LKR ${w.value.toLocaleString(undefined, { maximumFractionDigits: 2 })}` : "Pending approval"}
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
|
||||
{/* Desktop: table. */}
|
||||
<div className="hidden overflow-x-auto md:block">
|
||||
<Table className="text-sm">
|
||||
<TableHeader>
|
||||
<TableRow>
|
||||
<TableHead className="h-9 px-2 text-xs">Date</TableHead>
|
||||
<TableHead className="h-9 px-2 text-xs">Document</TableHead>
|
||||
<TableHead className="h-9 px-2 text-xs">Reason</TableHead>
|
||||
<TableHead className="h-9 px-2 text-xs">Qty</TableHead>
|
||||
<TableHead className="h-9 px-2 text-xs">Value</TableHead>
|
||||
</TableRow>
|
||||
</TableHeader>
|
||||
<TableBody>
|
||||
{wastage.slice(0, 8).map((w) => (
|
||||
<TableRow key={`${w.adjustmentId}-${w.adjLineId}`}>
|
||||
<TableCell className="px-2 py-2 text-muted-foreground">{new Date(w.createdAt).toLocaleDateString()}</TableCell>
|
||||
<TableCell className="px-2 py-2">
|
||||
<Link href={`/dashboard/stock/adjustments/${w.adjustmentId}`} className="font-medium text-primary hover:underline">
|
||||
{w.docNo}
|
||||
</Link>
|
||||
</TableCell>
|
||||
<TableCell className="px-2 py-2 text-muted-foreground">{reasonNames.get(w.reasonCodeId) ?? `#${w.reasonCodeId}`}</TableCell>
|
||||
<TableCell className="px-2 py-2 font-medium text-destructive">-{w.qty.toLocaleString()}</TableCell>
|
||||
<TableCell className="px-2 py-2">
|
||||
{w.status === "Posted" ? (
|
||||
`LKR ${w.value.toLocaleString(undefined, { maximumFractionDigits: 2 })}`
|
||||
) : (
|
||||
<span className="rounded bg-warning/10 px-1.5 py-0.5 text-xs text-warning">Pending approval</span>
|
||||
)}
|
||||
</TableCell>
|
||||
</TableRow>
|
||||
))}
|
||||
</TableBody>
|
||||
</Table>
|
||||
</div>
|
||||
<Link href="/dashboard/stock/wastage" className="self-end text-sm font-medium text-primary hover:underline">
|
||||
All wastage
|
||||
</Link>
|
||||
</>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<p className="text-sm text-muted-foreground">
|
||||
{uomName(item.baseUomId)} is the base UOM — every transaction records quantities as a count of it (FR-MD-03).
|
||||
There are no conversions: a differently sized pack is a different item.
|
||||
|
||||
@@ -14,6 +14,7 @@ import { Field, FieldDescription, FieldLabel } from "@/components/ui/field"
|
||||
import { Input } from "@/components/ui/input"
|
||||
import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
|
||||
import { Skeleton } from "@/components/ui/skeleton"
|
||||
import { Switch } from "@/components/ui/switch"
|
||||
import { toast } from "@/components/ui/toast"
|
||||
|
||||
const levelOptions = [
|
||||
@@ -28,6 +29,7 @@ export default function ApprovalSettingsPage() {
|
||||
const [error, setError] = useState<string | null>(null)
|
||||
const [stockLevels, setStockLevels] = useState("2")
|
||||
const [stockThreshold, setStockThreshold] = useState("0")
|
||||
const [wastageDual, setWastageDual] = useState(false)
|
||||
const [priceLevels, setPriceLevels] = useState("2")
|
||||
const [priceThreshold, setPriceThreshold] = useState("0")
|
||||
const [level2Roles, setLevel2Roles] = useState<number[]>([])
|
||||
@@ -38,6 +40,7 @@ export default function ApprovalSettingsPage() {
|
||||
setConfig(c)
|
||||
setStockLevels(String(c.stockAdjustmentLevels))
|
||||
setStockThreshold(String(c.stockAdjustmentLevel2ThresholdValue))
|
||||
setWastageDual((c.wastageLevels ?? 0) > 0)
|
||||
setPriceLevels(String(c.priceAdjustmentLevels))
|
||||
setPriceThreshold(String(c.priceAdjustmentLevel2ThresholdPercent))
|
||||
setLevel2Roles(c.level2RoleIds)
|
||||
@@ -60,6 +63,7 @@ export default function ApprovalSettingsPage() {
|
||||
const saved = await approvalsApi.updateConfig({
|
||||
stockAdjustmentLevels: Number(stockLevels),
|
||||
stockAdjustmentLevel2ThresholdValue: sv,
|
||||
wastageLevels: wastageDual ? 2 : 0,
|
||||
priceAdjustmentLevels: Number(priceLevels),
|
||||
priceAdjustmentLevel2ThresholdPercent: pv,
|
||||
level2RoleIds: level2Roles,
|
||||
@@ -81,7 +85,7 @@ export default function ApprovalSettingsPage() {
|
||||
<div>
|
||||
<h1 className="text-2xl font-bold text-foreground">Approvals</h1>
|
||||
<p className="text-base text-muted-foreground">
|
||||
How many people must approve a stock or price adjustment before it takes effect. The requester can never approve their own request,
|
||||
How many people must approve a stock adjustment, wastage or price adjustment before it takes effect. The requester can never approve their own request,
|
||||
and with two approvals the second must be a different person from the first. Changes apply to new requests; pending ones keep their rule.
|
||||
</p>
|
||||
</div>
|
||||
@@ -89,7 +93,7 @@ export default function ApprovalSettingsPage() {
|
||||
<div className="grid grid-cols-1 gap-4 lg:grid-cols-2">
|
||||
<section className="flex flex-col gap-4 rounded-2xl border bg-card p-5 shadow-sm">
|
||||
<h2 className="text-lg font-semibold text-foreground">Stock adjustments</h2>
|
||||
<p className="text-sm text-muted-foreground">Adjustments, wastage and stock-count variances.</p>
|
||||
<p className="text-sm text-muted-foreground">Manual adjustments and stock-count variances. Wastage has its own switch below.</p>
|
||||
<Field>
|
||||
<FieldLabel>Approvals required</FieldLabel>
|
||||
<Select<string> value={stockLevels} onValueChange={(v) => v && setStockLevels(v)}>
|
||||
@@ -106,6 +110,27 @@ export default function ApprovalSettingsPage() {
|
||||
)}
|
||||
</section>
|
||||
|
||||
<section className="flex flex-col gap-4 rounded-2xl border bg-card p-5 shadow-sm">
|
||||
<h2 className="text-lg font-semibold text-foreground">Wastage</h2>
|
||||
<p className="text-sm text-muted-foreground">Damage, theft / loss and expiry write-offs.</p>
|
||||
<div className="flex items-start gap-4 py-1">
|
||||
<Switch
|
||||
checked={wastageDual}
|
||||
onCheckedChange={setWastageDual}
|
||||
disabled={saving}
|
||||
aria-label="Wastage needs dual approval"
|
||||
className="mt-1 shrink-0"
|
||||
/>
|
||||
<div className="flex flex-col gap-1">
|
||||
<span className="text-base font-medium text-foreground">Wastage needs dual approval</span>
|
||||
<span className="text-sm text-muted-foreground">
|
||||
Off: recording wastage reduces stock immediately. On: two different approvers must approve before stock is reduced
|
||||
(the request waits in the Approval Queue until then).
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section className="flex flex-col gap-4 rounded-2xl border bg-card p-5 shadow-sm">
|
||||
<h2 className="text-lg font-semibold text-foreground">Price adjustments</h2>
|
||||
<p className="text-sm text-muted-foreground">
|
||||
|
||||
@@ -2,16 +2,18 @@
|
||||
|
||||
import { useEffect, useMemo, useState } from "react"
|
||||
import Link from "next/link"
|
||||
import { AlertOctagon, CheckCircle2, X } from "lucide-react"
|
||||
import { useRouter } from "next/navigation"
|
||||
import { AlertOctagon, X } from "lucide-react"
|
||||
|
||||
import { isWastageReasonCode, wastageApi } from "@/lib/api/wastage"
|
||||
import { reasonCodesApi } from "@/lib/api/reason-codes"
|
||||
import { warehousesApi } from "@/lib/api/warehouses"
|
||||
import { itemsApi } from "@/lib/api/items"
|
||||
import { approvalsApi } from "@/lib/api/approvals"
|
||||
import { stockApi } from "@/lib/api/stock"
|
||||
import { errorMessage } from "@/lib/error-map"
|
||||
import { cn } from "@/lib/utils"
|
||||
import { OnHand, ReasonCode, StockAdjustment } from "@/types/stock"
|
||||
import { OnHand, ReasonCode } from "@/types/stock"
|
||||
import { Bin, ItemListItem, Warehouse } from "@/types/master-data"
|
||||
|
||||
import { useAuth } from "@/components/auth/AuthProvider"
|
||||
@@ -25,6 +27,7 @@ import { SuggestInput, SuggestOption } from "@/components/ui/suggest-input"
|
||||
import { toast } from "@/components/ui/toast"
|
||||
|
||||
export default function NewWastagePage() {
|
||||
const router = useRouter()
|
||||
const { isAdmin, branchId: myBranchId, activeBranchId, branchingEnabled } = useAuth()
|
||||
const [warehouses, setWarehouses] = useState<Warehouse[] | null>(null)
|
||||
const [items, setItems] = useState<ItemListItem[] | null>(null)
|
||||
@@ -45,7 +48,12 @@ export default function NewWastagePage() {
|
||||
const [errors, setErrors] = useState<Record<string, string>>({})
|
||||
const [submitError, setSubmitError] = useState<string | null>(null)
|
||||
const [submitting, setSubmitting] = useState(false)
|
||||
const [result, setResult] = useState<StockAdjustment | null>(null)
|
||||
// Settings -> Approvals "Wastage needs dual approval". Null until read; the server decides either way.
|
||||
const [needsApproval, setNeedsApproval] = useState<boolean | null>(null)
|
||||
|
||||
useEffect(() => {
|
||||
approvalsApi.getConfig().then((c) => setNeedsApproval((c.wastageLevels ?? 0) > 0)).catch(() => setNeedsApproval(null))
|
||||
}, [])
|
||||
|
||||
useEffect(() => {
|
||||
const allActiveItems = async () => {
|
||||
@@ -119,9 +127,10 @@ export default function NewWastagePage() {
|
||||
qty: Number(qty),
|
||||
reasonCodeId: reasonCodeId as number,
|
||||
})
|
||||
setResult(adjustment)
|
||||
if (adjustment.status === "Posted") toast.success("Wastage recorded", `${adjustment.docNo} — stock written off.`)
|
||||
else toast.success("Wastage submitted for approval", `${adjustment.docNo} is written off once ${adjustment.requiredApprovals === 2 ? "two people approve it" : "it is approved"}.`)
|
||||
// Straight back to the wastage table, where the new record is listed.
|
||||
router.push("/dashboard/stock/wastage")
|
||||
} catch (err) {
|
||||
setSubmitError(errorMessage(err))
|
||||
toast.error("Could not record wastage", errorMessage(err))
|
||||
@@ -130,16 +139,6 @@ export default function NewWastagePage() {
|
||||
}
|
||||
}
|
||||
|
||||
function startAnother() {
|
||||
setResult(null)
|
||||
setItemId(null)
|
||||
setQty("")
|
||||
setReasonCodeId(null)
|
||||
setSubmitError(null)
|
||||
setOnHand(null)
|
||||
setOnHandError(null)
|
||||
}
|
||||
|
||||
// Same picker as Create Sale / New GRN: type a SKU or name, pick from the list.
|
||||
const itemOptions = useMemo<SuggestOption[]>(
|
||||
() => (items ?? []).map((i) => ({ value: String(i.itemId), label: `${i.sku} — ${i.name}` })),
|
||||
@@ -154,7 +153,11 @@ export default function NewWastagePage() {
|
||||
<div className="flex items-center gap-3">
|
||||
<div>
|
||||
<h1 className="text-2xl font-bold text-foreground">Record Wastage</h1>
|
||||
<p className="text-base text-muted-foreground">Posts immediately as a stock adjustment (FR-STK-07) — a reason code is mandatory.</p>
|
||||
<p className="text-base text-muted-foreground">
|
||||
{needsApproval
|
||||
? "Needs two approvals before stock is reduced (set in Settings → Approvals) — a reason code is mandatory."
|
||||
: "Reduces stock immediately, as a stock adjustment (FR-STK-07) — a reason code is mandatory."}
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -164,38 +167,7 @@ export default function NewWastagePage() {
|
||||
|
||||
{loading && !loadError && <Skeleton className="h-12 w-full" />}
|
||||
|
||||
{!loading && result && (
|
||||
<div className="flex flex-col gap-4">
|
||||
<div className="flex flex-col gap-2 rounded-xl border border-success/30 bg-success/5 p-5">
|
||||
<div className="flex items-center gap-2 text-success">
|
||||
<CheckCircle2 className="size-6" />
|
||||
<p className="text-base font-semibold">
|
||||
{result.status === "Posted" ? `${result.docNo} posted` : `${result.docNo} submitted for approval`}
|
||||
</p>
|
||||
</div>
|
||||
<div className="text-sm text-muted-foreground">
|
||||
{result.status === "Posted" ? (
|
||||
<>Ledger refs: {result.ledgerRefs.join(", ")}</>
|
||||
) : (
|
||||
<>
|
||||
Stock is written off once approved.{" "}
|
||||
<Link href={`/dashboard/stock/adjustments/${result.adjustmentId}`} className="font-medium text-primary hover:underline">View request</Link>
|
||||
</>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
<div className="flex gap-3">
|
||||
<Link href="/dashboard/stock/wastage" className={cn(buttonVariants({ variant: "outline", size: "lg" }))}>
|
||||
Back to wastage report
|
||||
</Link>
|
||||
<Button size="lg" type="button" onClick={startAnother}>
|
||||
Record another
|
||||
</Button>
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{!loading && !result && (
|
||||
{!loading && (
|
||||
<>
|
||||
{(reasonCodes ?? []).length === 0 && (
|
||||
<div className="flex items-center gap-2 rounded-lg border border-warning/30 bg-warning/5 p-4 text-base text-warning">
|
||||
|
||||
@@ -40,10 +40,17 @@ export default function WastagePage() {
|
||||
const [pageSize, setPageSize] = useState(PAGE_SIZE_OPTIONS[1])
|
||||
|
||||
useEffect(() => {
|
||||
Promise.all([reasonCodesApi.list("Adjustment"), itemsApi.list({ pageSize: 200 }), warehousesApi.list()])
|
||||
const allItems = async () => {
|
||||
const first = await itemsApi.list({ pageSize: 200 })
|
||||
const rest = await Promise.all(
|
||||
Array.from({ length: Math.max(first.pagination.totalPages - 1, 0) }, (_, i) => itemsApi.list({ pageSize: 200, page: i + 2 })),
|
||||
)
|
||||
return [first, ...rest].flatMap((r) => r.items)
|
||||
}
|
||||
Promise.all([reasonCodesApi.list("Adjustment"), allItems(), warehousesApi.list()])
|
||||
.then(([rc, it, wh]) => {
|
||||
setReasonCodes(rc.items.filter((r) => isWastageReasonCode(r.code)))
|
||||
setItems(it.items)
|
||||
setItems(it)
|
||||
setWarehouses(wh.items)
|
||||
})
|
||||
.catch((err) => setError(errorMessage(err)))
|
||||
@@ -72,11 +79,16 @@ export default function WastagePage() {
|
||||
: null
|
||||
const pagedRecords = records?.slice((page - 1) * pageSize, page * pageSize) ?? null
|
||||
|
||||
// Only wastage that has actually reduced stock counts towards the totals; requests still waiting for approval are
|
||||
// counted apart (they have no cost yet — FIFO costs are fixed when the stock is written off).
|
||||
const totals = useMemo(() => {
|
||||
if (!records) return { qty: 0, value: 0 }
|
||||
if (!records) return { qty: 0, value: 0, pending: 0 }
|
||||
return records.reduce(
|
||||
(acc, r) => ({ qty: acc.qty + r.qty, value: Math.round((acc.value + r.value) * 100) / 100 }),
|
||||
{ qty: 0, value: 0 }
|
||||
(acc, r) =>
|
||||
r.status === "Posted"
|
||||
? { ...acc, qty: acc.qty + r.qty, value: Math.round((acc.value + r.value) * 100) / 100 }
|
||||
: { ...acc, pending: acc.pending + 1 },
|
||||
{ qty: 0, value: 0, pending: 0 }
|
||||
)
|
||||
}, [records])
|
||||
|
||||
@@ -107,7 +119,7 @@ export default function WastagePage() {
|
||||
)}
|
||||
|
||||
{!loading && (
|
||||
<div className="grid grid-cols-1 gap-4 sm:grid-cols-2">
|
||||
<div className="grid grid-cols-1 gap-4 sm:grid-cols-3">
|
||||
<div className="rounded-xl border border-destructive/20 bg-destructive/5 p-5">
|
||||
<p className="text-sm text-muted-foreground">Total quantity wasted</p>
|
||||
<p className="text-2xl font-semibold text-destructive">{totals.qty}</p>
|
||||
@@ -116,6 +128,10 @@ export default function WastagePage() {
|
||||
<p className="text-sm text-muted-foreground">Total value wasted (LKR)</p>
|
||||
<p className="text-2xl font-semibold text-destructive">{totals.value.toFixed(2)}</p>
|
||||
</div>
|
||||
<div className="rounded-xl border border-warning/30 bg-warning/5 p-5">
|
||||
<p className="text-sm text-muted-foreground">Waiting for approval</p>
|
||||
<p className="text-2xl font-semibold text-warning">{totals.pending}</p>
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
|
||||
@@ -216,7 +232,7 @@ export default function WastagePage() {
|
||||
</div>
|
||||
<div>
|
||||
<p className="text-muted-foreground">Value (LKR)</p>
|
||||
<p className="font-medium text-foreground">{r.value.toFixed(2)}</p>
|
||||
<p className="font-medium text-foreground">{r.status === "Posted" ? r.value.toFixed(2) : "—"}</p>
|
||||
</div>
|
||||
<div className="col-span-2">
|
||||
<p className="text-muted-foreground">Date</p>
|
||||
@@ -268,7 +284,7 @@ export default function WastagePage() {
|
||||
</Badge>
|
||||
</TableCell>
|
||||
<TableCell className="text-right font-semibold text-destructive tabular-nums">-{r.qty}</TableCell>
|
||||
<TableCell className="text-right text-sm text-muted-foreground tabular-nums">{r.value.toFixed(2)}</TableCell>
|
||||
<TableCell className="text-right text-sm text-muted-foreground tabular-nums">{r.status === "Posted" ? r.value.toFixed(2) : "—"}</TableCell>
|
||||
</TableRow>
|
||||
)
|
||||
})}
|
||||
|
||||
@@ -13,6 +13,10 @@ export interface ListAdjustmentsParams {
|
||||
branchId?: number
|
||||
reasonCodeId?: number
|
||||
status?: AdjustmentStatus
|
||||
/** Only wastage: adjustments with a damage / theft / expiry reason code. */
|
||||
wastage?: boolean
|
||||
/** Only adjustments with a line for this item. */
|
||||
itemId?: number
|
||||
sort?: string
|
||||
}
|
||||
|
||||
|
||||
@@ -44,6 +44,8 @@ export interface WastageRecord {
|
||||
}
|
||||
|
||||
export interface ListWastageParams {
|
||||
/** Only this item's wastage (the product page). */
|
||||
itemId?: number
|
||||
warehouseId?: number
|
||||
branchId?: number
|
||||
reasonCodeId?: number
|
||||
@@ -71,20 +73,19 @@ export const wastageApi = {
|
||||
* because the adjustment page is already bounded.
|
||||
*/
|
||||
async list(params: ListWastageParams = {}): Promise<WastageRecord[]> {
|
||||
const wastageIds = new Set(await wastageReasonCodeIds())
|
||||
if (wastageIds.size === 0) return []
|
||||
|
||||
// The API filters by a single reasonCodeId, so a specific pick can be pushed down;
|
||||
// otherwise fetch the page and keep the loss-type rows.
|
||||
// The server returns only wastage (damage / theft / expiry reasons), newest first, so a busy adjustment history
|
||||
// can't push the wastage out of the page the way a browser-side filter over mixed adjustments could.
|
||||
const res = await stockAdjustmentsApi.list({
|
||||
warehouseId: params.warehouseId,
|
||||
branchId: params.branchId,
|
||||
reasonCodeId: params.reasonCodeId,
|
||||
itemId: params.itemId,
|
||||
wastage: true,
|
||||
page: params.page,
|
||||
pageSize: params.pageSize ?? 50,
|
||||
})
|
||||
// A rejected or withdrawn request never wrote anything off.
|
||||
const summaries = res.items.filter((a) => wastageIds.has(a.reasonCodeId) && a.status !== "Rejected" && a.status !== "Cancelled")
|
||||
const summaries = res.items.filter((a) => a.status !== "Rejected" && a.status !== "Cancelled")
|
||||
|
||||
const detailed = await Promise.all(
|
||||
summaries.map(async (summary) => {
|
||||
@@ -94,7 +95,7 @@ export const wastageApi = {
|
||||
])
|
||||
|
||||
return adjustment.lines
|
||||
.filter((line) => line.qtyDelta < 0) // wastage is always a decrease
|
||||
.filter((line) => line.qtyDelta < 0 && (params.itemId === undefined || line.itemId === params.itemId)) // wastage is always a decrease
|
||||
.map<WastageRecord>((line) => {
|
||||
const value = ledger.items
|
||||
.filter((l) => l.itemId === line.itemId && l.direction === "Out")
|
||||
|
||||
@@ -43,6 +43,8 @@ export interface ApprovalConfig {
|
||||
stockAdjustmentLevels: number
|
||||
/** With 2 levels: adjustments worth less than this need one approval. 0 = always two. */
|
||||
stockAdjustmentLevel2ThresholdValue: number
|
||||
/** Approvals wastage needs: 0 = none (stock reduces on save), 2 = two approvers first. */
|
||||
wastageLevels: number
|
||||
priceAdjustmentLevels: number
|
||||
/** With 2 levels: price changes smaller than this % need one approval. 0 = always two. */
|
||||
priceAdjustmentLevel2ThresholdPercent: number
|
||||
|
||||
@@ -21,6 +21,7 @@ export type GlAccountRole =
|
||||
| "Cogs"
|
||||
| "InventoryLoss"
|
||||
| "Cash"
|
||||
| "AccruedExpenses"
|
||||
|
||||
export interface GlAccountOption {
|
||||
accountCode: string
|
||||
@@ -62,6 +63,7 @@ export interface UpdateGlAccountConfigRequest {
|
||||
cogsAccountCode: string | null
|
||||
inventoryLossAccountCode: string | null
|
||||
cashAccountCode: string | null
|
||||
accruedExpensesCode: string | null
|
||||
}
|
||||
|
||||
/** Request-field name per role, so the page can build the PUT body from the mapping list. */
|
||||
@@ -78,6 +80,7 @@ export const GL_ROLE_FIELD: Record<GlAccountRole, keyof UpdateGlAccountConfigReq
|
||||
Cogs: "cogsAccountCode",
|
||||
InventoryLoss: "inventoryLossAccountCode",
|
||||
Cash: "cashAccountCode",
|
||||
AccruedExpenses: "accruedExpensesCode",
|
||||
}
|
||||
|
||||
/** What each role means in accounting terms, and which flows post to it. */
|
||||
@@ -94,6 +97,7 @@ export const GL_ROLE_LABELS: Record<GlAccountRole, { label: string; description:
|
||||
Cogs: { label: "Cost of Goods Sold", description: "Cost of sales — day-end, sales returns" },
|
||||
InventoryLoss: { label: "Inventory Loss", description: "Stock written off by an adjustment or count" },
|
||||
Cash: { label: "Cash", description: "Cash takings at day-end close" },
|
||||
AccruedExpenses: { label: "Accrued Expenses", description: "Expenses booked but not yet paid — Accounts → Expenses (post and pay)" },
|
||||
}
|
||||
|
||||
/** Display order: assets, liabilities, income, expense — the order an accountant reads them in. */
|
||||
@@ -105,6 +109,7 @@ export const GL_ROLE_ORDER: GlAccountRole[] = [
|
||||
"Clearing",
|
||||
"TaxPayable",
|
||||
"AccountsPayable",
|
||||
"AccruedExpenses",
|
||||
"SalesRevenue",
|
||||
"SalesDiscount",
|
||||
"InventoryGain",
|
||||
|
||||
Reference in New Issue
Block a user