shad0w/pelagia-portal
1
0
Fork 0
Code Issues 2 Pull requests Projects Releases Packages Wiki Activity Actions 1
pelagia-portal/CHANGELOG.md
Hardik 58a5a00594 docs: bring CLAUDE.md, README, Docs and CHANGELOG up to date with current product 
Reflects this iteration's domain/feature changes across the docs set:
- Cost centre = Vessel only (labelled 'Cost Centre'); costCentreRef/Site removed
- Companies (multi-company invoicing) on POs and exports
- 3-level 6-digit accounting-code hierarchy; leaf-only PO selection
- Structured PO numbers COMPANY/VESSEL/ID/FY (ids from 9000)
- Compulsory payment date; editable poDate; export date = approval date
- Submitter vendor creation (unverified until proven); verifyVendor
- Import PO -> CLOSED with auto vendor/product creation
- Inventory flag; inventory added at approval; partial pay/receipt states
- Microsoft Entra SSO (nullable passwordHash); profile reachable by all roles
- README: roles, domain concepts, db:seed:prod, migrate-before-serve callout
- CHANGELOG: Added/Changed/Fixed for the above

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-19 12:43:24 +05:30

4.2 KiB
Raw Blame History

Changelog

[Unreleased]

Added

  • Companies (multi-company invoicing) — new Company model and /admin/companies CRUD. A PO is billed under a selected company (name, short code, GST number, address, phone/mobile, contact + invoice email, invoice address). The company's details populate the exported PO header / invoice block.
  • Structured PO numbers (lib/po-number.ts) — COMPANY/VESSEL/ID/FY (e.g. PMS/HNR1/9000/2024-25); Indian financial year; system-generated IDs start at 9000. Imported POs keep their original number.
  • 3-level accounting-code hierarchy — Account.parentId self-relation (Top Category → Sub-Category → Leaf), 6-digit numeric codes seeded from prisma/accounting-codes-data.ts. Only leaf codes are PO-selectable, via a searchable, portal-rendered combobox.
  • Compulsory payment date — PurchaseOrder.paymentDate captured when Accounts records a payment; defaults to today, rejects future dates. Backfilled for existing POs from paidAt / the first payment action.
  • Editable PO date (poDate) — the exported PO "Date" now shows poDate ?? approvedAt ?? createdAt (approval date once approved, not creation).
  • Submitter vendor creation — create_vendor permission lets Technical/Manning add vendors; they are created unverified and become verified when a PO closes/pays with them, on import, or via Manager/Accounts/Admin (verifyVendor).
  • Import PO → Closed — /po/import saves a parsed Excel PO directly as CLOSED, auto-detecting the company, matching the vessel by code, and auto-creating the vendor, products, and per-vendor prices.
  • Inventory feature flag (NEXT_PUBLIC_INVENTORY_ENABLED) — site stock/consumption surfaces are gated; the vendor/item catalogue for PO creation stays available. Inventory is incremented at PO approval (not on close).
  • Dashboards — Accounts gains a "Payments Completed This Month" card.
  • Automated issue-to-deploy pipeline — end-to-end flow from a user-reported bug to a production fix without manual intervention on the developer's part:
    • Report Issue button (App/components/layout/report-issue-button.tsx) — any signed-in user can file a bug from the portal header; the server action (report-issue-actions.ts) calls the Forgejo API and attaches portal + claude-queue labels.
    • Claude issue watcher (automation/claude-issue-watcher.ps1) — a Windows Scheduled Task (PelagiaClaudeIssueWatcher) polls Forgejo every 10 minutes, picks up claude-queue issues, and runs Claude Code headlessly to implement and verify a fix. On success the watcher pushes a claude/issue-N branch and opens a PR; on failure it posts a comment and labels the issue claude-failed.
    • Tag-triggered deploy workflow (.forgejo/workflows/deploy.yml) — pushing a v* semver tag triggers the host Forgejo runner on pms1, which checks out the tag, runs pnpm install, builds the app, applies Prisma migrations, and restarts the pm2 process ppms.

Changed

  • Cost centre is now a Vessel only. The earlier Vessel-or-Site cost-centre model was removed: PurchaseOrder.vesselId is required, the costCentreRef encoding is gone, and Vessel no longer links to a Site. Vessels are surfaced as "Cost Centre" throughout the UI (/admin/vessels → "Cost Centre Management").
  • Closed Purchase Orders list: submitters see only their own CLOSED POs; Managers/SuperUsers see all CLOSED POs.
  • Sidebar reorganised into Purchasing and Administration sections (role-aware); "Inventory" renamed to "Purchasing".
  • Items: /admin/products is the editable catalogue; /inventory/items is read-only; both link to a shared item detail page.
  • Profile page is reachable by every role (incl. SSO-only / no-password users, with an email fallback lookup); only approvers can upload an approval signature.
  • Manager dashboard "Approved This Month" now counts by approvedAt (no longer undercounts once a PO progresses past MGR_APPROVED).

Fixed

  • Production P2022 … column does not exist after deploy — caused by shipping code whose Prisma client expected a column before migrate deploy had run. Migrations must be applied before the new build serves traffic (now documented in the README).