AMU Technical Architecture & Infrastructure Compatibility Brief
Asset Management Unit Internal Software Solution — a clear technical review document for infrastructure alignment before the production architecture is finalized.
Executive Summary
The AMU solution is proposed as a secure, browser-based internal application for managing assets, cases, documents, movements, custody information, reporting, user access and auditable activity.
The prototype defines business workflows and user experience. This brief is intended to align the production implementation with Government IT's approved infrastructure before the final production architecture is locked.
Contents
What AMU Needs the System to Do
- Provide authenticated internal access to authorized AMU personnel.
- Maintain structured records for assets, cases, source agencies, movements, custody, contacts and related operational data.
- Store and retrieve protected documents and media, including PDFs, photographs, scans and other approved attachments.
- Enforce role-based access so users see and perform only functions authorized for their role.
- Maintain audit records for significant user and system activity.
- Generate operational and compliance reports and support controlled export/printing where authorized.
- Support secure integration with approved identity, email, storage, logging and infrastructure services where required.
Proposed Application Technology Stack
The following describes the current technical direction. Development tools do not automatically become production dependencies.
| Layer | Proposed Technology | Purpose |
|---|---|---|
| Frontend | React / Next.js, TypeScript, HTML, CSS | Production interface, routing, forms and reusable components. |
| Application runtime | Node.js-compatible runtime | Server-side application logic and approved API endpoints. |
| Database | PostgreSQL | Relational system of record for AMU operational data. |
| Database language | SQL | Schema definition, queries, reporting and controlled data operations. |
| Application/API layer | Developer-built server/API endpoints within the Next.js/Node.js application | Controlled communication between the interface, PostgreSQL, protected storage and approved Government integrations; production exposure and security standards are aligned with Government IT. |
| Document/media storage | Protected object or file storage | PDFs, images, scans, videos and authorized attachments. |
| Authentication | Government-approved identity provider preferred | Identifies authorized users; production method to be confirmed by IT. |
| Authorization | RBAC plus server/database controls | Enforces approved application roles and restricted access. |
| Audit logging | Application audit trail + infrastructure logging | Records significant access, changes and actions. |
| Source/version control | Git; private repository during development | Change history, controlled development and release management. |
| Development platform | Supabase may be used for development/prototyping | Development convenience only; does not dictate Government production hosting. |
High-Level Architecture
AUTHORIZED AMU USERS
↓
GOVERNMENT-APPROVED IDENTITY / MFA
↓
AMU WEB APPLICATION
React / Next.js / TypeScript
↓
AMU SERVER / API LAYER
Developer-built application logic, validation & authorization
↓
PostgreSQL Database ─ Protected File Storage ─ Audit / Logging
↓
APPROVED GOVERNMENT SYSTEM APIs / INTEGRATIONS (where required)
↓
GOVERNMENT-APPROVED HOSTING, NETWORK, SECURITY,
BACKUP, MONITORING & RECOVERY CONTROLSProduction Capabilities Required from Government IT
Government IT may satisfy these requirements using its existing approved products and infrastructure.
| Capability | Information / Service Needed |
|---|---|
| Hosting / compute | Approved environment capable of hosting the web application and supported runtime. |
| Database | Supported PostgreSQL deployment, version, connectivity, administration and backup standards. |
| Identity | Approved organizational authentication, SSO and MFA method. |
| File storage | Protected storage appropriate for AMU documents/media, with access controls and retention rules. |
| Networking | Approved internal/private access model, DNS, certificates and connectivity between components. |
| Encryption | Approved TLS/HTTPS, encryption-at-rest and key/certificate management requirements. |
| Secrets | Approved mechanism for passwords, connection strings, API credentials and other secrets. |
| Logging / monitoring | Approved application, infrastructure and security logging/monitoring destinations. |
| Backup / recovery | Database and file backup, restore testing, retention and disaster-recovery requirements. |
| Approved SMTP/API service if notifications or report delivery are required. | |
| Security review | Required vulnerability scanning, code review, testing and production release controls. |
| Environments | Standards for development, UAT/testing and production separation. |
| API / integration standards | Approved standards for internal APIs, network exposure, authentication, credentials, service-to-service access and connections to existing Government systems. |
Application Security Controls in the Build
- Authentication integrated with the approved identity mechanism.
- Role-based authorization enforced on protected operations, not only hidden in the interface.
- Least-privilege access for application roles and service identities.
- Server-side input validation and safe database access practices.
- Controlled file upload, file type/size validation and authorization before document access.
- Secure session handling and protection of authentication tokens/cookies.
- Secrets kept out of source code and repositories.
- Audit logging for defined sensitive and administrative actions.
- Dependency and source-code security scanning during development where available.
- Separate development/testing and production configuration.
- Security requirements reviewed against an accepted application-security baseline such as OWASP ASVS, subject to Government IT standards.
Development vs. Government Production
Source Code
Developer-managed using Git/version control and a private development repository. Government may specify the approved final repository or transfer process.
Database
Development may use Supabase/PostgreSQL. Production should use the Government-approved PostgreSQL service or deployment.
File Storage
Development storage may hold non-production/test material. Production files must use Government-approved protected storage.
Authentication
Development/test identities may be used before integration. Production should integrate with the approved Government identity/MFA solution.
Deployment
The developer prepares the application and deployment documentation. Government IT confirms hosting, networking, infrastructure security and release procedures.
AMU API / Backend
The developer designs and implements AMU server/API endpoints, validation, authorization and backend business logic. Government IT approves the production hosting, network exposure, identity/service authentication, secrets, monitoring and deployment standards.
Existing Government Integrations
The developer builds the AMU-side connector. The Government system owner/IT team provides or approves the API/integration method, documentation, access, credentials and security/network requirements.
API & Integration Responsibility
The AMU application will include its own server-side API layer. This API is part of the application code and will be designed and developed by the Digital Solutions Architect/Developer. It is not a separate Government product that IT must build.
Government IT / Security is responsible for approving or providing the production environment in which that API operates, including hosting, network exposure, identity/service authentication, certificates, secrets, firewall/private-access rules, monitoring, logging and deployment/security standards.
| Area | Developer / AMU Application | Government IT / System Owner |
|---|---|---|
| AMU application API | Design and develop endpoints, backend business logic, validation, authorization, database/storage operations and application audit actions. | Approve/provide production hosting, networking, identity/service authentication, certificates, secrets, monitoring and deployment/security requirements. |
| Existing Government API | Build the AMU-side integration/connector according to approved specifications. | The owning Government system/IT team provides or approves the API/integration method, endpoint documentation, access process, credentials and applicable security/network requirements. |
| Data exchanged through integrations | Implement only approved fields, validation and application handling. | Confirm authorized data scope, connectivity, retention, logging and any inter-agency/security controls. |
Information Requested from Government IT
Please provide or confirm the following before the AMU production architecture is finalized.
- What hosting environment is approved for the AMU application (on-premises, Azure, private cloud, another approved environment, or a combination)?
- Is PostgreSQL supported? If yes, what versions and deployment model are approved?
- Is a Node.js-compatible application runtime supported? Are there approved versions or runtime restrictions?
- Are containerized applications such as Docker supported or preferred, or is direct server deployment required?
- What identity provider is used for staff authentication (for example, Microsoft Entra ID/Active Directory or another approved service)?
- Can AMU integrate with that identity provider for Single Sign-On (SSO) and Multi-Factor Authentication (MFA)?
- What storage service is approved for documents, images, scans, videos and related attachments?
- What encryption, certificate, key-management and secrets-management standards must the application follow?
- What network access model is required: internal network only, VPN, approved remote access, private-cloud access, or another model?
- What backup, retention, restore-testing and disaster-recovery requirements apply to the database and file storage?
- What application/security logging and monitoring platforms must AMU integrate with?
- What approved email/SMTP/API service should be used for notifications or internally generated reports?
- What vulnerability scanning, application-security testing, code review or security approval is required before production?
- What is the required process for moving releases through Development → UAT/Testing → Production?
- Are there Government coding, API, accessibility, database, records-retention or application-security standards that must be followed?
- Where must final source code, database migration scripts and technical documentation be stored or transferred?
- Are external development services permitted for non-production work, and what restrictions apply to data used in those environments?
- Are there restrictions on open-source frameworks, third-party packages, licenses or software dependencies?
- What are the expected availability, performance, storage-capacity and file-size requirements for the AMU system?
- Who should serve as the Government IT/security technical contact for architecture review, environment provisioning and deployment?
- What standards must the AMU application follow for internal API authentication, authorization, endpoint security, versioning and logging?
- Must AMU application APIs remain private/internal only, and what network controls or gateway/WAF requirements apply?
- If AMU needs to connect to an existing Government system, who owns that integration and who will provide the approved API/interface specifications, credentials and technical documentation?
- Are service accounts, managed identities, API keys, OAuth/OIDC tokens, mutual TLS or another method required for system-to-system authentication?
IT Compatibility Response Sheet
Government IT may use this section as a concise response checklist. Additional technical notes can be attached where necessary.
| Item | IT Response | Notes / Requirement |
|---|---|---|
| Approved hosting environment | ||
| PostgreSQL supported / approved version | ||
| Approved application runtime | ||
| Container support / deployment method | ||
| Identity provider / SSO / MFA | ||
| Approved document/file storage | ||
| Secrets / key management | ||
| Network access model | ||
| Logging / monitoring platform | ||
| Backup / disaster recovery standard | ||
| Approved email service | ||
| Development/UAT/Production process | ||
| Security testing / release requirements | ||
| Source-code repository / handover standard | ||
| Primary IT technical contact | ||
| API design / security standard | ||
| API network exposure / gateway requirement | ||
| Government-system integration owner / contact | ||
| System-to-system authentication method |
Proposed Responsibility Boundary
| Party | Primary Responsibility |
|---|---|
| Digital Solutions Architect / Developer | Application architecture; frontend/backend implementation; AMU server/API design and development; database schema/migrations; application-level authorization and validation; secure coding; application audit features; approved integration connectors; tests; technical documentation; deployment package/configuration requirements. |
| AMU Business Owners | Approve workflows, roles, records, reports, operational rules, access needs and acceptance criteria. |
| Government IT / Security | Approve/provide production hosting, network, identity, certificates/keys, secrets, infrastructure security, production database/storage services, API exposure/security standards, monitoring, backups/recovery and release/security standards. For Government-owned systems, provide or coordinate approved integration/API specifications and access requirements. |
| Joint Responsibility | Architecture alignment, identity integration, API/integration security review, UAT, security remediation, deployment validation, operational handover and change-management process. |
Editable Government IT Response Form
For ease of technical review, Government IT may complete the separate editable Word response form and return it by email. The form mirrors the compatibility questions in this brief and provides dedicated fields for requirements, integration contacts, comments and review status.
Requested Next Step
Technical Review Sign-Off / Comments
| Reviewer | Role / Department | Date | Comments / Follow-up |
|---|---|---|---|