Skip to content

Topic map

The topic register assigns each subject a reader question, an article type and a canonical address. All 85 detailed answers are reviewed; preserved summaries link to their owning articles. Review depth describes writing, not independent product acceptance. The table is generated from COVERAGE.yaml.

Follow Documentation structure when splitting a topic into a separate article. Keep the previous summary anchor as a link to the new article so existing references remain useful.

Purpose and boundaries

What work does Toolora support, and where do its responsibilities end?

TopicReader questionArticle typeDetail status
Product purpose
purpose/product
Who uses Toolora, and which work does it connect?conceptreviewed
Actors and responsibilities
purpose/actors
Which actors participate in Toolora workflows?referencereviewed
Ownership across system boundaries
purpose/ownership
Which records and outcomes belong to external systems?conceptreviewed
Current environment boundary
purpose/environment
Which shared checks can have real external effects?referencereviewed

Landscape and architecture

How do application components, data paths and policy boundaries fit together?

TopicReader questionArticle typeDetail status
Two application data paths
architecture/data-paths
When does an operation use RLS or the privileged API?conceptreviewed
Identity, company context and resource authority
architecture/authorization
Where is caller authority established?conceptreviewed
Transaction and external-effect boundaries
architecture/transactions
Which changes can be committed atomically?conceptreviewed
Declared runtime topology
architecture/runtime
Which public entry point serves each component?referencereviewed
External dependency ownership
architecture/providers
Which external records and services does Toolora depend on?referencereviewed

Domain model and vocabulary

Which business records does Toolora distinguish, and how are they related?

TopicReader questionArticle typeDetail status
Customers and contacts
domain/customers
How do customers, contacts and recipient roles differ?conceptreviewed
Projects and work orders
domain/projects
What belongs to a project, and what belongs to a work order?conceptreviewed
Source offers and accepted agreements
domain/agreements
Which relationship establishes commercial authority?conceptreviewed
Publication and record ownership
domain/publication
How does publication affect a project record?conceptreviewed

Identity, companies and authorization

Where does Toolora decide whether a caller may read or change a record?

TopicReader questionArticle typeDetail status
Authentication and sessions
access/identity
How does a request obtain a verified identity?conceptreviewed
Active company and membership
access/company
How is the company context selected and preserved?conceptreviewed
Capabilities and resource access
access/permissions
Why is a capability insufficient to authorize an operation on a particular record?conceptreviewed
Customer portal access
access/customer-portal
Which checks govern access to customer project information?conceptreviewed
Worker and subcontractor access
access/assignments
How do assignments limit worker and subcontractor access?conceptreviewed
MCP authorization
access/mcp
Which permissions apply at MCP entry and on individual tools?referencereviewed

End-to-end business workflows

How do commercial, operational and financial records change during a customer engagement?

TopicReader questionArticle typeDetail status
Enquiry and quote acceptance
workflows/quote-acceptance
How does a customer request become accepted commercial work?conceptreviewed
Planning, execution and review
workflows/execution
How does planned work become reviewed delivery evidence?conceptreviewed
Subcontractor requests and awards
workflows/subcontracting
How does a subcontractor response become an awarded commitment?conceptreviewed
Invoicing and settlement
workflows/settlement
Which facts are needed to follow work through invoicing and settlement?conceptreviewed

User interfaces

How do the role surfaces present authorized work and its current state?

TopicReader questionArticle typeDetail status
Office workspaces
experience/office
Which work is organized in the office interface?conceptreviewed
Customer, worker and subcontractor surfaces
experience/portals
How do the portals differ in scope?conceptreviewed
Editing and conflict states
experience/editing
How does the interface explain saves and concurrent changes?conceptreviewed
Responsive layout and accessibility
experience/presentation
Which presentation rules apply across devices and themes?referencereviewed

Frontend implementation

How are routes, state and data operations organized in the browser application?

TopicReader questionArticle typeDetail status
Routes and role surfaces
frontend/routes
Where do application navigation and role-specific pages begin?referencereviewed
Company-scoped queries and cache
frontend/cache
How is query state separated between companies?conceptreviewed
Mutations and concurrent edits
frontend/mutations
How do browser edits reach the owning transaction?conceptreviewed
Configuration and generated types
frontend/configuration
Which configuration and type information belongs in the frontend?referencereviewed

API and application services

Which operations belong in FastAPI, and how are their contracts enforced?

TopicReader questionArticle typeDetail status
Route policy and resource scope
api/policy
What must a privileged handler verify before business work?conceptreviewed
Request and response contracts
api/contracts
Where are inputs, outputs and errors defined?referencereviewed
Domain and provider services
api/services
How is reusable server behaviour separated from HTTP handling?conceptreviewed
Conflicts and uncertain outcomes
api/errors
How should a caller interpret a conflict or an uncertain provider result?troubleshootingreviewed

Data model and database

Where are persistent records, access policies and transactional invariants defined?

TopicReader questionArticle typeDetail status
Records, relationships and projections
database/records
Which data is authoritative for a business fact?conceptreviewed
Row-level security
database/rls
Which boundary governs direct browser data access?conceptreviewed
Functions and transaction boundaries
database/transactions
Where must multi-record invariants be enforced?referencereviewed
Migrations and generated types
database/migrations
How is a schema change prepared and released?procedurereviewed

Files, documents and communication

How are files, originals and communications scoped and published?

TopicReader questionArticle typeDetail status
Storage and signed links
documents/storage
How do file paths and retrieval links preserve access scope?referencereviewed
Conversation audiences
documents/audiences
Who may read a project or work conversation?conceptreviewed
Mail originals and attachment evidence
documents/originals
Which system preserves mail originals and their coverage?conceptreviewed
Document candidates and interpretation
documents/intake
When does a preserved attachment become business data?conceptreviewed

