Everything the desk does,
beautifully accounted for.

Welcome to HYDDRA

HYDDRA runs the entire operating day of an investment firm — from the moment a prospect's KYC file lands on a desk, through every deposit, deal, valuation and journal, to the quarterly returns filed with the regulator. This manual walks through all sixteen modules the way your team will actually use them.

One idea holds the whole system together

Every number you will ever see in HYDDRA — a client's balance, a fund's NAV, a trial balance line, a figure in an SEC return — is derived from recorded transactions. Nothing is typed into a report by hand. When a cashier posts a deposit, it flows automatically through the ledger, into holdings, into the daily valuation, and out into statements and returns:

The second idea is just as important: nothing significant happens on one person's say-so. Client onboarding, deposits, trades, valuations, fee accruals, journals and regulatory submissions all pass through a maker-checker gate — one officer captures, a different officer approves. Chapter 03 explains how this works everywhere in the system.

Getting started

HYDDRA ships as a self-starting application. One double-click launches the server; everyone on your network then works in a browser.

Launching the server

1. Open the HYDDRA folder and double-click start.command (macOS) or start.bat (Windows). On first run it builds its own Python environment and installs everything it needs — allow a few minutes, once.
2. Wait for the banner. The window prints the two addresses that matter: http://localhost:8000 for this machine, and a network address (e.g. http://192.168.1.24:8000) for colleagues on the same network.
3. Leave the window open. It supervises the server and restarts it automatically if it ever stops. Press Ctrl+C in that window to shut down.

Signing in

/login

On a brand-new installation HYDDRA seeds one account per seat so a team can explore immediately:

The workspace

Every page in HYDDRA lives inside the same calm shell: a navy sidebar of modules on the left, a breadcrumb and your identity on top, and the work itself in the middle. Learn it once, and every module feels familiar.

/app/home

The sidebar

Modules are grouped exactly as this manual is. Click a group to unfold its pages; the gold marker shows where you are. You only see the modules your role can use — a cashier's sidebar is shorter than an administrator's. The ☰ button collapses the sidebar when you want the full width for a wide table.

The top bar

Left to right: the breadcrumb (module / page), the connection indicator, the notification bell, your name and role chip, and Sign out.

Notifications & toasts

The bell collects things that need your role's attention — deals awaiting approval, redemptions at your station, a published NAV. New items also slide in briefly as toasts at the edge of the screen; click one to jump straight to the work. Mark all read clears the counter.

Tables, search and pagination

Every register in HYDDRA — clients, trades, ledger entries — shares the same table tools: a live search box that filters rows as you type (matching any column), and Prev / Next pagination with a running count. If a page has both, they cooperate: search first, then page through the matches.

Money and dates

Amounts display in GHS by default; foreign-currency items state their currency explicitly. Dates follow dd/mm/yyyy in forms. Green, amber and red status pills mean the same thing everywhere: posted/active, pending, rejected/reversed.

Roles & maker-checker

HYDDRA is built around five seats. Each maps to a real desk in an investment firm, and the system enforces the separation between them — in the sidebar, on every route, and in every approval.

How maker-checker works

Wherever something changes money, positions or records of substance, HYDDRA splits the action in two:

The same person cannot both capture and approve a record, and every decision is written to an action log with the officer's name and timestamp. You will meet this pattern in onboarding (Ch. 06), cashier (Ch. 07), redemption stations (Ch. 08), every investment desk (Ch. 09–11), valuations (Ch. 12), journals (Ch. 13), fees (Ch. 15) and regulatory submissions (Ch. 18).

Home dashboard

Home is the firm's morning briefing. It greets you by name, states assets under management, and lays out exactly what is waiting for you — before you've clicked anything.

Reading the page top to bottom:

