Updated GL System , Updated user manual

server/routes/books.js

@@ -1,9 +1,15 @@
 const express = require('express');
+const multer = require('multer');
 const { requireCapability } = require('../middleware/auth');
 const { bookLedger, createBook, deleteBook, ledgerReport, listBooks, updateBook } = require('../services/books');
 const { exportReport } = require('../services/reportExport');
+const { rowsFromImport, extensionForUpload } = require('../services/importExport');
+const glEntries = require('../services/glEntries');
 
+const upload = multer({ storage: multer.memoryStorage(), limits: { fileSize: 16 * 1024 * 1024 } });
 const router = express.Router();
+const ledgerReader = requireCapability('finance.view');
+const ledgerEditor = requireCapability('finance.manage');
 
 router.get('/books', (req, res) => {
   res.json(listBooks(req.companyId));
@@ -43,4 +49,73 @@ router.post('/books/:code/ledger/export', async (req, res) => {
   return res.send(output.body);
 });
 
+// ---- GL journal entries (stored, editable; full audit) ----------------------
+
+function glFilters(query, code) {
+  return { book: code, year: query.year ? Number(query.year) : null, account: query.account || null, search: query.search || null };
+}
+
+router.get('/books/:code/gl-entries', ledgerReader, (req, res) => {
+  res.json(glEntries.listEntries(glFilters(req.query, req.params.code), req.companyId));
+});
+
+router.post('/books/:code/gl-entries', ledgerEditor, (req, res, next) => {
+  try {
+    res.status(201).json({ entry: glEntries.createEntry(req.params.code, req.body, req.user.id, req.companyId) });
+  } catch (error) {
+    next(error);
+  }
+});
+
+router.put('/books/:code/gl-entries/:id', ledgerEditor, (req, res, next) => {
+  try {
+    const entry = glEntries.updateEntry(req.params.id, req.body, req.user.id, req.companyId);
+    if (!entry) return res.status(404).json({ error: 'GL entry not found' });
+    return res.json({ entry });
+  } catch (error) {
+    return next(error);
+  }
+});
+
+router.delete('/books/:code/gl-entries/:id', ledgerEditor, (req, res) => {
+  if (!glEntries.deleteEntry(req.params.id, req.user.id, req.companyId)) return res.status(404).json({ error: 'GL entry not found' });
+  return res.status(204).end();
+});
+
+// Per-entry change timeline (from the audit log).
+router.get('/books/:code/gl-entries/:id/history', ledgerReader, (req, res) => {
+  const history = glEntries.entryHistory(req.params.id, req.companyId);
+  if (!history) return res.status(404).json({ error: 'GL entry not found' });
+  return res.json({ history });
+});
+
+// Dry-run: parse the uploaded CSV/Excel and classify each row (new/update/duplicate/error).
+router.post('/books/:code/gl-entries/import/preview', ledgerEditor, upload.single('file'), async (req, res, next) => {
+  try {
+    if (!req.file) return res.status(400).json({ error: 'File is required' });
+    const rows = await rowsFromImport(extensionForUpload(req.file.originalname), req.file.buffer);
+    res.json(glEntries.previewImport(rows, req.params.code, req.companyId));
+  } catch (error) {
+    return next(error);
+  }
+});
+
+// Commit the classified rows from the preview using the chosen conflict strategy.
+router.post('/books/:code/gl-entries/import/commit', ledgerEditor, (req, res, next) => {
+  try {
+    res.json(glEntries.commitImport(req.body.rows || [], req.body.strategy, req.params.code, req.user.id, req.companyId));
+  } catch (error) {
+    return next(error);
+  }
+});
+
+router.get('/books/:code/gl-entries/export', ledgerReader, async (req, res) => {
+  const report = glEntries.entriesReport(glFilters(req.query, req.params.code), req.companyId);
+  const format = ['csv', 'xlsx'].includes(String(req.query.format).toLowerCase()) ? String(req.query.format).toLowerCase() : 'csv';
+  const output = await exportReport(report, format);
+  res.setHeader('Content-Type', output.contentType);
+  res.setHeader('Content-Disposition', `attachment; filename="deprecore-${req.params.code}-gl-entries.${format}"`);
+  return res.send(output.body);
+});
+
 module.exports = router;