page:blueprints:accounting firms:project tracker:django

Accounting firms: project tracker using Django

A project tracker blueprint for accounting firms built with Django on Ample. Domain schema:

Public information: service lines and typical engagement periods, filing calendars and deadlines, office locations. Kept out of scope until handling is reviewed: tax identifiers and financial statements, bank and payroll records, identity documents. Financial records and tax identifiers are regulated in most jurisdictions; the portal flows here model authorization only and claim no compliance.

Technical basis verified on Django: a workspace-scoped table, an explicit state machine (draft to review to published) that rejects invalid transitions, and a cross-workspace read that returns nothing (transitions=true isolation=true).

Representative Queries

Workflow Steps

  1. Model the accounting firms domain
    Create the tables client_entities, engagements, document_requests, deliverables, state_transitions. The businesses and individuals served lives in client_entities; keep the sensitive classes (tax identifiers and financial statements, bank and payroll records, identity documents) out of this schema.
  2. Workflow step 1
    Model engagements and workstreams with explicit status transitions.
  3. Workflow step 2
    Scope every query by client entity.
  4. Workflow step 3
    Attach deliverables as private objects linked to workstreams.
  5. Workflow step 4
    Deploy and verify transitions and cross-client isolation.
  6. Deploy
    Run the synchronous deploy once and read the result. Re-running with no change is a no-op.
    Command: ample deploy . --name <name> --public --start "python3 run.py" --env S3_ENDPOINT=... --env S3_REGION=... --env S3_BUCKET=... --env S3_ACCESS_KEY_ID=... --env S3_SECRET_ACCESS_KEY=...
  7. Verify
    Run the pattern self-test(s) from the example (/p/relational-records) and your own acceptance checks for the accounting firms workflow.
    Command: ample logs --kind build

Prerequisites

Limitations

Success Checks

Example

Cost Estimate

Evidence Summary

Formats