• The masthead — assets under management, active clients and how many joined today, contributions and net cash for the day, and items awaiting approval across all modules.
• “Items awaiting your desk” — a strip of counters (Cashier, Accounts, Redemptions, Fixed Income, Equities, C.I.S.) filtered to your role. Each is a link straight into the queue.
• Cash flow — contributions against withdrawals for the last 14 days, with totals under each side.
• Asset allocation — the latest valuation snapshot as a ring: cash & custody, fixed income, equities and C.I.S. funds.
• Module cards — one-line summaries of Client Management, Cashier, Redemptions and Fixed Income with their headline numbers.

Setup — reference data

Setup is HYDDRA's reference library — the seventeen registers everything else points at. Get these right first and every later form becomes a dropdown instead of a typing exercise.

/app/setup/issuers

The registers, roughly in the order a new firm fills them:

Pending Setups is the register's own maker-checker queue: sensitive reference changes wait there for a second officer before they take effect.

Client management

Everything about a client lives here: onboarding with KYC, the full client file, statements in four flavours, direct SMS and email, and the credentials that open the member portal.

Onboarding a client

1. Capture. Client Management / New Client — identity (Ghana Card or other ID), contact details, bank accounts, next of kin, risk classification, the relationship manager, and KYC document uploads. Individual and corporate clients are both supported.
2. Queue. The file lands in Pending Clients, where a compliance officer opens it, reviews every section and the attached documents…
3. Decide. …then Approves (the client becomes active and receives an account number) or Denies with a reason. Both outcomes are written to the approval log.

The client file

/app/client-management/clients/…

Open any client from All Clients and you get the whole relationship on one page:

• Tabs — Overview (setup, identity, identification, contact), Transactions (their cash history), Investments, Documents (the KYC vault), and Portal Access.
• Statements on demand — Statement of Holdings, Fund Statement, Cash Statement and Portfolio Report 2, each viewable on screen or downloaded as a branded PDF.
• Send Statement — email a scheme statement for any period directly from the file.
• Send SMS / Send Email — one-off messages that queue through the messaging workers (Ch. 19), with templates.
• Member portal — issue credentials (a temporary password to share securely), reset, lock or unlock the client's online access.

Signatures on file

Upload a client's specimen signature under the KYC documents (document type Signature Specimen) and the Documents tab shows it inline in a dedicated Signatures on file panel — no downloading, no guessing. The same specimen surfaces automatically at the compliance station of every redemption for that client (Ch. 08), so signatories can be verified side-by-side with the signed instruction.

/app/client-management/clients/… · Documents

Monthly statements, in bulk

Client Management / Monthly Statements generates and emails the whole book's statements for a chosen month in one run — each client rendered, branded and queued to the mail worker automatically.

Cashier

The cashier module is where money enters and leaves the firm. Every deposit and withdrawal is captured here, approved here, and receipted here — and from here it feeds the ledger, holdings and NAV automatically.

/app/cashier/dashboard

Taking a deposit or withdrawal

1. Capture. Cashier / Deposit or Cashier / Withdrawal — pick the client, the scheme, amount, currency, mode (cash, cheque, transfer) and reference. Tick SMS/email if the client should be notified on posting.
2. Approve. The transaction waits in Cashier / Pending until a second officer approves or rejects it. Approval posts it to the transactions ledger — and to the general ledger.
3. Receipt. From the transactions register, print a branded receipt PDF or a contract note PDF for the client.

The Transactions register is the firm's full cash journal — searchable, paginated, multi-currency, with reversed items clearly flagged. GHS is the house currency; anything else is listed with its own currency code.

Redemptions

Paying a client out is the most sensitive workflow in any fund. HYDDRA runs it as a relay through four departmental stations, so no single desk can move money alone.

/app/redemptions/dashboard

1. Raise the request. Redemptions / New Request — client, scheme, and the amount (or units). Supporting documents — the signed instruction, ID — can be attached to the request at any stage.
2. Portfolio verifies the data. The request is struck at the published NAV: the current unit price is applied and the units to cancel are computed. A published price must exist — HYDDRA will refuse to strike blind.
3. Compliance verifies signatories against the client's mandate and documents.
4. Portfolio authorises the payout — the final investment-desk sign-off.
5. Finance enters the payment details and settles. The units are cancelled, the cash leg posts to the ledger, and the client can be issued a contract note PDF and a payment voucher PDF.

