How aarondyl/datashield works
DataShield is a business-facing data-compliance platform with a developer workflow: users maintain company/product profiles, assess compliance, inspect regulatory impact and evidence, then work through remediation. The React app calls a FastAPI backend; deterministic assessment and policy tools coexist with LangGraph impact analysis and RAG-based regulation retrieval. Regulations and operational records persist through SQLAlchemy, using PostgreSQL/pgvector or SQLite with a local vector index. The graph reflects documented capabilities and indexed references; unsampled agent internals are not assumed to have specific call relationships.
Main entry points: main.py FastAPI application · App.tsx React application · session.py SQL database / pgvector · compliance.py Compliance API
Components 25
Web application
- React application
frontend/src/App.tsx - Company and product profiles
frontend/src/pages/ProductsPage.tsx - Self-assessment
frontend/src/pages/SelfAssessmentPage.tsx - Impact analysis reports
frontend/src/pages/AnalyzePage.tsx - Regulation library
frontend/src/pages/RegulationsPage.tsx - Privacy policy tools
frontend/src/pages/PrivacyToolsPage.tsx - Developer readiness tools
frontend/src/pages/DeveloperIssuesPage.tsx - Shared UI components
frontend/src/components
API workflows
- FastAPI application
backend/app/main.py - Company and product APIs
backend/app/api/companies.py - Compliance API
backend/app/api/compliance.py - Impact analysis API
backend/app/api/analysis.py - Regulation API
backend/app/api/regulations.py - Developer tools API
backend/app/api/developer.py
Compliance intelligence
- Assessment and policy logic
backend/app/compliance/rules.py - Questionnaire, reports, roadmap
backend/app/compliance - Impact agent workflow
backend/app/agents/graph.py - Agent state
backend/app/agents/state.py
Regulation knowledge
- Regulation ingestion
backend/app/rag/ingestion.py - Vector retrieval
backend/app/rag/retrieval.py - Preloaded regulation content
backend/app/compliance/regulations_data.py
Persistence and models
- SQL database / pgvector
backend/app/db/session.py - Domain records
backend/app/models - Configured LLM provider
backend/app/core/llm.py
Other components
- Business / developer user
Connections 33
- Business / developer user → React application: uses
README.md - React application → Company and product profiles: routes to
frontend/src/App.tsx - React application → Self-assessment: routes to
frontend/src/App.tsx - React application → Impact analysis reports: routes to
frontend/src/App.tsx - React application → Regulation library: routes to
frontend/src/App.tsx - React application → Privacy policy tools: routes to
frontend/src/App.tsx - React application → Developer readiness tools: routes to
frontend/src/App.tsx - Company and product profiles → Shared UI components: renders
frontend/src/pages/ProductsPage.tsx - React application → FastAPI application: calls API
README.md - FastAPI application → Company and product APIs: registers
backend/app/main.py - FastAPI application → Compliance API: registers
backend/app/main.py - FastAPI application → Impact analysis API: registers
backend/app/main.py - FastAPI application → Regulation API: registers
backend/app/main.py - FastAPI application → Developer tools API: registers
backend/app/main.py - Compliance API → Assessment and policy logic: evaluates
backend/app/api/compliance.py - Compliance API → Questionnaire, reports, roadmap: uses
backend/app/api/compliance.py - Impact analysis API → Impact agent workflow: invokes
backend/app/api/analysis.py - Impact agent workflow → Agent state: uses state
- Impact agent workflow → Vector retrieval: retrieves evidence
- Impact agent workflow → Configured LLM provider: uses model
- Regulation API → Regulation ingestion: imports ingestion
- Regulation ingestion → Vector retrieval: indexes chunks
backend/app/rag/ingestion.py - Regulation ingestion → SQL database / pgvector: writes regulation data
backend/app/rag/ingestion.py - Vector retrieval → SQL database / pgvector: queries articles
backend/app/rag/retrieval.py - Assessment and policy logic → Preloaded regulation content: reads rules data
backend/app/compliance/rules.py - FastAPI application → SQL database / pgvector: initializes
backend/app/main.py - FastAPI application → Vector retrieval: rebuilds local index
backend/app/main.py - FastAPI application → Domain records: seeds records
backend/app/main.py - Company and product APIs → SQL database / pgvector: uses sessions
backend/app/api/companies.py - Compliance API → SQL database / pgvector: uses sessions
backend/app/api/compliance.py - Impact analysis API → SQL database / pgvector: uses sessions
backend/app/api/analysis.py - Developer tools API → SQL database / pgvector: uses sessions
backend/app/api/developer.py - SQL database / pgvector → Domain records: maps records
backend/app/db/session.py