Finance and reconciliation

Which records establish amounts, financial authority and reconciliation status?

TopicReader questionArticle typeDetail status
Billing basis and invoices
finance/billing-basis
How is accepted commercial value made available for invoicing?conceptreviewed
ROT and RUT allocations
finance/deductions
Which facts determine household-work deduction evidence?referencereviewed
Payments and reconciliation
finance/reconciliation
What supports a conclusion about payment and outstanding balance?conceptreviewed
Purchase costs and allocations
finance/costs
How can one supplier cost be attributed to several projects?conceptreviewed
Time and payroll handoff
finance/time-payroll
Which time is eligible for a payroll handoff?conceptreviewed
Reports and amount definitions
finance/reports
How do report datasets determine totals and coverage?referencereviewed

Integrations and shared services

Which external contracts does Toolora consume, and who owns their data and outcomes?

TopicReader questionArticle typeDetail status
Integration ownership
integrations/ownership
Which responsibilities remain in Toolora when a shared service is used?conceptreviewed
Accounting and Fortnox
integrations/accounting
Which accounting responsibilities belong to the connector and the local adapter?referencereviewed
Estate mail archive
integrations/mail
What does Toolora read from the mail archive?referencereviewed
Retries and external outcomes
integrations/recovery
How can an integration recover without repeating an uncertain action?troubleshootingreviewed

AI, assistant and MCP

What context may AI clients read, and when can a proposal change business records?

TopicReader questionArticle typeDetail status
MCP tools and responses
ai/mcp
Which contract describes the current public MCP interface?referencereviewed
Context and source evidence
ai/context
How is source information bounded before model use?conceptreviewed
Proposals and human confirmation
ai/proposals
When does an AI proposal become an ordinary business record?conceptreviewed
Usage, audit and feedback
ai/governance
How are tool use and unsupported requests accounted for?referencereviewed

Background work and change feeds

Which work continues outside an interactive request, and how is progress represented?

TopicReader questionArticle typeDetail status
Schedulers and enablement
background/schedulers
Where are scheduled jobs registered and enabled?referencereviewed
Intent, processing and receipts
background/outcomes
How do queued work and completed outcomes differ?conceptreviewed
Change feeds and checkpoints
background/changes
How does a caller resume authorized change tracking?referencereviewed
Stalled work and diagnosis
background/stalled
What evidence distinguishes an idle job from blocked business work?troubleshootingreviewed

Import, history and data quality

How does imported history preserve identity and business meaning without creating new effects?

TopicReader questionArticle typeDetail status
Preserved sources and identifiers
imports/sources
Which source identity must survive an import?referencereviewed
Historical replay and side effects
imports/replay
Why must replayed history avoid forward-looking notifications?conceptreviewed
Identity, relation and value checks
imports/reconciliation
What must reconciliation establish beyond matching row counts?referencereviewed
Operational transition
imports/cutover
When does Toolora become the system of action for new work?conceptreviewed

Security and information handling

Which controls protect identity, company isolation and sensitive information?

TopicReader questionArticle typeDetail status
Trust boundaries and privileged access
security/trust
Where does an operation cross into a more privileged context?conceptreviewed
Credentials and configuration
security/credentials
Where do secret values belong, and how are replacements verified?referencereviewed
Personal data, originals and retention
security/data
Which data lifecycle rules apply to records and attachments?referencereviewed
Audit, logs and incident evidence
security/logs
What can be recorded without copying sensitive content?referencereviewed

Infrastructure and runtime

Where do Toolora components run, and which configuration and platform responsibilities support them?

TopicReader questionArticle typeDetail status
Runtime components and services
infrastructure/services
Which runtime component serves each application entry point?referencereviewed
Configuration and service identities
infrastructure/configuration
How do runtime identities obtain their component configuration?referencereviewed
Release directories and publication
infrastructure/publication
How is a built candidate made current?conceptreviewed
Shared infrastructure ownership
infrastructure/ownership
Which capabilities should Toolora consume rather than reproduce?conceptreviewed

Development, testing and delivery

How does a change move from local implementation to an identified, checked release?

TopicReader questionArticle typeDetail status
Local development and synthetic data
delivery/local
How is an isolated development environment prepared?procedurereviewed
Test levels and evidence
delivery/tests
Which checks run automatically, and what can they prove?referencereviewed
Pull requests and application release
delivery/releases
How is a coherent change reviewed and published?procedurereviewed
Schema delivery and compatibility
delivery/schema
How do database changes remain compatible with application publication?procedurereviewed

Monitoring, diagnosis and recovery

How are failures detected, investigated and recovered with evidence?

TopicReader questionArticle typeDetail status
Health, readiness and versions
operations/health
What does each runtime signal establish?referencereviewed
Workflow diagnosis
operations/diagnosis
How is an observed failure traced to its owning component or record?troubleshootingreviewed
Backup and recovery evidence
operations/recovery
What must a recovery check include before an application outcome is claimed?procedurereviewed
Incident response
operations/incidents
How is an incident contained and its recovery verified?procedurereviewed

Decisions, limitations and system status

Which sources establish decisions, current limitations and verified delivery status?

TopicReader questionArticle typeDetail status
Document ownership and decisions
decisions/authority
Which source owns a rule when documents disagree?referencereviewed
Known limits and open decisions
decisions/limits
How are unresolved definitions and missing evidence represented?referencereviewed
Implementation and release status
decisions/status
How do implemented, merged, deployed and verified states differ?conceptreviewed
Scenario evidence and coverage
decisions/evidence
How should a reader interpret a test or delivery receipt?referencereviewed