At every station the officer can also return the request to the previous desk (with a note) or reject it outright. The Work Queue shows only the requests waiting at your station; All Redemptions is the full history, and every request keeps a stage-by-stage log of who moved it and when.

/app/redemptions/…

Verifying signatories, on one screen

Step 3 used to mean opening the client file in another tab to find their specimen signature. Now the request page carries a Specimen signatures on file panel that pulls the client's KYC specimens in automatically — right above the audit trail, next to the uploaded instruction. Compliance compares the two on the spot, then clears (or returns) the request.

/app/redemptions/… · compliance station

Fixed income

The fixed-income desk manages the instruments that anchor most Ghanaian portfolios — fixed deposits, treasury bills, bonds and notes, and DDEP holdings — through their entire life: capture, approval, coupons, and every possible exit.

/app/fixed-income/dashboard

Booking a deal

1. Capture. Fixed Income / New Investment — instrument type, issuer (from Setup), owner (a scheme or a private-wealth client), face value, cost, rate, value date and maturity. HYDDRA assigns the reference (e.g. FI-00142).
2. Approve. The deal waits in Pending Approval; a second officer reviews the term sheet and approves or rejects. On approval it goes active and the ledger entries post.
3. Accrue. From then on the valuation engine accrues its interest daily into NAV — no action needed.

Living with the position

Open any deal from All Investments and the detail page offers every lifecycle action, each one maker-checked and ledger-posting:

• Mature — settle at term; principal and final interest return to cash.
• Sell — exit before maturity at an agreed consideration, with gain/loss computed against book value.
• Rediscount — early liquidation at a discount rate, the T-bill way.
• Top-up — add principal to an open deposit; each top-up takes its own approval.
• Reverse — unwind an erroneous deal, leaving the audit trail intact.
• Contract note — generate and store the branded PDF confirmation against the deal.

Coupons

/app/fixed-income/coupons

Fixed Income / Coupons turns bond terms into a payment diary: Generate builds the schedule of expected coupons; when a payment lands, Mark paid books the cash. Nothing about a coupon is ever remembered in someone's spreadsheet again.

Equity trades

The equities desk covers listed shares on the Ghana Stock Exchange: trading with exchange-accurate fees, positions marked to the latest price, and two ways to keep those prices fresh.

/app/equity-trades/dashboard

Placing a trade

1. Capture. Equity Trades / New Trade — side (buy/sell), the equity, owner, broker, quantity and price. As you type, the live quote panel computes the full consideration including brokerage, the SEC levy, the market development levy and C.S.D. charges — exactly what will hit the ledger.
2. Approve. A second officer clears the trade from Pending. On approval the position updates and the consideration (including each levy, to its own ledger) posts automatically.
3. Confirm. Generate the contract note PDF from the trade's detail page. Erroneous trades can be reversed with full audit trail.

Keeping prices current

Positions are only as honest as their marks. HYDDRA gives you three routes:

• Equity Prices — set a counter's closing price by hand, effective from a chosen date.
• Trading Results — load a whole GSE daily results file at once.
• The GSE price worker (Ch. 19) — fetches closing prices automatically on a schedule, so the desk never opens on stale marks.

C.I.S. trades

When your schemes invest in other people's funds — external collective investment schemes — this desk keeps those unit holdings as disciplined as everything else.

The module mirrors the equity desk deliberately, so there is nothing new to learn:

• New Trade — buy or sell units in any external fund from the Setup register, with a live quote of the consideration at the entered unit price.
• Pending → Approve — the same maker-checker gate; approval updates holdings and posts the ledger.
• Unit Prices — record the external funds' published prices so your positions revalue correctly in the next NAV run.
• All Trades & Reverse — the full register, with reversal for corrections.

Valuations & NAV

This is HYDDRA's daily heartbeat: the valuation engine reads every position the other modules have recorded, prices it, accrues its income, deducts the day's fees — and produces the NAV and unit price your clients transact at.

/app/valuations/dashboard

Running the day's valuation

1. Run. Valuations / Run Valuation — choose the scheme and the as-at date. A progress page tracks the engine as it walks cash, fixed income, equities and C.I.S. positions.
2. Review. The result page itemises every component of NAV — each holding's value, accrued interest and the fee accruals deducted — so an officer can see exactly how the number was built.
3. Publish. A second officer publishes the run, and only then does its unit price become official — the price redemptions strike at (Ch. 08) and statements print.

History and portfolio statements

History keeps every run — published or not — and exports to CSV for trend analysis. Three statement views turn a valuation into client-ready output:

• Portfolio Statement — the scheme-level valuation: allocation summary, cash, fixed income, equities and C.I.S. holdings, with cost, accrued interest, unrealised gain/loss and market value. Also available for an individual managed account, and as a branded PDF.
• Portfolio Report 2 — an alternative presentation of the same truth, matched to a different reporting convention.
• Portfolio Report 3 — a private-banking presentation: a landscape, multi-page PDF (Portfolio Statement · Holdings Detail · Cash Flow) with KPI cards, a net-value panel, an allocation donut, grouped holdings and a plain-language commentary. Run it for a scheme or an individual managed account, with a maturity horizon you choose.

/app/valuations/portfolio-statement

Scheme Clients Values

Where the portfolio statement values the whole scheme, Valuations / Scheme Clients Values breaks it down to the person: every client's units and current value in a chosen fund, as at any date, struck at the published price. Pick the date and scheme, hit Generate, and each client appears with their phone and email — searchable, paginated, and footed with totals.

/app/valuations/scheme-client-values

Accounts — the ledger

Beneath every module runs a full double-entry general ledger. Most postings happen automatically as deals and cash are approved; this module is where finance reads, adjusts, reconciles and closes those books.

/app/accounts/trial-balance

Reading the books

• Trial Balance — closing debits and credits per ledger, with unnatural-side balances flagged. Click any ledger to walk its entries; click any entry to see the full journal it belongs to.
• Financial Statements — income statement and statement of financial position for any period, with PDF export.
• Cash Flow Statement and Changes in Net Assets — the fund-accounting views, also printable.
• Expense Ratio (TER) — the total expense ratio computed from the books.
• Day Book — everything posted on a given day, in posting order.

NAV reconciliation

/app/accounts/nav-reconciliation

The valuation engine values at fair value; the ledger carries book amounts. NAV Reconciliation proves the two agree — component by component — and shows precisely where the fair-value uplift sits. It's the page your auditor will love you for.

Adjusting and controlling

• Chart of Accounts — the ledger tree itself; add or edit ledgers with code, classification and currency.
• Manual Journal — balanced multi-line entries for anything the modules don't post themselves; journals can be reversed, never deleted.
• Accruals & Prepayments — recurring period adjustments.
• Import Transactions — CSV import with a downloadable template and a full preview-before-post step.
• Pending Approvals — the ledger's own maker-checker queue, with batch approval for high-volume days.
• Period Close — lock a period so nothing can post into it; reopening is itself a logged, deliberate act.
• Bank Reconciliation — match ledger cash against the bank statement and carry the reconciling items.

Reports

One hundred and twenty-seven built-in reports, in twelve categories, every one generated live from the books — run on demand, kept in a library, or delivered to inboxes on a schedule you set once.

/app/reports/catalog

Running a report

1. Find it. Reports / Report Catalog — search or browse the twelve categories (see Appendix B for the full map).
2. Parameterise. Open the report and set its parameters — a date range, a scheme, a threshold — many need none at all.
3. Take it away. View the result on screen, or export CSV for analysis and PDF for circulation. Generated files are also stored in the Library.

The catalog is role-aware: each category is visible to the desks it concerns, so a client-services officer sees the client and cashier reports without wading through GL detail.

Schedule & automation

Reports / Schedule & Automation runs a scheduler that checks every 15 minutes whether a completed week or month is missing its report pack — and if so, generates it into the Library and emails it out. You configure the weekly and monthly run hours and the recipient lists for four packs: Management, Compliance, Investment and Operations. A pack with no recipients still generates into the Library — nothing is emailed until an address is configured.

/app/reports/schedule

Fees

Private-wealth billing without the spreadsheet: per-client management and custody fees accrued daily on the client's own portfolio value, approved like everything else, and settled by invoice or cash deduction.

/app/fees/dashboard

1. Set up the fee. Fees / New Fee Setup — client, fee type (management, custody), annual rate, and effective dates. The setup itself is maker-checked before it can bill anyone.
2. Run the accrual. Fees / Run Accrual computes the fee over a period from the client's average daily portfolio value — day by day, not a month-end snapshot.
3. Approve & settle. Each accrual waits for approval, then posts to the ledger and settles by invoice or deduction from the client's cash.

Private wealth

For high-net-worth and segregated managed accounts, HYDDRA provides a reporting suite of its own — the client's directly-held book, valued, measured and explained.

/app/private-wealth/dashboard

• Book Dashboard — the whole desk as at any date: total managed AUM and each account's composition.
• Statement of Account — the client-facing statement of a managed portfolio, with PDF export.
• Performance — the account's value series and returns over time.
• Daily AUM — one client's assets under management valued day by day (see below).
• HNW Clients Values — the whole managed book, per client, as at a date (see below).
• Cost & Charges — what the relationship actually costs the client, stated plainly.
• Household View — related accounts (a family, a group of entities) aggregated into one picture.

Daily AUM — one client, day by day

Pick a client and a period, and Private Wealth / Daily AUM values their managed book for every single day — the same day-by-day valuation the fee engine bills on, now surfaced as a report. Opening, closing, daily-average and peak AUM sit up top; a chart traces the whole series; a newest-first table shows each day with its change. Export to CSV or a branded PDF.

/app/private-wealth/daily-aum

HNW Clients Values — the whole book at a glance

Where Daily AUM is one client over time, Private Wealth / HNW Clients Values is every managed client at one moment: securities, cash and current value per client, as at any date, with book totals across the top. Searchable, paginated, and exportable to CSV or a chromeless Open PDF pop-up.

/app/private-wealth/clients-values

Advisory

For firms that advise rather than manage discretionary money, the Advisory module keeps the whole non-discretionary relationship on the record: a client's risk profile, the model portfolio they're benchmarked against, their advisory mandate, and every recommendation you make — each one suitability-checked and evidenced.

/app/advisory/dashboard

1 · Profile the client's risk

Advisory / Risk Profiling runs a scored questionnaire that lands the client in a risk band — Conservative through Aggressive — with an investment horizon. A new assessment keeps the history and updates the current band; that band is what every later recommendation is judged against. (Portfolio or Client Services can assess.)

/app/advisory/risk-profiles

2 · Define the model portfolios

Advisory / Model Portfolios holds reusable target asset allocations, each mapped to a risk band. A model is the benchmark a client of that band is advised against — and the allocations must total 100%.

/app/advisory/model-portfolios

3 · Agree the mandate

Advisory / Advisory Mandates links a client to their risk band, a model portfolio, an advisory fee and the advised AUM. Mandates are maker-checked — captured, then approved (or rejected) by a second officer, and closed when the relationship ends.

4 · Record every recommendation

Advisory / Record of Advice is the compliance spine of the module: each recommendation — instrument, action, amount — is logged with the client's risk band and the instrument's band, and HYDDRA computes the suitability automatically. Advice within band is Suitable; advice that exceeds the client's band is flagged Review and cannot be saved without a written rationale. Each record generates a client-facing Advice Note PDF.

/app/advisory/advice

Regulatory

Quarter-end without the panic: HYDDRA generates the SEC Ghana returns straight from the books, into the regulator's own Excel templates, with a maker-checker gate before anything becomes the official filing copy.

/app/regulatory/returns

The four returns

• Client Placement Record — every placement by sector, at cost plus accrued interest, in the SEC's sector sheets.
• Funds Under Management (FUM) — FUM by client segment.
• Interconnectedness — Inflow and — Outflow — exposures grouped by customer category and counterparty.

1. Choose the period — year and quarter; HYDDRA states the exact reporting window.
2. Preview the draft. Download an ad-hoc workbook and eyeball the figures. Drafts leave no trace in the submission log.
3. Generate & submit. The workbook is stored exactly as generated, branded with the firm's name and address from System Admin.
4. Second officer approves (or rejects) the submission — only then is it the official copy. Every action carries an audit trail, and the filed workbook can be downloaded forever after.

The FUM market levy

Ghana's 2026 market levy (SEC/GUI/001/02/2026, in force from 1 March 2026) charges a levy on funds under management, and Regulatory / FUM Market Levy computes it straight from the books. Pick the period and HYDDRA values the daily NAV of each fund and segment, applies the fund-type annual rate ÷ days-in-year, and sums it — the grand total is your payment-advice figure, exportable as the SEC's Appendix 1 CSV.

/app/regulatory/fum-levy

Coverage and limits

• Data Coverage — the pre-flight check: confirms every issuer has a sector and every client a segment, so nothing lands in the returns unclassified.
• Investment Limits — define exposure limits (issuer, asset class, cash) and monitor the live book against them; breaches surface here and in notifications, before the regulator finds them.

System administration

The engine room: user accounts, the firm's branding, and the four background workers that keep messages flowing, prices fresh and the client portal in sync — each one observable and controllable from here.

/app/system-admin/dashboard

Users & roles

System Admin / Users & Roles — create accounts, assign one of the five seats, enable/disable, and reset passwords. HYDDRA refuses to let you disable or demote the last active administrator, so you can't lock yourself out of your own system.

Branding

Upload the firm's logo and set its name, address and contact lines once — every statement, receipt, contract note, report PDF and SEC return renders with them from then on.

Messaging: SMS & email

• Configuration — the SMS gateway and SMTP credentials, plus reusable message templates.
• Workers — start, stop or run-now the delivery workers; each shows its poll interval, session counters and last run.
• Outboxes — every queued, sent and failed message. Open a failed SMS, correct the recipient number, and resend — no message is ever silently lost.

Data workers

• Online Sync Worker — the bridge that keeps the client portal's database current with the operational books.
• GSE Equity Prices — fetches Ghana Stock Exchange closing prices on schedule (Ch. 10).
• GFIM Excel Reports — downloads the Ghana Fixed Income Market daily report files for a chosen date, kept and served from within HYDDRA.

Role access matrix

What each seat sees in the sidebar. The Administrator sees everything; route-level checks enforce the same map even if a URL is typed directly.

The report catalog

All 127 built-in reports, by category. Every report runs live from the books, exports to CSV and PDF, and lands in the Library.

Troubleshooting & FAQ

“I captured a transaction and nothing changed.”

It's waiting for its checker. Look at the module's Pending page — and remember the officer who approves must be someone other than you.

“A redemption won't strike.”

Striking requires a published unit price. Run and publish the day's valuation (Ch. 12) first.

“The client didn't receive their SMS / email.”

Check the outbox in System Admin: if the message shows failed, open it, fix the recipient, and resend. If the whole queue is stuck, the worker is probably stopped — start it from its worker page.

“I can't see a module I need.”

Your seat doesn't include it (Appendix A). An administrator can change your role in Users & Roles.

“Equity positions look mispriced.”

The mark is stale. Set the price manually, load the day's trading results, or check that the GSE price worker is running (Ch. 10, 19).

“I need to undo a posted deal.”

Nothing in HYDDRA is deleted. Use the record's Reverse action — the reversal posts contra entries and both records stay on file.

“A journal won't post into last month.”

The period is closed. A finance officer can reopen it from Period Close — deliberately, and on the record.

“The server window closed — is everything gone?”

No. All data is in the database, not the window. Double-click the launcher again; it restarts in seconds and supervises itself thereafter.

Glossary